User management system for Sheetbase app.

• Installation
• Options
• Lib
  • Lib properties
  • Lib methods
    • registerRoutes(routeEnabling?, middlewares?)
    • useUserMiddleware()
    • userIdTokenMiddleware()
• Routing
  • Errors
  • Routes
    • Routes overview
    • Routes detail
      • GET /auth/action
      • POST /auth/action
      • GET /auth/oauth
      • GET /auth/oob
      • POST /auth/oob
      • PUT /auth/oob
      • GET /auth/public
      • DELETE /auth
      • POST /auth
      • PUT /auth
      • GET /auth/token
      • GET /auth/user
      • PATCH /auth/user
• Detail API reference

• Install: npm install --save @sheetbase/auth

• Usage:

// 1. import module
import { AuthModule } from "@sheetbase/auth";

// 2. create an instance
export class App {
  // the object
  authModule: AuthModule;

  // initiate the instance
  constructor() {
    this.authModule = new AuthModule(/* options */);
  }
}

The Lib class.

Expose the module routes

Parameters

Returns

RouterService<>

The useUserMiddleware call signature.

Returns

RoutingHandler

The userIdTokenMiddleware call signature.

Returns

RoutingHandler

AuthModule provides REST API endpoints allowing clients to access server resources. Theses enpoints are not exposed by default, to expose the endpoints:

AuthModule.registerRoutes(routeEnabling?);

AuthModule returns these routing errors, you may use the error code to customize the message:

• auth/invalid-email: Invalid email.
• auth/invalid-input: Invalid input.
• auth/invalid-password: Invalid password.
• auth/invalid-token: Invalid token.
• auth/user-exists: User already exists.
• auth/user-not-exists: No user.

DISABLED Default oob ui

Request query

Response

string

DISABLED Handle for oob action

Request body

Response

object

DISABLED Get oauth user profile

Request query

Response

object

DISABLED Check an oob code

Request query

Response

object

DISABLED Handle oob actions

Request body

Response

void

DISABLED Send oob emails

Request body

Response

void

DISABLED Get user public profiles

Request query

Response

UserProfile | object

DISABLED Logout or delete account

Request body

Middleware data

Response

void

DISABLED Log a user in

Request body

Response

Record<string, unknown>

DISABLED Create new account

Request body

Response

object

DISABLED exchange the refresh token for a new id token

Request query

Response

object

DISABLED Get auth user profile

Middleware data

Response

UserInfo

DISABLED Update auth user data

Request body

Middleware data

Response

UserInfo

@sheetbase/auth is released under the MIT license.