Node Library Reference

const propelAuth = require("@propelauth/node");
const {
  validateAccessTokenAndGetUser,
  validateAccessTokenAndGetUserWithOrgInfo,
  validateAccessTokenAndGetUserWithOrgInfoWithMinimumRole,
  validateAccessTokenAndGetUserWithOrgInfoWithExactRole,
  validateAccessTokenAndGetUserWithOrgInfoWithPermission,
  validateAccessTokenAndGetUserWithOrgInfoWithAllPermissions,
  fetchUserMetadataByUserId,
  // ...
} = propelAuth.initBaseAuth({
  authUrl: "https://auth.yourdomain.com", // The base URL where your authentication pages are hosted. You can find this under the Backend Integration section for your project at https://app.propelauth.com.
  apiKey: "YOUR_API_KEY", // You can manage your api keys under the Backend Integration section for your project.
});

// propelauth.js
const propelAuth = require("@propelauth/node");
module.exports = propelAuth.initBaseAuth({
  authUrl: "https://auth.yourdomain.com",
  apiKey: "YOUR_API_KEY",
});

const { validateAccessTokenAndGetUser } = require("./propelauth");

const authorizationHeader = // Get the Authorization header from an HTTP request
try {
    const user = await validateAccessTokenAndGetUser(authorizationHeader)
    console.log(`Got request from user ${user.userId}`);
} catch (err) {
    // You can return a 401, or continue the request knowing it wasn't sent from a logged-in user
    console.log(`Unauthorized request ${err}`);
}

{
    user: //...
    orgMemberInfo: //...
}

{
    userId:            "e9d3520f-836e-403c-82c2-09843517e1ce",
    email:             "user@example.com",
    emailConfirmed:    true,
    hasPassword:       true,

    username:          "example",
    firstName:         "first",
    lastName:          "last",
    pictureUrl:        "https://...",

    // True if the user's account is locked for security purposes.
    locked:            false,
    enabled:           true,
    mfaEnabled:        false,

    createdAt:         1645131680,
    lastActiveAt:      1650654711,

    // Only returned if includeOrgs = true
    orgIdToOrgInfo: {
        "2ef0e1fc-234f-4dc0-a50c-35adb1bbb7e4" : {
            orgId: "2ef0e1fc-234f-4dc0-a50c-35adb1bbb7e4",
            orgName: "ExampleOrganization",
            userAssignedRole: "Owner",
        }
    },

    // Only returned if user was migrated from an external system
    legacyUserId:    "507f191e810c19729de860ea"
}

function fetchBatchUserMetadataByUserIds(userIds: string[], includeOrgs?: boolean): Promise<{ [userId: string]: UserMetadata }>

{
    "e9d3520f-836e-403c-82c2-09843517e1ce": {
        userId:            "e9d3520f-836e-403c-82c2-09843517e1ce",
        email:             "user@example.com",
        emailConfirmed:    true,
        hasPassword:       true,

        username:          "example",
        firstName:         "first",
        lastName:          "last",
        pictureUrl:        "https://...",

        // True if the user's account is locked for security purposes.
        locked:            false,
        enabled:           true,
        mfaEnabled:        false,

        createdAt:         1645131680,
        lastActiveAt:      1650654711,

        // Only returned if includeOrgs = true
        orgIdToOrgInfo: {
            "2ef0e1fc-234f-4dc0-a50c-35adb1bbb7e4" : {
                orgId: "2ef0e1fc-234f-4dc0-a50c-35adb1bbb7e4",
                orgName: "ExampleOrganization",
                userAssignedRole: "Owner",
            }
        },

        // Only returned if user was migrated from an external system
        legacyUserId:    "507f191e810c19729de860ea"
    },
    // other user_ids
}

function fetchBatchUserMetadataByEmails(emails: string[], includeOrgs?: boolean): Promise<{ [email: string]: UserMetadata }>

function fetchBatchUserMetadataByUsernames(usernames: string[], includeOrgs?: boolean): Promise<{ [username: string]: UserMetadata }>

function fetchUsersByQuery(usersQuery: UsersQuery): Promise<UsersPagedResponse>

// Example
const usersResponse = await auth.fetchUsersByQuery({emailOrUsername: "@example.com", orderBy: "LAST_ACTIVE_AT_DESC"})
for (const user of userResponse.users) {
    console.log("Found user " + user)
}

{
    "totalUsers": 103,
    "currentPage": 0,
    "pageSize": 10,
    "hasMoreResults": true,
    "users": [{
        // See (1) for example users
    }, {
        // There will be 10 users in this response
    }]
}

function fetchUsersInOrg(usersInOrgQuery: UsersInOrgQuery): Promise<UsersPagedResponse>

// Example
const usersResponse = await auth.fetchUsersInOrg({
    orgId: req.params.orgId,
    pageNumber: req.params.pageNumber,
})

{
    "totalUsers": 43,
    "currentPage": 0,
    "pageSize": 10,
    "hasMoreResults": true,
    "users": [{
        // See (1) for example users
    }, {
        // There will be 10 users in this response, all in the specified organization
    }]
}

function createUser(createUserRequest: CreateUserRequest): Promise<User>

{
    "userId": "b5f667fb-e51a-49c6-a396-711e62948689"
}

function migrateUserFromExternalSource(migrateUserFromExternalSourceRequest: MigrateUserFromExternalSourceRequest): Promise<User>

{
    "userId": "b5f667fb-e51a-49c6-a396-711e62948689"
}

function createMagicLink(createUserRequest: CreateMagicLinkRequest): Promise<MagicLink>

{
    "url": "https://auth.yourdomain.com/..."
}

// Returns true if it was successful, false if the user was not found
function updateUserEmailWrapper(userId: string, updateUserEmailRequest: UpdateUserEmailRequest): Promise<boolean>

// Returns true if it was successful, false if the user was not found
function updateUserMetadata(userId: string, updateUserMetadataRequest: UpdateUserMetadataRequest): Promise<boolean>

function deleteUser(userId: string): Promise<boolean>

function disableUser(userId: string): Promise<boolean>

function enableUser(userId: string): Promise<boolean>

function fetchOrg(orgId: string): Promise<Org | null>

{
    "orgId": "d488996d-8ccc-4101-b5f2-131f5f09ddb6"
    "name": "OneOfYourCustomers"
}

function fetchOrgsByQuery(orgQuery: OrgQuery): Promise<OrgQueryResponse>

{
    "totalOrgs": 21,
    "currentPage": 0,
    "pageSize": 10,
    "hasMoreResults": true,
    "orgs": [{
        "orgId": "d488996d-8ccc-4101-b5f2-131f5f09ddb6",
        "name": "OneOfYourCustomers"
    }, {
        // There will be 10 orgs in this response
    }]
}

function createOrg(createOrgRequest: CreateOrgRequest): Promise<Org>

{
    "orgId": "d488996d-8ccc-4101-b5f2-131f5f09ddb6"
}

function addUserToOrg(addUserToOrgRequest: AddUserToOrgRequest): Promise<boolean>

function allowOrgToSetupSamlConnection(orgId: string): Promise<boolean>

function disallowOrgToSetupSamlConnection(orgId: string): Promise<boolean>