Registry / aws / amazon-cognito-auth-js-promises

amazon-cognito-auth-js-promises

library1.1.5jsnpmunverified

Wrapper around amazon-cognito-auth-js providing Promise-based APIs for Cognito User Pools authentication in browser apps. Version 1.1.5 (last release Feb 2020) is stable but unmaintained. It supports sign-up, sign-in, sign-out, and token management via OAuth2 flows. Compared to the newer @aws-amplify/auth or amazon-cognito-identity-js, this package offers a lighter, promise-based interface but lacks ongoing updates and TypeScript types. Requires a User Pool App Client ID, App Web Domain, and scope array configured in AWS Console.

aws auth-security

npm install amazon-cognito-auth-js-promises

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AMAZON-COGNITO-AUT

amazon-cognito-auth-js-promises

awsjavascriptv1.1.5

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CognitoAuth

✓ import { CognitoAuth } from 'amazon-cognito-auth-js-promises'

✗ const CognitoAuth = require('amazon-cognito-auth-js-promises').CognitoAuth

ES module import is preferred; CommonJS require works but must access .CognitoAuth.

CognitoAuth

✓ const { CognitoAuth } = require('amazon-cognito-auth-js-promises')

✗ const CognitoAuth = require('amazon-cognito-auth-js-promises')

Direct require returns the module object, not CognitoAuth class.

default

✓ import AmazonCognitoIdentity from 'amazon-cognito-auth-js-promises'

✗ import { default } from 'amazon-cognito-auth-js-promises'

Default import is an object containing all exports; not recommended.

Creates a CognitoAuth instance with environment variables and initiates a login session using promises.

import { CognitoAuth } from 'amazon-cognito-auth-js-promises'; const auth = new CognitoAuth({ ClientId: process.env.COGNITO_CLIENT_ID ?? '', AppWebDomain: process.env.COGNITO_DOMAIN ?? '', TokenScopesArray: ['openid', 'email', 'profile'], RedirectUriSignIn: process.env.COGNITO_REDIRECT_SIGN_IN ?? '', RedirectUriSignOut: process.env.COGNITO_REDIRECT_SIGN_OUT ?? '', IdentityProvider: '', UserPoolId: process.env.COGNITO_USER_POOL_ID ?? '', AdvancedSecurityDataCollectionFlag: true, }); auth.getSession() .then(session => console.log(session)) .catch(err => console.error(err));

Debug

Known issues

deprecatedPackage is not actively maintained; no updates since February 2020. Consider migrating to @aws-amplify/auth or amazon-cognito-identity-js.

fix

Replace with @aws-amplify/auth: npm install @aws-amplify/auth

affects: >=0.0.0

gotchaToken scopes must include 'openid' for ID token to be returned. Missing 'openid' may cause silent failures.

fix

Add 'openid' to TokenScopesArray.

affects: >=0.0.0

breakingIn v1.1.0, the promise methods were renamed (e.g., getSession vs getSessionAsync) – check the changelog if upgrading from earlier versions.

fix

Use the promise-based method names as documented; avoid the old 'Async' suffix.

affects: >=1.1.0

Errors

Common errors & fixes

Cannot find module 'amazon-cognito-auth-js'

Missing peer dependency amazon-cognito-auth-js.

fix

npm install amazon-cognito-auth-js

TypeError: auth.getSession is not a function

Using CommonJS require without accessing .CognitoAuth property.

fix

const { CognitoAuth } = require('amazon-cognito-auth-js-promises'); then const auth = new CognitoAuth(...);

Upgrade

Version history

1.1.5latest on npm

Audit

Dependencies

amazon-cognito-auth-jsrequiredThis package wraps the Cognito Auth SDK; it is a direct dependency.

Agent activity

65 hits · last 30 days

node

OpenAI (training)

Perplexity

Resources

githubhttps://github.com/chamathsilva/amazon-cognito-auth-js ↗

packagehttps://www.npmjs.com/package/amazon-cognito-auth-js-promises ↗

homepagehttp://aws.amazon.com/cognito ↗