@awsless/cognito

Super lightweight AWS Cognito client for both the browser & nodejs. Uses the native web crypto & BigInt features in the browser & we designed the API to be tree shakable to keep the package as small as possible.

GZip Size: ~12kB

Installation

npm install --save @awsless/cognito

# using yarn:
yarn add @awsless/cognito

# using pnpm:
pnpm install @awsless/cognito

Stores

Depending on your use case you might want to use one of the following stores.

• MemoryStore - Mostly used for debugging and when you don't want to persist the login token.

• LocalStore - Used to store the login token on the client only.

• CookieStore - The CookieStore is useful in scenarios like SSR, when you need access to the login token on the client as well as on the server.

Examples

Setup

import { Client, LocalStore } from '@awsless/cognito';

const client = new Client({
  clientId: 'CLIENT_ID',
  userPoolId: 'USER_POOL_ID',
  store: new LocalStore()
});

Sign Up

import { signUp, confirmSignUp } from '@awsless/cognito';

await signUp(client, {
  email: 'EMAIL',
  username: 'USER',
  password: 'PASS',
});

// Let the user fill in his confirmation code.
await confirmSignUp(client, {
  username: 'USER',
  code: 'SIGN_UP_CONFIRMATION_CODE'
})

Sign In

const session = await signIn(client, {
  username: 'USER',
  password: 'PASS',
});

// Log logged in user.
console.log(session.user);

Sign Out

await signOut(client);

Get Active Login Session

const session = await getSession(client);

// Log access token
console.log(session.accessToken.toString());

// Log ID token
console.log(session.idToken.toString());

Change Password

await changePassword(client, {
  previousPassword: 'PREV_PASS',
  proposedPassword: 'NEW_PASS',
});

Custom Cognito Call

const response = await client.call('API_NAME', {
  ...
});

License

MIT