@descope/node-sdk 1.0.4-alpha.5 → 1.0.4-alpha.7

package/dist/index.d.ts

@@ -1,18 +1,43 @@
 import * as _descope_core_js_sdk from '@descope/core-js-sdk';
-import _descope_core_js_sdk__default from '@descope/core-js-sdk';
+import _descope_core_js_sdk__default, { RequestConfig, SdkResponse, ExchangeAccessKeyResponse } from '@descope/core-js-sdk';
 export { DeliveryMethod, OAuthProvider } from '@descope/core-js-sdk';
 import { JWTHeaderParameters, KeyLike } from 'jose';
 
+/** Parsed JWT token */
 interface Token {
     sub?: string;
     exp?: number;
     iss?: string;
+    [claim: string]: unknown;
 }
+/** All information regarding token including the raw JWT, parsed JWT and cookies */
 interface AuthenticationInfo {
-    token?: Token;
+    jwt: string;
+    token: Token;
     cookies?: string[];
 }
 
+/** Refresh JWT cookie name */
+declare const refreshTokenCookieName = "DSR";
+/** Session JWT cookie name */
+declare const sessionTokenCookieName = "DS";
+
+/** Descope SDK client with delivery methods enum.
+ *
+ * Please see full documentation at {@link https://docs.descope.com/guides Descope Docs}
+ * @example Usage
+ *
+ * ```js
+ * import descopeSdk from '@descope/node-sdk';
+ *
+ * const myProjectId = 'xxx';
+ * const sdk = descopeSdk({ projectId: myProjectId });
+ *
+ * const userIdentifier = 'identifier';
+ * sdk.otp.signIn.email(userIdentifier);
+ * const jwtResponse = sdk.otp.verify.email(userIdentifier, codeFromEmail);
+ * ```
+ */
 declare const sdkWithAttributes: ((args_0: {
     projectId: string;
     logger?: {
@@ -30,205 +55,284 @@ declare const sdkWithAttributes: ((args_0: {
         };
     };
     baseUrl?: string;
+    hooks?: {
+        beforeRequest?: (config: RequestConfig) => RequestConfig;
+        afterRequest?: (req: RequestConfig, res: globalThis.Response) => void;
+    };
+    cookiePolicy?: RequestCredentials;
 }) => {
+    /** Get the key that can validate the given JWT KID in the header. Can retrieve the public key from local cache or from Descope. */
     getKey(header: JWTHeaderParameters): Promise<KeyLike | Uint8Array>;
-    validateToken(token: string): Promise<AuthenticationInfo>;
-    validateSession(sessionToken: string, refreshToken: string): Promise<AuthenticationInfo | undefined>;
+    /**
+     * Validate the given JWT with the right key and make sure the issuer is correct
+     * @param jwt the JWT string to parse and validate
+     * @returns AuthenticationInfo with the parsed token and JWT. Will throw an error if validation fails.
+     */
+    validateJwt(jwt: string): Promise<AuthenticationInfo>;
+    /**
+     * Validate session based on at least one of session and refresh JWTs. You must provide at least one of them.
+     *
+     * @param sessionToken session JWT
+     * @param refreshToken refresh JWT
+     * @returns AuthenticationInfo promise or throws Error if there is an issue with JWTs
+     */
+    validateSession(sessionToken?: string, refreshToken?: string): Promise<AuthenticationInfo>;
+    /**
+     * Exchange API key (access key) for a session key
+     * @param accessKey access key to exchange for a session JWT
+     * @returns AuthneticationInfo with session JWT data
+     */
+    exchangeAccessKey(accessKey: string): Promise<AuthenticationInfo>;
+    /**
+     * Make sure that all given permissions exist on the parsed JWT top level claims
+     * @param authInfo JWT parsed info
+     * @param permissions list of permissions to make sure they exist on te JWT claims
+     * @returns true if all permissions exist, false otherwise
+     */
+    validatePermissions(authInfo: AuthenticationInfo, permissions: string[]): boolean;
+    /**
+     * Make sure that all given permissions exist on the parsed JWT tenant claims
+     * @param authInfo JWT parsed info
+     * @param permissions list of permissions to make sure they exist on te JWT claims
+     * @returns true if all permissions exist, false otherwise
+     */
+    validateTenantPermissions(authInfo: AuthenticationInfo, tenant: string, permissions: string[]): boolean;
+    /**
+     * Make sure that all given roles exist on the parsed JWT top level claims
+     * @param authInfo JWT parsed info
+     * @param roles list of roles to make sure they exist on te JWT claims
+     * @returns true if all roles exist, false otherwise
+     */
+    validateRoles(authInfo: AuthenticationInfo, roles: string[]): boolean;
+    /**
+     * Make sure that all given roles exist on the parsed JWT tenant claims
+     * @param authInfo JWT parsed info
+     * @param roles list of roles to make sure they exist on te JWT claims
+     * @returns true if all roles exist, false otherwise
+     */
+    validateTenantRoles(authInfo: AuthenticationInfo, tenant: string, roles: string[]): boolean;
+    accessKey: {
+        exchange: (accessKey: string) => Promise<SdkResponse<ExchangeAccessKeyResponse>>;
+    };
     otp: {
         verify: {
-            email: (identifier: string, code: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            sms: (identifier: string, code: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            whatsapp: (identifier: string, code: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            email: (identifier: string, code: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
+            sms: (identifier: string, code: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
+            whatsapp: (identifier: string, code: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
         };
         signIn: {
-            email: (identifier: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            sms: (identifier: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            whatsapp: (identifier: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            email: (identifier: string) => Promise<SdkResponse<never>>;
+            sms: (identifier: string) => Promise<SdkResponse<never>>;
+            whatsapp: (identifier: string) => Promise<SdkResponse<never>>;
         };
         signUp: {
             email: (identifier: string, user?: {
                 email?: string;
                 name?: string;
                 phone?: string;
-            }) => Promise<_descope_core_js_sdk.SdkResponse>;
+            }) => Promise<SdkResponse<never>>;
             sms: (identifier: string, user?: {
                 email?: string;
                 name?: string;
                 phone?: string;
-            }) => Promise<_descope_core_js_sdk.SdkResponse>;
+            }) => Promise<SdkResponse<never>>;
             whatsapp: (identifier: string, user?: {
                 email?: string;
                 name?: string;
                 phone?: string;
-            }) => Promise<_descope_core_js_sdk.SdkResponse>;
+            }) => Promise<SdkResponse<never>>;
         };
         signUpOrIn: {
-            email: (identifier: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            sms: (identifier: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            whatsapp: (identifier: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            email: (identifier: string) => Promise<SdkResponse<never>>;
+            sms: (identifier: string) => Promise<SdkResponse<never>>;
+            whatsapp: (identifier: string) => Promise<SdkResponse<never>>;
         };
         update: {
-            email: (identifier: string, email: string, token?: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            email: (identifier: string, email: string, token?: string) => Promise<SdkResponse<never>>;
             phone: {
-                email: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                sms: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                whatsapp: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+                email: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
+                sms: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
+                whatsapp: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
             };
         };
     };
     magicLink: {
-        verify: (token: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+        verify: (token: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
         signIn: {
-            email: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            sms: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            whatsapp: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            email: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+            sms: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+            whatsapp: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
         };
         signUp: {
             email: (identifier: string, uri: string, user?: {
                 email?: string;
                 name?: string;
                 phone?: string;
-            }) => Promise<_descope_core_js_sdk.SdkResponse>;
+            }) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
             sms: (identifier: string, uri: string, user?: {
                 email?: string;
                 name?: string;
                 phone?: string;
-            }) => Promise<_descope_core_js_sdk.SdkResponse>;
+            }) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
             whatsapp: (identifier: string, uri: string, user?: {
                 email?: string;
                 name?: string;
                 phone?: string;
-            }) => Promise<_descope_core_js_sdk.SdkResponse>;
+            }) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
         };
         signUpOrIn: {
-            email: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            sms: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            whatsapp: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            email: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+            sms: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+            whatsapp: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
         };
         update: {
-            email: (identifier: string, email: string, uri: string, token?: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            email: (identifier: string, email: string, uri: string, token?: string) => Promise<SdkResponse<never>>;
             phone: {
-                email: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                sms: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                whatsapp: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+                email: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
+                sms: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
+                whatsapp: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
             };
         };
         crossDevice: {
-            verify: (token: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            verify: (token: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
             signIn: {
-                email: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                sms: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                whatsapp: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+                email: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+                sms: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+                whatsapp: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
             };
             signUpOrIn: {
-                email: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                sms: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                whatsapp: (identifier: string, uri: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+                email: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+                sms: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
+                whatsapp: (identifier: string, uri: string) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
             };
             signUp: {
                 email: (identifier: string, uri: string, user?: {
                     email?: string;
                     name?: string;
                     phone?: string;
-                }) => Promise<_descope_core_js_sdk.SdkResponse>;
+                }) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
                 sms: (identifier: string, uri: string, user?: {
                     email?: string;
                     name?: string;
                     phone?: string;
-                }) => Promise<_descope_core_js_sdk.SdkResponse>;
+                }) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
                 whatsapp: (identifier: string, uri: string, user?: {
                     email?: string;
                     name?: string;
                     phone?: string;
-                }) => Promise<_descope_core_js_sdk.SdkResponse>;
+                }) => Promise<SdkResponse<_descope_core_js_sdk.PendingRefResponse>>;
             };
             waitForSession: (pendingRef: string, config?: {
                 pollingIntervalMs: number;
                 timeoutMs: number;
-            }) => Promise<_descope_core_js_sdk.SdkResponse>;
+            }) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>; /**
+             * Make sure that all given roles exist on the parsed JWT tenant claims
+             * @param authInfo JWT parsed info
+             * @param roles list of roles to make sure they exist on te JWT claims
+             * @returns true if all roles exist, false otherwise
+             */
             update: {
-                email: (identifier: string, email: string, uri: string, token?: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+                email: (identifier: string, email: string, uri: string, token?: string) => Promise<SdkResponse<never>>;
                 phone: {
-                    email: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                    sms: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-                    whatsapp: (identifier: string, phone: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+                    email: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
+                    sms: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
+                    whatsapp: (identifier: string, phone: string) => Promise<SdkResponse<never>>;
                 };
             };
         };
     };
     oauth: {
-        exchange: (code: string) => Promise<_descope_core_js_sdk.SdkResponse>;
         start: {
             facebook: <B extends {
                 redirect: boolean;
             }>(redirectURL?: string, config?: B) => Promise<B extends {
                 redirect: true;
-            } ? undefined : _descope_core_js_sdk.SdkResponse>;
+            } ? undefined : SdkResponse<_descope_core_js_sdk.URLResponse>>;
             github: <B_1 extends {
                 redirect: boolean;
             }>(redirectURL?: string, config?: B_1) => Promise<B_1 extends {
                 redirect: true;
-            } ? undefined : _descope_core_js_sdk.SdkResponse>;
+            } ? undefined : SdkResponse<_descope_core_js_sdk.URLResponse>>;
             google: <B_2 extends {
                 redirect: boolean;
             }>(redirectURL?: string, config?: B_2) => Promise<B_2 extends {
                 redirect: true;
-            } ? undefined : _descope_core_js_sdk.SdkResponse>;
+            } ? undefined : SdkResponse<_descope_core_js_sdk.URLResponse>>;
             microsoft: <B_3 extends {
                 redirect: boolean;
             }>(redirectURL?: string, config?: B_3) => Promise<B_3 extends {
                 redirect: true;
-            } ? undefined : _descope_core_js_sdk.SdkResponse>;
+            } ? undefined : SdkResponse<_descope_core_js_sdk.URLResponse>>;
             gitlab: <B_4 extends {
                 redirect: boolean;
             }>(redirectURL?: string, config?: B_4) => Promise<B_4 extends {
                 redirect: true;
-            } ? undefined : _descope_core_js_sdk.SdkResponse>;
+            } ? undefined : SdkResponse<_descope_core_js_sdk.URLResponse>>;
             apple: <B_5 extends {
                 redirect: boolean;
             }>(redirectURL?: string, config?: B_5) => Promise<B_5 extends {
                 redirect: true;
-            } ? undefined : _descope_core_js_sdk.SdkResponse>;
+            } ? undefined : SdkResponse<_descope_core_js_sdk.URLResponse>>;
         };
+        exchange: (code: string, loginOptions?: {
+            stepup: boolean;
+            customClaims: Map<string, any>;
+        }, token?: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
     };
     saml: {
-        exchange: (code: string) => Promise<_descope_core_js_sdk.SdkResponse>;
         start: <B_1 extends {
             redirect: boolean;
         }>(tenantNameOrEmail: string, config?: B_1) => Promise<B_1 extends {
             redirect: true;
-        } ? undefined : _descope_core_js_sdk.SdkResponse>;
+        } ? undefined : SdkResponse<_descope_core_js_sdk.URLResponse>>;
+        exchange: (code: string, loginOptions?: {
+            stepup: boolean;
+            customClaims: Map<string, any>;
+        }, token?: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
     };
     totp: {
         signUp: (identifier: string, user?: {
             email?: string;
             name?: string;
             phone?: string;
-        }) => Promise<_descope_core_js_sdk.SdkResponse>;
-        verify: (identifier: string, code: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-        update: (identifier: string, token?: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+        }) => Promise<SdkResponse<_descope_core_js_sdk.TOTPResponse>>;
+        verify: (identifier: string, code: string, loginOptions?: {
+            stepup: boolean;
+            customClaims: Map<string, any>;
+        }, token?: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
+        update: (identifier: string, token?: string) => Promise<SdkResponse<_descope_core_js_sdk.TOTPResponse>>;
     };
     webauthn: {
         signUp: {
-            start: (identifier: string, origin: string, name: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            finish: (transactionId: string, response: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            start: (identifier: string, origin: string, name: string) => Promise<SdkResponse<_descope_core_js_sdk.ResponseData>>;
+            finish: (transactionId: string, response: string, loginOptions?: {
+                stepup: boolean;
+                customClaims: Map<string, any>;
+            }, token?: string) => Promise<SdkResponse<_descope_core_js_sdk.ResponseData>>;
         };
         signIn: {
-            start: (identifier: string, origin: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            finish: (transactionId: string, response: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+            start: (identifier: string, origin: string) => Promise<SdkResponse<_descope_core_js_sdk.ResponseData>>;
+            finish: (transactionId: string, response: string, loginOptions?: {
+                stepup: boolean;
+                customClaims: Map<string, any>;
+            }, token?: string) => Promise<SdkResponse<_descope_core_js_sdk.ResponseData>>;
         };
-        add: {
-            start: (identifier: string, origin: string, token: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-            finish: (transactionId: string, response: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+        update: {
+            start: (identifier: string, origin: string, token: string) => Promise<SdkResponse<_descope_core_js_sdk.ResponseData>>;
+            finish: (transactionId: string, response: string) => Promise<SdkResponse<_descope_core_js_sdk.ResponseData>>;
         };
     };
     flow: {
-        start: (flowId: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-        next: (executionId: string, stepId: string, actionId: string, input?: Record<string, FormDataEntryValue>) => Promise<_descope_core_js_sdk.SdkResponse>;
+        start: (flowId: string) => Promise<SdkResponse<_descope_core_js_sdk.FlowResponse>>;
+        next: (executionId: string, stepId: string, interactionId: string, input?: Record<string, FormDataEntryValue>) => Promise<SdkResponse<_descope_core_js_sdk.FlowResponse>>;
     };
-    refresh: (token?: string) => Promise<_descope_core_js_sdk.SdkResponse>;
-    logout: (token?: string) => Promise<_descope_core_js_sdk.SdkResponse>;
+    refresh: (token?: string) => Promise<SdkResponse<_descope_core_js_sdk.JWTResponse>>;
+    logout: (token?: string) => Promise<SdkResponse<never>>;
+    deleteCookies: (token?: string) => Promise<SdkResponse<never>>;
+    me: (token?: string) => Promise<SdkResponse<_descope_core_js_sdk.UserResponse>>;
     isJwtExpired: (token: string) => boolean;
+    getJwtPermissions: (token: string, tenant?: string) => string[];
+    getJwtRoles: (token: string, tenant?: string) => string[];
     httpClient: {
         get: (path: string, config?: {
             headers?: HeadersInit;
@@ -261,6 +365,8 @@ declare const sdkWithAttributes: ((args_0: {
     };
 }) & {
     DeliveryMethods: typeof _descope_core_js_sdk__default.DeliveryMethods;
+    RefreshTokenCookieName: typeof refreshTokenCookieName;
+    SessionTokenCookieName: typeof sessionTokenCookieName;
 };
 
 export { sdkWithAttributes as default };

package/dist/index.esm.js

@@ -1,2 +1,2 @@
-import{__awaiter as e}from"tslib";import t from"@descope/core-js-sdk";import{jwtVerify as i,importJWK as o}from"jose";import r,{Headers as n,Request as s,Response as a}from"node-fetch";const d=(e,t)=>`${e}=${t};`,c=t=>(...i)=>e(void 0,void 0,void 0,(function*(){var e;const o=yield t(...i);if(!o.data)return o;let{sessionJwt:r,refreshJwt:n}=o.data,s=d("DS",r);return n?s+=d("DSR",n):(s+=(null===(e=o.response)||void 0===e?void 0:e.headers.get("set-cookie"))||"",n=((e,t)=>{const i=null==e?void 0:e.match(RegExp(`(?:^|;\\s*)${t}=([^;]*)`));return i?i[1]:null})(s,"DSR")),Object.assign(Object.assign({},o),{data:Object.assign(Object.assign({},o.data),{refreshJwt:n,cookies:s})})})),l=(e,t,i)=>{if(!e)return;const o="string"==typeof t?t.split("."):t,r=o.shift()||"";if(0===o.length||"*"===r){const t=t=>{if(!t||"function"!=typeof e[t])throw Error(`cannot wrap value at key "${t.toString()}"`);e[t]=i(e[t])};"*"===r?Object.keys(e).forEach(t):t(r)}else l(e[r],o,i)};globalThis.fetch||(globalThis.fetch=r,globalThis.Headers=n,globalThis.Request=s,globalThis.Response=a);const h=(...r)=>{const n=t(...r);var s,a;s=n,a=c,["otp.verify.*","magicLink.verify","magicLink.crossDevice.signUp.*","magicLink.crossDevice.signIn.*","oauth.exchange","saml.exchange","totp.verify","webauthn.signIn.finish","webauthn.signUp.finish","refresh"].forEach((e=>l(s,e,a)));const{projectId:d,logger:h}=r[0],f={};return Object.assign(Object.assign({},n),{getKey(t){return e(this,void 0,void 0,(function*(){if(!(null==t?void 0:t.kid))throw Error("header.kid must not be empty");if(f[t.kid])return f[t.kid];if(Object.assign(f,yield e(void 0,void 0,void 0,(function*(){const t=(yield n.httpClient.get(`keys/${d}`).then((e=>e.json())))||[];return(yield Promise.all(t.map((t=>e(void 0,void 0,void 0,(function*(){return[t.kid,yield o(t)]})))))).reduce(((e,[t,i])=>t?Object.assign(Object.assign({},e),{[t.toString()]:i}):e),{})}))),!f[t.kid])throw Error("failed to fetch matching key");return f[t.kid]}))},validateToken(t){return e(this,void 0,void 0,(function*(){return{token:(yield i(t,this.getKey,{algorithms:["ES384"]})).payload}}))},validateSession(t,i){return e(this,void 0,void 0,(function*(){if(!t)throw Error("session token must not be empty");try{return yield this.validateToken(t)}catch(e){try{return yield this.validateToken(i),(yield this.refresh(i)).data}catch(e){throw null==h||h.error("failed to validate refresh token",e),Error("could not validate tokens")}}}))}})};h.DeliveryMethods=t.DeliveryMethods;export{h as default};
+import e from"@descope/core-js-sdk";import{jwtVerify as o,importJWK as t}from"jose";import s,{Headers as r,Request as a,Response as n}from"node-fetch";import{__rest as i}from"tslib";const c=(e,o,t)=>`${e}=${o}; Domain=${(null==t?void 0:t.cookieDomain)||""}; Max-Age=${(null==t?void 0:t.cookieMaxAge)||""}; Path=${(null==t?void 0:t.cookiePath)||"/"}; HttpOnly; SameSite=Strict`,l=e=>async(...o)=>{var t,s,r;const a=await e(...o);if(!a.data)return a;let n=a.data,{sessionJwt:l,refreshJwt:d}=n,h=i(n,["sessionJwt","refreshJwt"]);const u=[c("DS",l,h)];return d?u.push(c("DSR",d,h)):(null===(t=a.response)||void 0===t?void 0:t.headers.get("set-cookie"))&&(d=((e,o)=>{const t=null==e?void 0:e.match(RegExp(`(?:^|;\\s*)${o}=([^;]*)`));return t?t[1]:null})(null===(s=a.response)||void 0===s?void 0:s.headers.get("set-cookie"),"DSR"),u.push(null===(r=a.response)||void 0===r?void 0:r.headers.get("set-cookie"))),Object.assign(Object.assign({},a),{data:Object.assign(Object.assign({},a.data),{refreshJwt:d,cookies:u})})},d=(e,o,t)=>{if(!e)return;const s="string"==typeof o?o.split("."):o,r=s.shift()||"";if(0===s.length||"*"===r){const o=o=>{if(!o||"function"!=typeof e[o])throw Error(`cannot wrap value at key "${o.toString()}"`);e[o]=t(e[o])};"*"===r?Object.keys(e).forEach(o):o(r)}else d(e[r],s,t)};function h(e,o,t){var s,r;const a=t?null===(r=null===(s=e.token.tenants)||void 0===s?void 0:s[t])||void 0===r?void 0:r[o]:e.token[o];return Array.isArray(a)?a:[]}globalThis.fetch||(globalThis.fetch=s,globalThis.Headers=r,globalThis.Request=a,globalThis.Response=n);const u=(...s)=>{const r=[...s];r[0].hooks=r[0].hooks||{};const a=r[0].hooks.beforeRequest;r[0].hooks.beforeRequest=e=>{var o;const t=e;return t.headers=Object.assign(Object.assign({},t.headers),{"x-descope-sdk-name":"nodejs","x-descope-sdk-node-version":(null===(o=null===process||void 0===process?void 0:process.versions)||void 0===o?void 0:o.node)||"","x-descope-sdk-version":"1.0.4-alpha.7"}),(null==a?void 0:a(t))||t};const n=e(...r);var i,c;i=n,c=l,["otp.verify.*","magicLink.verify","magicLink.crossDevice.signUp.*","magicLink.crossDevice.signIn.*","oauth.exchange","saml.exchange","totp.verify","webauthn.signIn.finish","webauthn.signUp.finish","refresh"].forEach((e=>d(i,e,c)));const{projectId:u,logger:v}=s[0],f={},k=Object.assign(Object.assign({},n),{async getKey(e){if(!(null==e?void 0:e.kid))throw Error("header.kid must not be empty");if(f[e.kid])return f[e.kid];if(Object.assign(f,await(async()=>{const e=await n.httpClient.get(`v1/keys/${u}`).then((e=>e.json()));return Array.isArray(e)?(await Promise.all(e.map((async e=>[e.kid,await t(e)])))).reduce(((e,[o,t])=>o?Object.assign(Object.assign({},e),{[o.toString()]:t}):e),{}):{}})()),!f[e.kid])throw Error("failed to fetch matching key");return f[e.kid]},validateJwt:async e=>({jwt:e,token:(await o(e,k.getKey,{issuer:u,clockTolerance:5})).payload}),async validateSession(e,o){var t,s;if(!e&&!o)throw Error("both refresh token and session token are empty");if(e)try{return await k.validateJwt(e)}catch(e){if(!o)throw null==v||v.error("failed to validate session token and no refresh token provided",e),Error("could not validate tokens")}if(o)try{await k.validateJwt(o);const e=await k.refresh(o);if(e.ok){return await k.validateJwt(null===(t=e.data)||void 0===t?void 0:t.sessionJwt)}throw Error(null===(s=e.error)||void 0===s?void 0:s.message)}catch(e){throw null==v||v.error("failed to validate refresh token",e),Error("could not validate tokens")}throw Error("could not validate token")},async exchangeAccessKey(e){if(!e)throw Error("access key must not be empty");let o;try{o=await k.accessKey.exchange(e)}catch(e){throw null==v||v.error("failed to exchange access key",e),Error("could not exchange access key")}const{sessionJwt:t}=o.data;if(!t)throw null==v||v.error("failed to parse exchange access key response"),Error("could not exchange access key");try{return await k.validateJwt(t)}catch(e){throw null==v||v.error("failed to parse jwt from access key",e),Error("could not exchange access key")}},validatePermissions:(e,o)=>k.validateTenantPermissions(e,null,o),validateTenantPermissions(e,o,t){const s=h(e,"permissions",o);return t.every((e=>s.includes(e)))},validateRoles:(e,o)=>k.validateTenantRoles(e,null,o),validateTenantRoles(e,o,t){const s=h(e,"roles",o);return t.every((e=>s.includes(e)))}});return k};u.DeliveryMethods=e.DeliveryMethods,u.RefreshTokenCookieName="DSR",u.SessionTokenCookieName="DS";export{u as default};
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../lib/constants.ts","../lib/helpers.ts","../lib/index.ts"],"sourcesContent":["// eslint-disable-next-line import/prefer-default-export\nexport const refreshTokenCookieName = 'DSR'\nexport const sessionTokenCookieName = 'DS'\n","import type { SdkResponse } from '@descope/core-js-sdk'\nimport { refreshTokenCookieName, sessionTokenCookieName } from './constants'\n\nconst generateCookie = (name: string, value: string) => `${name}=${value};`\n\nconst getCookieValue = (cookie: string | null | undefined, name: string) => {\n  const match = cookie?.match(RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`))\n  return match ? match[1] : null\n}\n\n// eslint-disable-next-line import/prefer-default-export\nexport const withCookie =\n  <T extends Array<any>, U extends Promise<SdkResponse>>(fn: (...args: T) => U) =>\n  async (...args: T): Promise<SdkResponse> => {\n    const resp = await fn(...args)\n\n    if (!resp.data) {\n      return resp\n    }\n\n    // eslint-disable-next-line prefer-const\n    let { sessionJwt, refreshJwt } = resp.data\n    let cookies = generateCookie(sessionTokenCookieName, sessionJwt)\n\n    if (!refreshJwt) {\n      cookies += resp.response?.headers.get('set-cookie') || ''\n      refreshJwt = getCookieValue(cookies, refreshTokenCookieName)\n    } else {\n      cookies += generateCookie(refreshTokenCookieName, refreshJwt)\n    }\n\n    return { ...resp, data: { ...resp.data, refreshJwt, cookies } }\n  }\n\nexport const wrapWith = <T extends Record<string, any>>(\n  obj: T,\n  path: string | string[],\n  wrappingFn: Function,\n  // eslint-disable-next-line consistent-return\n): void => {\n  if (!obj) return\n\n  const pathSections = typeof path === 'string' ? path.split('.') : path\n  const section = pathSections.shift() || ('' as keyof T)\n\n  if (pathSections.length === 0 || section === '*') {\n    const wrap = (key: keyof T) => {\n      if (key && typeof obj[key] === 'function') {\n        // eslint-disable-next-line no-param-reassign\n        obj[key] = wrappingFn(obj[key])\n      } else {\n        throw Error(`cannot wrap value at key \"${key.toString()}\"`)\n      }\n    }\n    if (section === '*') {\n      Object.keys(obj).forEach(wrap)\n    } else {\n      wrap(section)\n    }\n  } else {\n    wrapWith(obj[section], pathSections, wrappingFn)\n  }\n}\n\nexport const bulkWrapWith = (\n  obj: Parameters<typeof wrapWith>[0],\n  paths: string[],\n  wrappingFn: Parameters<typeof wrapWith>[2],\n) => paths.forEach((path: string) => wrapWith(obj, path, wrappingFn))\n","import createSdk from '@descope/core-js-sdk'\nimport { KeyLike, jwtVerify, JWK, JWTHeaderParameters, importJWK } from 'jose'\nimport fetch, { Headers, Response, Request } from 'node-fetch'\nimport { bulkWrapWith, withCookie } from './helpers'\nimport { AuthenticationInfo } from './types'\n\nif (!globalThis.fetch) {\n  // @ts-ignore\n  globalThis.fetch = fetch\n  // @ts-ignore\n  globalThis.Headers = Headers\n  // @ts-ignore\n  globalThis.Request = Request\n  // @ts-ignore\n  globalThis.Response = Response\n}\n\nconst sdk = (...args: Parameters<typeof createSdk>) => {\n  const coreSdk = createSdk(...args)\n\n  bulkWrapWith(\n    coreSdk,\n    [\n      'otp.verify.*',\n      'magicLink.verify',\n      'magicLink.crossDevice.signUp.*',\n      'magicLink.crossDevice.signIn.*',\n      'oauth.exchange',\n      'saml.exchange',\n      'totp.verify',\n      'webauthn.signIn.finish',\n      'webauthn.signUp.finish',\n      'refresh',\n    ],\n    withCookie,\n  )\n\n  const { projectId, logger } = args[0]\n\n  const keys: Record<string, KeyLike | Uint8Array> = {}\n\n  const fetchKeys = async () => {\n    const publicKeys: JWK[] =\n      (await coreSdk.httpClient.get(`keys/${projectId}`).then((resp) => resp.json())) || []\n    const kidJwksPairs = await Promise.all(\n      publicKeys.map(async (key) => [key.kid, await importJWK(key)]),\n    )\n\n    return kidJwksPairs.reduce(\n      (acc, [kid, jwk]) => (kid ? { ...acc, [kid.toString()]: jwk } : acc),\n      {},\n    )\n  }\n\n  return {\n    ...coreSdk,\n\n    async getKey(header: JWTHeaderParameters): Promise<KeyLike | Uint8Array> {\n      if (!header?.kid) throw Error('header.kid must not be empty')\n\n      if (keys[header.kid]) return keys[header.kid]\n\n      // do we need to fetch once or every time?\n      Object.assign(keys, await fetchKeys())\n\n      if (!keys[header.kid]) throw Error('failed to fetch matching key')\n\n      return keys[header.kid]\n    },\n\n    async validateToken(token: string): Promise<AuthenticationInfo> {\n      const res = await jwtVerify(token, this.getKey, { algorithms: ['ES384'] })\n\n      return { token: res.payload }\n    },\n\n    async validateSession(\n      sessionToken: string,\n      refreshToken: string,\n    ): Promise<AuthenticationInfo | undefined> {\n      if (!sessionToken) throw Error('session token must not be empty')\n\n      try {\n        const token = await this.validateToken(sessionToken)\n        return token\n      } catch (error) {\n        try {\n          await this.validateToken(refreshToken)\n\n          return (await this.refresh(refreshToken)).data\n        } catch (refreshTokenErr) {\n          logger?.error('failed to validate refresh token', refreshTokenErr)\n\n          throw Error('could not validate tokens')\n        }\n      }\n    },\n  }\n}\n\nconst sdkWithAttributes = sdk as typeof sdk & { DeliveryMethods: typeof createSdk.DeliveryMethods }\n\nsdkWithAttributes.DeliveryMethods = createSdk.DeliveryMethods\n\nexport default sdkWithAttributes\n\nexport type { DeliveryMethod, OAuthProvider } from '@descope/core-js-sdk'\n"],"names":["generateCookie","name","value","withCookie","fn","args","__awaiter","resp","data","sessionJwt","refreshJwt","cookies","_a","response","headers","get","cookie","match","RegExp","getCookieValue","Object","assign","wrapWith","obj","path","wrappingFn","pathSections","split","section","shift","length","wrap","key","Error","toString","keys","forEach","globalThis","fetch","Headers","Request","Response","sdkWithAttributes","coreSdk","createSdk","projectId","logger","getKey","header","kid","publicKeys","httpClient","then","json","Promise","all","map","importJWK","reduce","acc","jwk","validateToken","token","jwtVerify","this","algorithms","payload","validateSession","sessionToken","refreshToken","error","refresh","refreshTokenErr","DeliveryMethods"],"mappings":"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"}
+{"version":3,"file":"index.esm.js","sources":["../lib/constants.ts","../lib/helpers.ts","../lib/index.ts"],"sourcesContent":["// eslint-disable-next-line import/prefer-default-export\n/** Refresh JWT cookie name */\nexport const refreshTokenCookieName = 'DSR';\n/** Session JWT cookie name */\nexport const sessionTokenCookieName = 'DS';\n/** The key of the tenants claims in the claims map */\nexport const authorizedTenantsClaimName = 'tenants';\n/** The key of the permissions claims in the claims map either under tenant or top level */\nexport const permissionsClaimName = 'permissions';\n/** The key of the roles claims in the claims map either under tenant or top level */\nexport const rolesClaimName = 'roles';\n","import type { ResponseData, SdkResponse } from '@descope/core-js-sdk';\nimport { AuthenticationInfo } from './types';\nimport {\n  refreshTokenCookieName,\n  sessionTokenCookieName,\n  authorizedTenantsClaimName,\n} from './constants';\n\n/**\n * Generate a cookie string from given parameters\n * @param name name of the cookie\n * @param value value of cookie that must be already encoded\n * @param options any options to put on the cookie like cookieDomain, cookieMaxAge, cookiePath\n * @returns Cookie string with all options on the string\n */\nconst generateCookie = (name: string, value: string, options?: Record<string, string | number>) =>\n  `${name}=${value}; Domain=${options?.cookieDomain || ''}; Max-Age=${\n    options?.cookieMaxAge || ''\n  }; Path=${options?.cookiePath || '/'}; HttpOnly; SameSite=Strict`;\n\n/**\n * Parse the cookie string and return the value of the cookie\n * @param cookie the raw cookie string\n * @param name the name of the cookie to get value for\n * @returns the value of the given cookie\n */\nconst getCookieValue = (cookie: string | null | undefined, name: string) => {\n  const match = cookie?.match(RegExp(`(?:^|;\\\\s*)${name}=([^;]*)`));\n  return match ? match[1] : null;\n};\n\n// eslint-disable-next-line import/prefer-default-export\n/**\n * Add cookie generation to core-js functions.\n * @param fn the function we are wrapping\n * @returns Wrapped function with cookie generation\n */\nexport const withCookie =\n  <T extends Array<any>, U extends Promise<SdkResponse<ResponseData>>>(fn: (...args: T) => U) =>\n  async (...args: T): Promise<SdkResponse<ResponseData>> => {\n    const resp = await fn(...args);\n\n    // istanbul ignore next\n    if (!resp.data) {\n      return resp;\n    }\n\n    // eslint-disable-next-line prefer-const\n    let { sessionJwt, refreshJwt, ...rest } = resp.data;\n    const cookies = [generateCookie(sessionTokenCookieName, sessionJwt, rest)];\n\n    if (!refreshJwt) {\n      if (resp.response?.headers.get('set-cookie')) {\n        refreshJwt = getCookieValue(\n          resp.response?.headers.get('set-cookie'),\n          refreshTokenCookieName,\n        );\n        cookies.push(resp.response?.headers.get('set-cookie')!);\n      }\n    } else {\n      cookies.push(generateCookie(refreshTokenCookieName, refreshJwt, rest));\n    }\n\n    return { ...resp, data: { ...resp.data, refreshJwt, cookies } };\n  };\n\n/**\n * Wrap given object internal functions (can be deep inside the object) with the given wrapping function\n * @param obj we will deep wrap functions inside this object based on the given path\n * @param path the path of internal objects to walk before wrapping the final result. Path is collection of parts separated by '.' that support '*' to say all of the keys for the part.\n * @param wrappingFn function to wrap with\n * @returns void, we update the functions in place\n */\nexport const wrapWith = <T extends Record<string, any>>(\n  obj: T,\n  path: string | string[],\n  wrappingFn: Function,\n  // eslint-disable-next-line consistent-return\n): void => {\n  if (!obj) return;\n\n  const pathSections = typeof path === 'string' ? path.split('.') : path;\n  const section = pathSections.shift() || ('' as keyof T);\n\n  if (pathSections.length === 0 || section === '*') {\n    const wrap = (key: keyof T) => {\n      if (key && typeof obj[key] === 'function') {\n        // eslint-disable-next-line no-param-reassign\n        obj[key] = wrappingFn(obj[key]);\n      } else {\n        // istanbul ignore next\n        throw Error(`cannot wrap value at key \"${key.toString()}\"`);\n      }\n    };\n    if (section === '*') {\n      Object.keys(obj).forEach(wrap);\n    } else {\n      wrap(section);\n    }\n  } else {\n    wrapWith(obj[section], pathSections, wrappingFn);\n  }\n};\n\n/**\n * Wrap given object internal functions (can be deep inside the object) with the given wrapping function based on multiple paths.\n * @param obj we will deep wrap functions inside this object based on the given paths\n * @param paths multiple paths of internal objects to walk before wrapping the final result. Path is collection of parts separated by '.' that support '*' to say all of the keys for the part.\n * @param wrappingFn function to wrap with\n * @returns void, we update the functions in place\n */\nexport const bulkWrapWith = (\n  obj: Parameters<typeof wrapWith>[0],\n  paths: string[],\n  wrappingFn: Parameters<typeof wrapWith>[2],\n) => paths.forEach((path: string) => wrapWith(obj, path, wrappingFn));\n\n/**\n * Get the claim (used for permissions or roles) for a given tenant or top level if tenant is empty\n * @param authInfo The parsed authentication info from the JWT\n * @param claim name of the claim\n * @param tenant tenant to retrieve the claim for\n * @returns\n */\nexport function getAuthorizationClaimItems(\n  authInfo: AuthenticationInfo,\n  claim: string,\n  tenant?: string,\n): string[] {\n  const value = tenant\n    ? authInfo.token[authorizedTenantsClaimName]?.[tenant]?.[claim]\n    : authInfo.token[claim];\n  return Array.isArray(value) ? value : [];\n}\n","import createSdk, {\n  SdkResponse,\n  ExchangeAccessKeyResponse,\n  RequestConfig,\n} from '@descope/core-js-sdk';\nimport { KeyLike, jwtVerify, JWK, JWTHeaderParameters, importJWK } from 'jose';\nimport fetch, { Headers, Response, Request } from 'node-fetch';\nimport { bulkWrapWith, withCookie, getAuthorizationClaimItems } from './helpers';\nimport { AuthenticationInfo } from './types';\nimport {\n  refreshTokenCookieName,\n  sessionTokenCookieName,\n  permissionsClaimName,\n  rolesClaimName,\n} from './constants';\n\ndeclare const BUILD_VERSION: string;\n\n/* istanbul ignore next */\nif (!globalThis.fetch) {\n  // @ts-ignore\n  globalThis.fetch = fetch;\n  // @ts-ignore\n  globalThis.Headers = Headers;\n  // @ts-ignore\n  globalThis.Request = Request;\n  // @ts-ignore\n  globalThis.Response = Response;\n}\n\nconst nodeSdk = (...args: Parameters<typeof createSdk>) => {\n  const funcArgs: typeof args = [...args];\n  funcArgs[0].hooks = funcArgs[0].hooks || {};\n  const origBeforeRequest = funcArgs[0].hooks.beforeRequest;\n  funcArgs[0].hooks.beforeRequest = (config: RequestConfig) => {\n    const conf = config;\n    conf.headers = {\n      ...conf.headers,\n      'x-descope-sdk-name': 'nodejs',\n      'x-descope-sdk-node-version': process?.versions?.node || '',\n      'x-descope-sdk-version': BUILD_VERSION,\n    };\n    return origBeforeRequest?.(conf) || conf;\n  };\n  const coreSdk = createSdk(...funcArgs);\n\n  bulkWrapWith(\n    coreSdk,\n    [\n      'otp.verify.*',\n      'magicLink.verify',\n      'magicLink.crossDevice.signUp.*',\n      'magicLink.crossDevice.signIn.*',\n      'oauth.exchange',\n      'saml.exchange',\n      'totp.verify',\n      'webauthn.signIn.finish',\n      'webauthn.signUp.finish',\n      'refresh',\n    ],\n    withCookie,\n  );\n\n  const { projectId, logger } = args[0];\n\n  const keys: Record<string, KeyLike | Uint8Array> = {};\n\n  /** Fetch the public keys (JWKs) from Descope for the configured project */\n  const fetchKeys = async () => {\n    const publicKeys: JWK[] = await coreSdk.httpClient\n      .get(`v1/keys/${projectId}`)\n      .then((resp) => resp.json());\n    if (!Array.isArray(publicKeys)) return {};\n    const kidJwksPairs = await Promise.all(\n      publicKeys.map(async (key) => [key.kid, await importJWK(key)]),\n    );\n\n    return kidJwksPairs.reduce(\n      (acc, [kid, jwk]) => (kid ? { ...acc, [kid.toString()]: jwk } : acc),\n      {},\n    );\n  };\n\n  const sdk = {\n    ...coreSdk,\n\n    /** Get the key that can validate the given JWT KID in the header. Can retrieve the public key from local cache or from Descope. */\n    async getKey(header: JWTHeaderParameters): Promise<KeyLike | Uint8Array> {\n      if (!header?.kid) throw Error('header.kid must not be empty');\n\n      if (keys[header.kid]) return keys[header.kid];\n\n      // do we need to fetch once or every time?\n      Object.assign(keys, await fetchKeys());\n\n      if (!keys[header.kid]) throw Error('failed to fetch matching key');\n\n      return keys[header.kid];\n    },\n\n    /**\n     * Validate the given JWT with the right key and make sure the issuer is correct\n     * @param jwt the JWT string to parse and validate\n     * @returns AuthenticationInfo with the parsed token and JWT. Will throw an error if validation fails.\n     */\n    async validateJwt(jwt: string): Promise<AuthenticationInfo> {\n      // Do not hard-code the algo because library does not support `None` so all are valid\n      const res = await jwtVerify(jwt, sdk.getKey, { issuer: projectId, clockTolerance: 5 });\n\n      return { jwt, token: res.payload };\n    },\n\n    /**\n     * Validate session based on at least one of session and refresh JWTs. You must provide at least one of them.\n     *\n     * @param sessionToken session JWT\n     * @param refreshToken refresh JWT\n     * @returns AuthenticationInfo promise or throws Error if there is an issue with JWTs\n     */\n    async validateSession(\n      sessionToken?: string,\n      refreshToken?: string,\n    ): Promise<AuthenticationInfo> {\n      if (!sessionToken && !refreshToken)\n        throw Error('both refresh token and session token are empty');\n\n      if (sessionToken) {\n        try {\n          const token = await sdk.validateJwt(sessionToken);\n          return token;\n        } catch (error) {\n          if (!refreshToken) {\n            logger?.error('failed to validate session token and no refresh token provided', error);\n            throw Error('could not validate tokens');\n          }\n        }\n      }\n      if (refreshToken) {\n        try {\n          await sdk.validateJwt(refreshToken);\n          const jwtResp = await sdk.refresh(refreshToken);\n          if (jwtResp.ok) {\n            const token = await sdk.validateJwt(jwtResp.data?.sessionJwt);\n            return token;\n          }\n          throw Error(jwtResp.error?.message);\n        } catch (refreshTokenErr) {\n          logger?.error('failed to validate refresh token', refreshTokenErr);\n          throw Error('could not validate tokens');\n        }\n      }\n      /* istanbul ignore next */\n      throw Error('could not validate token');\n    },\n\n    /**\n     * Exchange API key (access key) for a session key\n     * @param accessKey access key to exchange for a session JWT\n     * @returns AuthneticationInfo with session JWT data\n     */\n    async exchangeAccessKey(accessKey: string): Promise<AuthenticationInfo> {\n      if (!accessKey) throw Error('access key must not be empty');\n\n      let resp: SdkResponse<ExchangeAccessKeyResponse>;\n      try {\n        resp = await sdk.accessKey.exchange(accessKey);\n      } catch (error) {\n        logger?.error('failed to exchange access key', error);\n        throw Error('could not exchange access key');\n      }\n\n      const { sessionJwt } = resp.data;\n      if (!sessionJwt) {\n        logger?.error('failed to parse exchange access key response');\n        throw Error('could not exchange access key');\n      }\n\n      try {\n        const token = await sdk.validateJwt(sessionJwt);\n        return token;\n      } catch (error) {\n        logger?.error('failed to parse jwt from access key', error);\n        throw Error('could not exchange access key');\n      }\n    },\n\n    /**\n     * Make sure that all given permissions exist on the parsed JWT top level claims\n     * @param authInfo JWT parsed info\n     * @param permissions list of permissions to make sure they exist on te JWT claims\n     * @returns true if all permissions exist, false otherwise\n     */\n    validatePermissions(authInfo: AuthenticationInfo, permissions: string[]): boolean {\n      return sdk.validateTenantPermissions(authInfo, null, permissions);\n    },\n\n    /**\n     * Make sure that all given permissions exist on the parsed JWT tenant claims\n     * @param authInfo JWT parsed info\n     * @param permissions list of permissions to make sure they exist on te JWT claims\n     * @returns true if all permissions exist, false otherwise\n     */\n    validateTenantPermissions(\n      authInfo: AuthenticationInfo,\n      tenant: string,\n      permissions: string[],\n    ): boolean {\n      const granted = getAuthorizationClaimItems(authInfo, permissionsClaimName, tenant);\n      return permissions.every((perm) => granted.includes(perm));\n    },\n\n    /**\n     * Make sure that all given roles exist on the parsed JWT top level claims\n     * @param authInfo JWT parsed info\n     * @param roles list of roles to make sure they exist on te JWT claims\n     * @returns true if all roles exist, false otherwise\n     */\n    validateRoles(authInfo: AuthenticationInfo, roles: string[]): boolean {\n      return sdk.validateTenantRoles(authInfo, null, roles);\n    },\n\n    /**\n     * Make sure that all given roles exist on the parsed JWT tenant claims\n     * @param authInfo JWT parsed info\n     * @param roles list of roles to make sure they exist on te JWT claims\n     * @returns true if all roles exist, false otherwise\n     */\n    validateTenantRoles(authInfo: AuthenticationInfo, tenant: string, roles: string[]): boolean {\n      const membership = getAuthorizationClaimItems(authInfo, rolesClaimName, tenant);\n      return roles.every((role) => membership.includes(role));\n    },\n  };\n\n  return sdk;\n};\n\n/** Descope SDK client with delivery methods enum.\n *\n * Please see full documentation at {@link https://docs.descope.com/guides Descope Docs}\n * @example Usage\n *\n * ```js\n * import descopeSdk from '@descope/node-sdk';\n *\n * const myProjectId = 'xxx';\n * const sdk = descopeSdk({ projectId: myProjectId });\n *\n * const userIdentifier = 'identifier';\n * sdk.otp.signIn.email(userIdentifier);\n * const jwtResponse = sdk.otp.verify.email(userIdentifier, codeFromEmail);\n * ```\n */\nconst sdkWithAttributes = nodeSdk as typeof nodeSdk & {\n  DeliveryMethods: typeof createSdk.DeliveryMethods;\n  RefreshTokenCookieName: typeof refreshTokenCookieName;\n  SessionTokenCookieName: typeof sessionTokenCookieName;\n};\n\nsdkWithAttributes.DeliveryMethods = createSdk.DeliveryMethods;\nsdkWithAttributes.RefreshTokenCookieName = refreshTokenCookieName;\nsdkWithAttributes.SessionTokenCookieName = sessionTokenCookieName;\n\nexport default sdkWithAttributes;\n\nexport type { DeliveryMethod, OAuthProvider } from '@descope/core-js-sdk';\n"],"names":["generateCookie","name","value","options","cookieDomain","cookieMaxAge","cookiePath","withCookie","fn","async","args","resp","data","_d","sessionJwt","refreshJwt","rest","__rest","cookies","push","_a","response","headers","get","cookie","match","RegExp","getCookieValue","_b","_c","Object","assign","wrapWith","obj","path","wrappingFn","pathSections","split","section","shift","length","wrap","key","Error","toString","keys","forEach","getAuthorizationClaimItems","authInfo","claim","tenant","token","Array","isArray","globalThis","fetch","Headers","Request","Response","sdkWithAttributes","funcArgs","hooks","origBeforeRequest","beforeRequest","config","conf","process","versions","node","coreSdk","createSdk","projectId","logger","sdk","header","kid","publicKeys","httpClient","then","json","Promise","all","map","importJWK","reduce","acc","jwk","fetchKeys","jwt","jwtVerify","getKey","issuer","clockTolerance","payload","sessionToken","refreshToken","validateJwt","error","jwtResp","refresh","ok","message","refreshTokenErr","accessKey","exchange","validatePermissions","permissions","validateTenantPermissions","granted","every","perm","includes","validateRoles","roles","validateTenantRoles","membership","role","DeliveryMethods","RefreshTokenCookieName","SessionTokenCookieName"],"mappings":"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"}