@logto/js 4.1.1 → 4.1.3

package/lib/core/sign-in.cjs

@@ -11,7 +11,7 @@ const buildPrompt = (prompt) => {
     }
     return prompt ?? index.Prompt.Consent;
 };
-const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes: scopes$1, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, }) => {
+const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes: scopes$1, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, includeReservedScopes = true, }) => {
     const urlSearchParameters = new URLSearchParams({
         [index.QueryKey.ClientId]: clientId,
         [index.QueryKey.RedirectUri]: redirectUri,
@@ -20,9 +20,11 @@ const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeC
         [index.QueryKey.State]: state,
         [index.QueryKey.ResponseType]: responseType,
         [index.QueryKey.Prompt]: buildPrompt(prompt),
-        [index.QueryKey.Scope]: scopes.withDefaultScopes(scopes$1),
-        ...extraParams,
     });
+    const computedScopes = includeReservedScopes ? scopes.withReservedScopes(scopes$1) : scopes$1?.join(' ');
+    if (computedScopes) {
+        urlSearchParameters.append(index.QueryKey.Scope, computedScopes);
+    }
     if (loginHint) {
         urlSearchParameters.append(index.QueryKey.LoginHint, loginHint);
     }
@@ -39,6 +41,11 @@ const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeC
     else if (interactionMode) {
         urlSearchParameters.append(index.QueryKey.InteractionMode, interactionMode);
     }
+    if (extraParams) {
+        for (const [key, value] of Object.entries(extraParams)) {
+            urlSearchParameters.append(key, value);
+        }
+    }
     return `${authorizationEndpoint}?${urlSearchParameters.toString()}`;
 };
 

package/lib/core/sign-in.d.ts

@@ -47,5 +47,11 @@ export type SignInUriParameters = {
      * by the authorization server.
      */
     extraParams?: Record<string, string>;
+    /**
+     * Whether to include reserved scopes (`openid`, `offline_access` and `profile`) in the scopes.
+     *
+     * @default true
+     */
+    includeReservedScopes?: boolean;
 };
-export declare const generateSignInUri: ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, }: SignInUriParameters) => string;
+export declare const generateSignInUri: ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, includeReservedScopes, }: SignInUriParameters) => string;

package/lib/core/sign-in.js

@@ -1,5 +1,5 @@
 import { QueryKey, Prompt } from '../consts/index.js';
-import { withDefaultScopes } from '../utils/scopes.js';
+import { withReservedScopes } from '../utils/scopes.js';
 
 const codeChallengeMethod = 'S256';
 const responseType = 'code';
@@ -9,7 +9,7 @@ const buildPrompt = (prompt) => {
     }
     return prompt ?? Prompt.Consent;
 };
-const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, }) => {
+const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, includeReservedScopes = true, }) => {
     const urlSearchParameters = new URLSearchParams({
         [QueryKey.ClientId]: clientId,
         [QueryKey.RedirectUri]: redirectUri,
@@ -18,9 +18,11 @@ const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeC
         [QueryKey.State]: state,
         [QueryKey.ResponseType]: responseType,
         [QueryKey.Prompt]: buildPrompt(prompt),
-        [QueryKey.Scope]: withDefaultScopes(scopes),
-        ...extraParams,
     });
+    const computedScopes = includeReservedScopes ? withReservedScopes(scopes) : scopes?.join(' ');
+    if (computedScopes) {
+        urlSearchParameters.append(QueryKey.Scope, computedScopes);
+    }
     if (loginHint) {
         urlSearchParameters.append(QueryKey.LoginHint, loginHint);
     }
@@ -37,6 +39,11 @@ const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeC
     else if (interactionMode) {
         urlSearchParameters.append(QueryKey.InteractionMode, interactionMode);
     }
+    if (extraParams) {
+        for (const [key, value] of Object.entries(extraParams)) {
+            urlSearchParameters.append(key, value);
+        }
+    }
     return `${authorizationEndpoint}?${urlSearchParameters.toString()}`;
 };
 

package/lib/index.cjs

@@ -32,9 +32,11 @@ exports.LogtoError = errors.LogtoError;
 exports.LogtoRequestError = errors.LogtoRequestError;
 exports.OidcError = errors.OidcError;
 exports.isLogtoRequestError = errors.isLogtoRequestError;
+exports.isLogtoRequestErrorJson = errors.isLogtoRequestErrorJson;
 exports.decodeIdToken = idToken.decodeIdToken;
 exports.decodeAccessToken = accessToken.decodeAccessToken;
 exports.withDefaultScopes = scopes.withDefaultScopes;
+exports.withReservedScopes = scopes.withReservedScopes;
 exports.isArbitraryObject = arbitraryObject.isArbitraryObject;
 exports.buildAngularAuthConfig = angular.buildAngularAuthConfig;
 exports.ContentType = index.ContentType;

package/lib/index.js

@@ -5,10 +5,10 @@ export { generateSignInUri } from './core/sign-in.js';
 export { generateSignOutUri } from './core/sign-out.js';
 export { fetchUserInfo } from './core/user-info.js';
 export { parseUriParameters, verifyAndParseCodeFromCallbackUri } from './utils/callback-uri.js';
-export { LogtoError, LogtoRequestError, OidcError, isLogtoRequestError } from './utils/errors.js';
+export { LogtoError, LogtoRequestError, OidcError, isLogtoRequestError, isLogtoRequestErrorJson } from './utils/errors.js';
 export { decodeIdToken } from './utils/id-token.js';
 export { decodeAccessToken } from './utils/access-token.js';
-export { withDefaultScopes } from './utils/scopes.js';
+export { withDefaultScopes, withReservedScopes } from './utils/scopes.js';
 export { isArbitraryObject } from './utils/arbitrary-object.js';
 export { buildAngularAuthConfig } from './utils/angular.js';
 export { ContentType, Prompt, QueryKey, TokenGrantType } from './consts/index.js';

package/lib/utils/angular.cjs

@@ -28,8 +28,8 @@ var scopes = require('./scopes.cjs');
  * about how to use the library.
  */
 const buildAngularAuthConfig = (logtoConfig) => {
-    const { endpoint, appId: clientId, scopes: scopes$1, resource, redirectUri: redirectUrl, postLogoutRedirectUri, prompt = index.Prompt.Consent, } = logtoConfig;
-    const scope = scopes.withDefaultScopes(scopes$1);
+    const { endpoint, appId: clientId, scopes: scopes$1, resource, redirectUri: redirectUrl, postLogoutRedirectUri, prompt = index.Prompt.Consent, includeReservedScopes = true, } = logtoConfig;
+    const scope = includeReservedScopes ? scopes.withReservedScopes(scopes$1) : scopes$1?.join(' ');
     const customParameters = resource ? { resource } : undefined;
     return {
         authority: new URL('/oidc', endpoint).href,

package/lib/utils/angular.d.ts

@@ -42,6 +42,12 @@ export type LogtoAngularConfig = {
      * @default Prompt.Consent
      */
     prompt?: Prompt | Prompt[];
+    /**
+     * Whether to include reserved scopes (`openid`, `offline_access` and `profile`) in the scopes.
+     *
+     * @default true
+     */
+    includeReservedScopes?: boolean;
 };
 /**
  * A helper function to build the OpenID Connect configuration for `angular-auth-oidc-client`

package/lib/utils/angular.js

@@ -1,5 +1,5 @@
 import { Prompt } from '../consts/index.js';
-import { withDefaultScopes } from './scopes.js';
+import { withReservedScopes } from './scopes.js';
 
 /**
  * A helper function to build the OpenID Connect configuration for `angular-auth-oidc-client`
@@ -26,8 +26,8 @@ import { withDefaultScopes } from './scopes.js';
  * about how to use the library.
  */
 const buildAngularAuthConfig = (logtoConfig) => {
-    const { endpoint, appId: clientId, scopes, resource, redirectUri: redirectUrl, postLogoutRedirectUri, prompt = Prompt.Consent, } = logtoConfig;
-    const scope = withDefaultScopes(scopes);
+    const { endpoint, appId: clientId, scopes, resource, redirectUri: redirectUrl, postLogoutRedirectUri, prompt = Prompt.Consent, includeReservedScopes = true, } = logtoConfig;
+    const scope = includeReservedScopes ? withReservedScopes(scopes) : scopes?.join(' ');
     const customParameters = resource ? { resource } : undefined;
     return {
         authority: new URL('/oidc', endpoint).href,

package/lib/utils/errors.cjs

@@ -18,24 +18,36 @@ class LogtoError extends Error {
         super(logtoErrorCodes[code]);
         this.code = code;
         this.data = data;
+        this.name = 'LogtoError';
     }
 }
 const isLogtoRequestError = (data) => {
+    if (!arbitraryObject.isArbitraryObject(data)) {
+        return false;
+    }
+    return data instanceof Error && data.name === 'LogtoRequestError';
+};
+const isLogtoRequestErrorJson = (data) => {
     if (!arbitraryObject.isArbitraryObject(data)) {
         return false;
     }
     return typeof data.code === 'string' && typeof data.message === 'string';
 };
 class LogtoRequestError extends Error {
-    constructor(code, message) {
+    constructor(code, message, 
+    /** The original response object from the server. */
+    cause) {
         super(message);
         this.code = code;
+        this.cause = cause;
+        this.name = 'LogtoRequestError';
     }
 }
 class OidcError {
     constructor(error, errorDescription) {
         this.error = error;
         this.errorDescription = errorDescription;
+        this.name = 'OidcError';
     }
 }
 
@@ -43,3 +55,4 @@ exports.LogtoError = LogtoError;
 exports.LogtoRequestError = LogtoRequestError;
 exports.OidcError = OidcError;
 exports.isLogtoRequestError = isLogtoRequestError;
+exports.isLogtoRequestErrorJson = isLogtoRequestErrorJson;

package/lib/utils/errors.d.ts

@@ -12,20 +12,28 @@ declare const logtoErrorCodes: Readonly<{
 export type LogtoErrorCode = keyof typeof logtoErrorCodes;
 export declare class LogtoError extends Error {
     code: LogtoErrorCode;
-    data: unknown;
+    data?: unknown;
+    name: string;
     constructor(code: LogtoErrorCode, data?: unknown);
 }
-export declare const isLogtoRequestError: (data: unknown) => data is {
+export declare const isLogtoRequestError: (data: unknown) => data is LogtoRequestError;
+export declare const isLogtoRequestErrorJson: (data: unknown) => data is {
     code: string;
     message: string;
 };
 export declare class LogtoRequestError extends Error {
     code: string;
-    constructor(code: string, message: string);
+    /** The original response object from the server. */
+    cause?: Response | undefined;
+    name: string;
+    constructor(code: string, message: string, 
+    /** The original response object from the server. */
+    cause?: Response | undefined);
 }
 export declare class OidcError {
     error: string;
     errorDescription?: string | undefined;
+    name: string;
     constructor(error: string, errorDescription?: string | undefined);
 }
 export {};

package/lib/utils/errors.js

@@ -16,25 +16,37 @@ class LogtoError extends Error {
         super(logtoErrorCodes[code]);
         this.code = code;
         this.data = data;
+        this.name = 'LogtoError';
     }
 }
 const isLogtoRequestError = (data) => {
+    if (!isArbitraryObject(data)) {
+        return false;
+    }
+    return data instanceof Error && data.name === 'LogtoRequestError';
+};
+const isLogtoRequestErrorJson = (data) => {
     if (!isArbitraryObject(data)) {
         return false;
     }
     return typeof data.code === 'string' && typeof data.message === 'string';
 };
 class LogtoRequestError extends Error {
-    constructor(code, message) {
+    constructor(code, message, 
+    /** The original response object from the server. */
+    cause) {
         super(message);
         this.code = code;
+        this.cause = cause;
+        this.name = 'LogtoRequestError';
     }
 }
 class OidcError {
     constructor(error, errorDescription) {
         this.error = error;
         this.errorDescription = errorDescription;
+        this.name = 'OidcError';
     }
 }
 
-export { LogtoError, LogtoRequestError, OidcError, isLogtoRequestError };
+export { LogtoError, LogtoRequestError, OidcError, isLogtoRequestError, isLogtoRequestErrorJson };

package/lib/utils/scopes.cjs

@@ -7,10 +7,17 @@ var openid = require('../consts/openid.cjs');
  * @param originalScopes
  * @return scopes should contain all default scopes (`openid`, `offline_access` and `profile`)
  */
-const withDefaultScopes = (originalScopes) => {
+const withReservedScopes = (originalScopes) => {
     const reservedScopes = Object.values(openid.ReservedScope);
     const uniqueScopes = new Set([...reservedScopes, openid.UserScope.Profile, ...(originalScopes ?? [])]);
     return Array.from(uniqueScopes).join(' ');
 };
+/**
+ * Alias of {@link withReservedScopes}.
+ *
+ * @deprecated Use {@link withReservedScopes} instead.
+ */
+const withDefaultScopes = withReservedScopes;
 
 exports.withDefaultScopes = withDefaultScopes;
+exports.withReservedScopes = withReservedScopes;

package/lib/utils/scopes.d.ts

@@ -2,4 +2,10 @@
  * @param originalScopes
  * @return scopes should contain all default scopes (`openid`, `offline_access` and `profile`)
  */
+export declare const withReservedScopes: (originalScopes?: string[]) => string;
+/**
+ * Alias of {@link withReservedScopes}.
+ *
+ * @deprecated Use {@link withReservedScopes} instead.
+ */
 export declare const withDefaultScopes: (originalScopes?: string[]) => string;

package/lib/utils/scopes.js

@@ -5,10 +5,16 @@ import { ReservedScope, UserScope } from '../consts/openid.js';
  * @param originalScopes
  * @return scopes should contain all default scopes (`openid`, `offline_access` and `profile`)
  */
-const withDefaultScopes = (originalScopes) => {
+const withReservedScopes = (originalScopes) => {
     const reservedScopes = Object.values(ReservedScope);
     const uniqueScopes = new Set([...reservedScopes, UserScope.Profile, ...(originalScopes ?? [])]);
     return Array.from(uniqueScopes).join(' ');
 };
+/**
+ * Alias of {@link withReservedScopes}.
+ *
+ * @deprecated Use {@link withReservedScopes} instead.
+ */
+const withDefaultScopes = withReservedScopes;
 
-export { withDefaultScopes };
+export { withDefaultScopes, withReservedScopes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logto/js",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "type": "module",
   "main": "./lib/index.cjs",
   "module": "./lib/index.js",
@@ -24,26 +24,19 @@
     "camelcase-keys": "^7.0.1"
   },
   "devDependencies": {
-    "@peculiar/webcrypto": "^1.4.5",
-    "@silverhand/eslint-config": "^5.0.0",
-    "@silverhand/ts-config": "^5.0.0",
-    "@swc/core": "^1.3.50",
-    "@swc/jest": "^0.2.24",
-    "@types/jest": "^29.5.1",
+    "@silverhand/eslint-config": "^6.0.1",
+    "@silverhand/ts-config": "^6.0.0",
     "@types/node": "^20.11.19",
+    "@vitest/coverage-v8": "^1.4.0",
     "angular-auth-oidc-client": "^17.0.0",
-    "eslint": "^8.44.0",
-    "jest": "^29.5.0",
-    "jest-environment-jsdom": "^29.5.0",
-    "jest-matcher-specific-error": "^1.0.0",
+    "eslint": "^8.57.0",
+    "happy-dom": "^14.0.0",
     "jose": "^5.2.2",
     "lint-staged": "^15.0.0",
-    "nock": "^13.3.0",
     "prettier": "^3.0.0",
     "rollup": "^4.0.0",
-    "text-encoder": "^0.0.4",
-    "type-fest": "^4.0.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^1.4.0"
   },
   "eslintConfig": {
     "extends": "@silverhand"
@@ -58,7 +51,7 @@
     "check": "tsc --noEmit",
     "build": "rm -rf lib/ && tsc -p tsconfig.build.json --noEmit && rollup -c",
     "lint": "eslint --ext .ts src",
-    "test": "jest",
-    "test:coverage": "jest --silent --env=jsdom && jest --silent"
+    "test": "vitest",
+    "test:coverage": "vitest --silent --no-watch --environment=happy-dom && vitest --silent --coverage"
   }
 }