Warrant Node.js Library

Use Warrant in server-side Node.js projects.

Installation

Use npm to install the Warrant module:

npm install @warrantdev/warrant-node

Usage

Import the Warrant client and pass your API key to the constructor to get started:

constWarrant=require("@warrantdev/warrant-node");constwarrantClient=newWarrant.Forge4FlowClient({apiKey: "api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E=",});

Or using ES modules:

import{Forge4FlowClient}from"@warrantdev/warrant-node";constwarrantClient=newForge4FlowClient({apiKey: "api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E=",});

---

This method creates a user in Warrant with the provided userId. Provide an optional email to make it easier to identify users in the Warrant dashboard.

constWarrant=require("@warrantdev/warrant-node");constwarrantClient=newWarrant.Forge4FlowClient({apiKey: "api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E=",});// Creates a user with user.id as the userIdwarrantClient.User.create({userId: user.id,email: user.email}).then((newUser)=>console.log(newUser)).catch((error)=>console.log(error));

Or using ES modules and async/await:

import{Forge4FlowClient}from"@warrantdev/warrant-node";constwarrantClient=newForge4FlowClient({apiKey: "api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E=",});// Creates a user with user.id as the userId and// assigns the new user the "store_owner" roleconstnewUser=awaitwarrantClient.User.create({userId: user.id,email: user.email,});

Configuring the API Endpoint

---

The API endpoint the SDK makes requests to is configurable via the endpoint attribute when initializing the client:

import{Forge4FlowClient}from"@warrantdev/warrant-node";// Set api and authorize endpoints to http://localhost:8000constwarrantClient=newForge4FlowClient({apiKey: "api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E=",endpoint: "http://localhost:8000",});

Authorization

All access checks are performed based on an object, relation and subject. You can pass your own defined objects to the check methods by implementing the WarrantObject interface.

interface WarrantObject {
getObjectType(): string;
getObjectId(): string;
}

check(Check)

This method returns a Promise that resolves with true if the subject has the specified relation to the object and false otherwise.

constWarrant=require("@warrantdev/warrant-node");constwarrantClient=newWarrant.Forge4FlowClient({apiKey: "api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E=",});// Store class implements WarrantObjectclassStore{privateid: number;publicgetObjectType(): string{return"store";}publicgetObjectId(): string{returnthis.id.toString();}}//// Example Scenario:// An e-commerce website where Store Owners can edit store info//constmyStore=newStore('my-store');warrantClient.Authorization.check({object: myStore,relation: "edit",subject: {objectType: "user",objectId: user.id,},}).then((isAuthorized)=>{if(isAuthorized){// Carry out logic to allow user to edit a Store}}).catch((error)=>console.log(error));

Or using ES modules and async/await:

import{Forge4FlowClient}from"@warrantdev/warrant-node";constwarrantClient=newForge4FlowClient({apiKey: "api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E=",});//// Example Scenario:// An e-commerce website where Store Owners can edit store info//constmyStore=newStore("my-store");if(awaitwarrantClient.Authorization.check({object: myStore,relation: "edit",subject: {objectType: "user",objectId: user.id,},})){// Carry out logic to allow user to edit a Store}

We’ve used a random API key in these code examples. Replace it with your actual publishable API keys to test this code through your own Warrant account.

For more information on how to use the Warrant API and usage examples for all methods, please refer to the Warrant API reference.

Note that we may release new minor and patch versions of @warrantdev/warrant-node with small but backwards-incompatible fixes to the type declarations. These changes will not affect Warrant itself.

TypeScript support

This package includes TypeScript declarations for Warrant.

Warrant Documentation

• Warrant Docs