@salesforce/commerce-sdk-react 3.2.0-preview.0 → 3.2.0-preview.1

package/CHANGELOG.md

@@ -1,6 +1,5 @@
+## v3.2.0-preview.1 (Feb 12, 2025)
 ## v3.2.0-preview.0 (Feb 03, 2025)
-## v3.2.0-dev (Feb 03, 2025)
-## v3.9.0-preview.0 (Feb 03, 2025)
 ## v3.2.0-dev (Oct 29, 2024)
 - Allow cookies for ShopperLogin API [#2190](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2190
 - Fix refresh token TTL warning from firing when override is not provided [#2114](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2114)
@@ -9,6 +8,7 @@
 - Clear auth state if session has been invalidated by a password change [#2092](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2092)
 - DNT interface improvement [#2203](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2203)
 - Support Node 22 [#2218](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2218)
+- Add `authorizeIDP`, `loginIDPUser`, `authorizePasswordless`, `getPasswordLessAccessToken`, `getPasswordResetToken`, and `resetPassword` wrapper functions to support Social Login, Passwordless Login, and Password Reset [#2079] (https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2079)
 
 ## v3.1.0 (Oct 28, 2024)
 

package/auth/index.d.ts

@@ -15,9 +15,15 @@ interface AuthConfig extends ApiClientConfigParams {
     silenceWarnings?: boolean;
     logger: Logger;
     defaultDnt?: boolean;
+    passwordlessLoginCallbackURI?: string;
     refreshTokenRegisteredCookieTTL?: number;
     refreshTokenGuestCookieTTL?: number;
 }
+type AuthorizeIDPParams = Parameters<Helpers['authorizeIDP']>[1];
+type LoginIDPUserParams = Parameters<Helpers['loginIDPUser']>[2];
+type AuthorizePasswordlessParams = Parameters<Helpers['authorizePasswordless']>[2];
+type LoginPasswordlessParams = Parameters<Helpers['getPasswordLessAccessToken']>[2];
+type LoginRegisteredUserB2CCredentials = Parameters<Helpers['loginRegisteredUserB2C']>[1];
 /**
  * The extended field is not from api response, we manually store the auth type,
  * so we don't need to make another API call when we already have the data.
@@ -29,7 +35,7 @@ export type AuthData = Prettify<RemoveStringIndex<TokenResponse> & {
     idp_access_token: string;
 }>;
 /** A shopper could be guest or registered, so we store the refresh tokens individually. */
-type AuthDataKeys = Exclude<keyof AuthData, 'refresh_token'> | 'refresh_token_guest' | 'refresh_token_registered' | 'access_token_sfra' | typeof DNT_COOKIE_NAME | typeof DWSID_COOKIE_NAME;
+type AuthDataKeys = Exclude<keyof AuthData, 'refresh_token'> | 'refresh_token_guest' | 'refresh_token_registered' | 'access_token_sfra' | typeof DNT_COOKIE_NAME | typeof DWSID_COOKIE_NAME | 'code_verifier' | 'uido';
 type DntOptions = {
     includeDefaults: boolean;
 };
@@ -54,6 +60,8 @@ declare class Auth {
     private silenceWarnings;
     private logger;
     private defaultDnt;
+    private isPrivate;
+    private passwordlessLoginCallbackURI;
     private refreshTokenRegisteredCookieTTL;
     private refreshTokenGuestCookieTTL;
     private refreshTrustedAgentHandler;
@@ -235,6 +243,7 @@ declare class Auth {
         fax?: string | undefined;
         firstName?: string | undefined;
         gender?: number | undefined;
+        hashedLogin?: string | undefined;
         jobTitle?: string | undefined;
         lastLoginTime?: any;
         lastModified?: any;
@@ -294,7 +303,7 @@ declare class Auth {
      * A wrapper method for commerce-sdk-isomorphic helper: loginRegisteredUserB2C.
      *
      */
-    loginRegisteredUserB2C(credentials: Parameters<Helpers['loginRegisteredUserB2C']>[1]): Promise<helpers.TokenResponse>;
+    loginRegisteredUserB2C(credentials: LoginRegisteredUserB2CCredentials): Promise<helpers.TokenResponse>;
     /**
      * Trusted agent authorization
      *
@@ -354,6 +363,34 @@ declare class Auth {
         currentPassword: string;
         shouldReloginCurrentSession?: boolean;
     }): Promise<void>;
+    /**
+     * A wrapper method for commerce-sdk-isomorphic helper: authorizeIDP.
+     *
+     */
+    authorizeIDP(parameters: AuthorizeIDPParams): Promise<void>;
+    /**
+     * A wrapper method for commerce-sdk-isomorphic helper: loginIDPUser.
+     *
+     */
+    loginIDPUser(parameters: LoginIDPUserParams): Promise<helpers.TokenResponse>;
+    /**
+     * A wrapper method for commerce-sdk-isomorphic helper: authorizePasswordless.
+     */
+    authorizePasswordless(parameters: AuthorizePasswordlessParams): Promise<Response>;
+    /**
+     * A wrapper method for commerce-sdk-isomorphic helper: getPasswordLessAccessToken.
+     */
+    getPasswordLessAccessToken(parameters: LoginPasswordlessParams): Promise<helpers.TokenResponse>;
+    /**
+     * A wrapper method for the SLAS endpoint: getPasswordResetToken.
+     *
+     */
+    getPasswordResetToken(parameters: ShopperLoginTypes.PasswordActionRequest): Promise<void>;
+    /**
+     * A wrapper method for the SLAS endpoint: resetPassword.
+     *
+     */
+    resetPassword(parameters: ShopperLoginTypes.PasswordActionVerifyRequest): Promise<void>;
     /**
      * Decode SLAS JWT and extract information such as customer id, usid, etc.
      *
@@ -366,6 +403,7 @@ declare class Auth {
         loginId: string;
         isAgent: boolean;
         agentId: string | null;
+        uido: string;
     };
 }
 export default Auth;

package/auth/index.js

@@ -115,6 +115,14 @@ const DATA_MAP = {
   dwsid: {
     storageType: 'cookie',
     key: _constant.DWSID_COOKIE_NAME
+  },
+  code_verifier: {
+    storageType: 'local',
+    key: 'code_verifier'
+  },
+  uido: {
+    storageType: 'local',
+    key: 'uido'
   }
 };
 const DEFAULT_SLAS_REFRESH_TOKEN_REGISTERED_TTL = exports.DEFAULT_SLAS_REFRESH_TOKEN_REGISTERED_TTL = 90 * 24 * 60 * 60;
@@ -205,6 +213,9 @@ class Auth {
     // PWA users should not need to touch this.
     config.clientSecret || '';
     this.silenceWarnings = config.silenceWarnings || false;
+    this.isPrivate = !!this.clientSecret;
+    const passwordlessLoginCallbackURI = config.passwordlessLoginCallbackURI;
+    this.passwordlessLoginCallbackURI = passwordlessLoginCallbackURI ? (0, _utils.isAbsoluteUrl)(passwordlessLoginCallbackURI) ? passwordlessLoginCallbackURI : `${baseUrl}${passwordlessLoginCallbackURI}` : '';
   }
   get(name) {
     const {
@@ -485,6 +496,12 @@ class Auth {
     const responseValue = res.refresh_token_expires_in;
     const defaultValue = isGuest ? DEFAULT_SLAS_REFRESH_TOKEN_GUEST_TTL : DEFAULT_SLAS_REFRESH_TOKEN_REGISTERED_TTL;
     const refreshTokenTTLValue = this.getRefreshTokenCookieTTLValue(overrideValue, responseValue, defaultValue);
+    if (res.access_token) {
+      const {
+        uido
+      } = this.parseSlasJWT(res.access_token);
+      this.set('uido', uido);
+    }
     const expiresDate = this.convertSecondsToDate(refreshTokenTTLValue);
     this.set('refresh_token_expires_in', refreshTokenTTLValue.toString());
     this.set(refreshTokenKey, res.refresh_token, {
@@ -930,6 +947,186 @@ class Auth {
     })();
   }
 
+  /**
+   * A wrapper method for commerce-sdk-isomorphic helper: authorizeIDP.
+   *
+   */
+  authorizeIDP(parameters) {
+    var _this14 = this;
+    return _asyncToGenerator(function* () {
+      const redirectURI = parameters.redirectURI || _this14.redirectURI;
+      const usid = _this14.get('usid');
+      const {
+        url,
+        codeVerifier
+      } = yield _commerceSdkIsomorphic.helpers.authorizeIDP(_this14.client, _objectSpread({
+        redirectURI,
+        hint: parameters.hint
+      }, usid && {
+        usid
+      }), _this14.isPrivate);
+      if ((0, _utils.onClient)()) {
+        window.location.assign(url);
+      } else {
+        console.warn('Something went wrong, this client side method is invoked on the server.');
+      }
+      _this14.set('code_verifier', codeVerifier);
+    })();
+  }
+
+  /**
+   * A wrapper method for commerce-sdk-isomorphic helper: loginIDPUser.
+   *
+   */
+  loginIDPUser(parameters) {
+    var _this15 = this;
+    return _asyncToGenerator(function* () {
+      const codeVerifier = _this15.get('code_verifier');
+      const code = parameters.code;
+      const usid = parameters.usid || _this15.get('usid');
+      const redirectURI = parameters.redirectURI || _this15.redirectURI;
+      const dntPref = _this15.getDnt({
+        includeDefaults: true
+      });
+      const token = yield _commerceSdkIsomorphic.helpers.loginIDPUser(_this15.client, {
+        codeVerifier,
+        clientSecret: _this15.clientSecret
+      }, _objectSpread({
+        redirectURI,
+        code,
+        dnt: dntPref
+      }, usid && {
+        usid
+      }));
+      const isGuest = false;
+      _this15.handleTokenResponse(token, isGuest);
+      // Delete the code verifier once the user has logged in
+      _this15.delete('code_verifier');
+      if ((0, _utils.onClient)()) {
+        void _this15.clearECOMSession();
+      }
+      return token;
+    })();
+  }
+
+  /**
+   * A wrapper method for commerce-sdk-isomorphic helper: authorizePasswordless.
+   */
+  authorizePasswordless(parameters) {
+    var _this16 = this;
+    return _asyncToGenerator(function* () {
+      const userid = parameters.userid;
+      const callbackURI = parameters.callbackURI || _this16.passwordlessLoginCallbackURI;
+      const usid = _this16.get('usid');
+      const mode = callbackURI ? 'callback' : 'sms';
+      const res = yield _commerceSdkIsomorphic.helpers.authorizePasswordless(_this16.client, {
+        clientSecret: _this16.clientSecret
+      }, _objectSpread(_objectSpread(_objectSpread({}, callbackURI && {
+        callbackURI: callbackURI
+      }), usid && {
+        usid
+      }), {}, {
+        userid,
+        mode
+      }));
+      if (res && res.status !== 200) {
+        const errorData = yield res.json();
+        throw new Error(`${res.status} ${String(errorData.message)}`);
+      }
+      return res;
+    })();
+  }
+
+  /**
+   * A wrapper method for commerce-sdk-isomorphic helper: getPasswordLessAccessToken.
+   */
+  getPasswordLessAccessToken(parameters) {
+    var _this17 = this;
+    return _asyncToGenerator(function* () {
+      const pwdlessLoginToken = parameters.pwdlessLoginToken;
+      const dntPref = _this17.getDnt({
+        includeDefaults: true
+      });
+      const token = yield _commerceSdkIsomorphic.helpers.getPasswordLessAccessToken(_this17.client, {
+        clientSecret: _this17.clientSecret
+      }, {
+        pwdlessLoginToken,
+        dnt: dntPref !== undefined ? String(dntPref) : undefined
+      });
+      const isGuest = false;
+      _this17.handleTokenResponse(token, isGuest);
+      if ((0, _utils.onClient)()) {
+        void _this17.clearECOMSession();
+      }
+      return token;
+    })();
+  }
+
+  /**
+   * A wrapper method for the SLAS endpoint: getPasswordResetToken.
+   *
+   */
+  getPasswordResetToken(parameters) {
+    var _this18 = this;
+    return _asyncToGenerator(function* () {
+      const slasClient = _this18.client;
+      const callbackURI = parameters.callback_uri;
+      const options = {
+        headers: {
+          Authorization: ''
+        },
+        body: {
+          user_id: parameters.user_id,
+          mode: 'callback',
+          channel_id: slasClient.clientConfig.parameters.siteId,
+          client_id: slasClient.clientConfig.parameters.clientId,
+          callback_uri: callbackURI,
+          hint: 'cross_device'
+        }
+      };
+
+      // Only set authorization header if using private client
+      if (_this18.clientSecret) {
+        options.headers.Authorization = `Basic ${(0, _utils.stringToBase64)(`${slasClient.clientConfig.parameters.clientId}:${_this18.clientSecret}`)}`;
+      }
+      const res = yield slasClient.getPasswordResetToken(options);
+      return res;
+    })();
+  }
+
+  /**
+   * A wrapper method for the SLAS endpoint: resetPassword.
+   *
+   */
+  resetPassword(parameters) {
+    var _this19 = this;
+    return _asyncToGenerator(function* () {
+      const slasClient = _this19.client;
+      const options = {
+        headers: {
+          Authorization: ''
+        },
+        body: {
+          pwd_action_token: parameters.pwd_action_token,
+          channel_id: slasClient.clientConfig.parameters.siteId,
+          client_id: slasClient.clientConfig.parameters.clientId,
+          new_password: parameters.new_password,
+          user_id: parameters.user_id
+        }
+      };
+
+      // Only set authorization header if using private client
+      if (_this19.clientSecret) {
+        options.headers.Authorization = `Basic ${(0, _utils.stringToBase64)(`${slasClient.clientConfig.parameters.clientId}:${_this19.clientSecret}`)}`;
+      }
+      // TODO: no code verifier needed with the fix blair has made, delete this when the fix has been merged to production
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore
+      const res = yield _this19.client.resetPassword(options);
+      return res;
+    })();
+  }
+
   /**
    * Decode SLAS JWT and extract information such as customer id, usid, etc.
    *
@@ -949,6 +1146,7 @@ class Auth {
     // ISB format
     // 'uido:ecom::upn:Guest||xxxEmailxxx::uidn:FirstName LastName::gcid:xxxGuestCustomerIdxxx::rcid:xxxRegisteredCustomerIdxxx::chid:xxxSiteIdxxx',
     const isbParts = isb.split('::');
+    const uido = isbParts[0].split('uido:')[1];
     const isGuest = isbParts[1] === 'upn:Guest';
     const customerId = isGuest ? isbParts[3].replace('gcid:', '') : isbParts[4].replace('rcid:', '');
     const loginId = isGuest ? 'guest' : isbParts[1].replace('upn:', '');
@@ -965,7 +1163,8 @@ class Auth {
       dnt,
       loginId,
       isAgent,
-      agentId
+      agentId,
+      uido
     };
   }
 }

package/hooks/useAuthHelper.d.ts

@@ -6,10 +6,16 @@ import Auth from '../auth';
  * @enum
  */
 export declare const AuthHelpers: {
+    readonly AuthorizePasswordless: "authorizePasswordless";
+    readonly LoginPasswordlessUser: "getPasswordLessAccessToken";
+    readonly AuthorizeIDP: "authorizeIDP";
+    readonly GetPasswordResetToken: "getPasswordResetToken";
+    readonly LoginIDPUser: "loginIDPUser";
     readonly LoginGuestUser: "loginGuestUser";
     readonly LoginRegisteredUserB2C: "loginRegisteredUserB2C";
     readonly Logout: "logout";
     readonly Register: "register";
+    readonly ResetPassword: "resetPassword";
     readonly UpdateCustomerPassword: "updateCustomerPassword";
 };
 /**
@@ -25,6 +31,8 @@ export type AuthHelper = (typeof AuthHelpers)[keyof typeof AuthHelpers];
  * For more, see https://github.com/SalesforceCommerceCloud/commerce-sdk-isomorphic/#public-client-shopper-login-helpers
  *
  * Avaliable helpers:
+ * - authorizeIDP
+ * - loginIDPUser
  * - loginRegisteredUserB2C
  * - loginGuestUser
  * - logout

package/hooks/useAuthHelper.js

@@ -22,10 +22,16 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  * @enum
  */
 const AuthHelpers = exports.AuthHelpers = {
+  AuthorizePasswordless: 'authorizePasswordless',
+  LoginPasswordlessUser: 'getPasswordLessAccessToken',
+  AuthorizeIDP: 'authorizeIDP',
+  GetPasswordResetToken: 'getPasswordResetToken',
+  LoginIDPUser: 'loginIDPUser',
   LoginGuestUser: 'loginGuestUser',
   LoginRegisteredUserB2C: 'loginRegisteredUserB2C',
   Logout: 'logout',
   Register: 'register',
+  ResetPassword: 'resetPassword',
   UpdateCustomerPassword: 'updateCustomerPassword'
 };
 /**
@@ -47,6 +53,8 @@ const noop = () => ({});
  * For more, see https://github.com/SalesforceCommerceCloud/commerce-sdk-isomorphic/#public-client-shopper-login-helpers
  *
  * Avaliable helpers:
+ * - authorizeIDP
+ * - loginIDPUser
  * - loginRegisteredUserB2C
  * - loginGuestUser
  * - logout

package/hooks/useCustomerType.d.ts

@@ -3,6 +3,7 @@ type useCustomerType = {
     customerType: CustomerType;
     isGuest: boolean;
     isRegistered: boolean;
+    isExternal: boolean;
 };
 /**
  * A hook to return customer auth type.

package/hooks/useCustomerType.js

@@ -44,10 +44,18 @@ const useCustomerType = () => {
   if (customerType !== null && customerType !== 'guest' && customerType !== 'registered') {
     customerType = null;
   }
+
+  // The `uido` is a value within the `isb` claim of the SLAS access token that denotes the IDP origin of the user
+  // If `uido` is not equal to `slas` or `ecom`, the user is considered an external user
+  const uido = onClient ?
+  // eslint-disable-next-line react-hooks/rules-of-hooks
+  (0, _useLocalStorage.default)(`uido_${config.siteId}`) : auth.get('uido');
+  const isExternal = customerType === 'registered' && uido !== 'slas' && uido !== 'ecom';
   return {
     customerType,
     isGuest,
-    isRegistered
+    isRegistered,
+    isExternal
   };
 };
 var _default = exports.default = useCustomerType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/commerce-sdk-react",
-  "version": "3.2.0-preview.0",
+  "version": "3.2.0-preview.1",
   "description": "A library that provides react hooks for fetching data from Commerce Cloud",
   "homepage": "https://github.com/SalesforceCommerceCloud/pwa-kit/tree/develop/packages/ecom-react-hooks#readme",
   "bugs": {
@@ -40,12 +40,12 @@
     "version": "node ./scripts/version.js"
   },
   "dependencies": {
-    "commerce-sdk-isomorphic": "^3.1.1",
+    "commerce-sdk-isomorphic": "^3.2.0",
     "js-cookie": "^3.0.1",
     "jwt-decode": "^4.0.0"
   },
   "devDependencies": {
-    "@salesforce/pwa-kit-dev": "3.9.0-preview.0",
+    "@salesforce/pwa-kit-dev": "3.9.0-preview.1",
     "@tanstack/react-query": "^4.28.0",
     "@testing-library/jest-dom": "^5.16.5",
     "@testing-library/react": "^14.0.0",
@@ -60,7 +60,7 @@
     "@types/react-helmet": "~6.1.6",
     "@types/react-router-dom": "~5.3.3",
     "cross-env": "^5.2.1",
-    "internal-lib-build": "3.9.0-preview.0",
+    "internal-lib-build": "3.9.0-preview.1",
     "jsonwebtoken": "^9.0.0",
     "nock": "^13.3.0",
     "nodemon": "^2.0.22",
@@ -90,5 +90,5 @@
   "publishConfig": {
     "directory": "dist"
   },
-  "gitHead": "f31e6088a7e99fbe8c61d80722433811ed0e998e"
+  "gitHead": "a4afa2da67a0c99f51ac1dfd9f63cd414f342dec"
 }

package/provider.d.ts

@@ -17,6 +17,7 @@ export interface CommerceApiProviderProps extends ApiClientConfigParams {
     silenceWarnings?: boolean;
     logger?: Logger;
     defaultDnt?: boolean;
+    passwordlessLoginCallbackURI?: string;
     refreshTokenRegisteredCookieTTL?: number;
     refreshTokenGuestCookieTTL?: number;
 }

package/provider.js

@@ -97,6 +97,7 @@ const CommerceApiProvider = props => {
     silenceWarnings,
     logger,
     defaultDnt,
+    passwordlessLoginCallbackURI,
     refreshTokenRegisteredCookieTTL,
     refreshTokenGuestCookieTTL
   } = props;
@@ -118,10 +119,11 @@ const CommerceApiProvider = props => {
       silenceWarnings,
       logger: configLogger,
       defaultDnt,
+      passwordlessLoginCallbackURI,
       refreshTokenRegisteredCookieTTL,
       refreshTokenGuestCookieTTL
     });
-  }, [clientId, organizationId, shortCode, siteId, proxy, redirectURI, fetchOptions, fetchedToken, enablePWAKitPrivateClient, clientSecret, silenceWarnings, configLogger, refreshTokenRegisteredCookieTTL, refreshTokenGuestCookieTTL]);
+  }, [clientId, organizationId, shortCode, siteId, proxy, redirectURI, fetchOptions, fetchedToken, enablePWAKitPrivateClient, clientSecret, silenceWarnings, configLogger, defaultDnt, passwordlessLoginCallbackURI, refreshTokenRegisteredCookieTTL, refreshTokenGuestCookieTTL]);
   const dwsid = auth.get(_constant.DWSID_COOKIE_NAME);
   const serverAffinityHeader = {};
   if (dwsid) {
@@ -179,6 +181,7 @@ const CommerceApiProvider = props => {
       silenceWarnings,
       logger: configLogger,
       defaultDnt,
+      passwordlessLoginCallbackURI,
       refreshTokenRegisteredCookieTTL,
       refreshTokenGuestCookieTTL
     }

package/utils.d.ts

@@ -33,4 +33,29 @@ export declare const getDefaultCookieAttributes: () => CookieAttributes;
 export declare function detectLocalStorageAvailable(): boolean;
 /** Determines whether cookies are available by trying to set a test value. */
 export declare function detectCookiesAvailable(options?: CookieAttributes): boolean;
+/**
+ * Determines whether the given URL string is a valid absolute URL.
+ *
+ * Valid absolute URLs:
+ * - https://example.com
+ * - http://example.com
+ *
+ * Invalid or relative URLs:
+ * - http://example
+ * - example.com
+ * - /relative/path
+ *
+ * @param {string} url - The URL string to be checked.
+ * @returns {boolean} - Returns true if the given string is a valid absolute URL, false otherwise.
+ */
+export declare function isAbsoluteUrl(url: string): boolean;
+/**
+ * Provides a platform-specific method for Base64 encoding.
+ *
+ * - In a browser environment (where `window` and `document` are defined),
+ *   the native `btoa` function is used.
+ * - In a non-browser environment (like Node.js), a fallback is provided
+ *   that uses `Buffer` to perform the Base64 encoding.
+ */
+export declare const stringToBase64: typeof btoa;
 //# sourceMappingURL=utils.d.ts.map

package/utils.js

@@ -7,7 +7,9 @@ exports.DEVELOPMENT_ORIGIN = void 0;
 exports.detectCookiesAvailable = detectCookiesAvailable;
 exports.detectInIframe = void 0;
 exports.detectLocalStorageAvailable = detectLocalStorageAvailable;
-exports.onClient = exports.isOriginTrusted = exports.getParentOrigin = exports.getDefaultCookieAttributes = exports.getCookieSameSiteAttribute = void 0;
+exports.getParentOrigin = exports.getDefaultCookieAttributes = exports.getCookieSameSiteAttribute = void 0;
+exports.isAbsoluteUrl = isAbsoluteUrl;
+exports.stringToBase64 = exports.onClient = exports.isOriginTrusted = void 0;
 var _jsCookie = _interopRequireDefault(require("js-cookie"));
 var _constant = require("./constant");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
@@ -123,4 +125,33 @@ function detectCookiesAvailable(options) {
   } catch {
     return false;
   }
-}
+}
+
+/**
+ * Determines whether the given URL string is a valid absolute URL.
+ *
+ * Valid absolute URLs:
+ * - https://example.com
+ * - http://example.com
+ *
+ * Invalid or relative URLs:
+ * - http://example
+ * - example.com
+ * - /relative/path
+ *
+ * @param {string} url - The URL string to be checked.
+ * @returns {boolean} - Returns true if the given string is a valid absolute URL, false otherwise.
+ */
+function isAbsoluteUrl(url) {
+  return /^(https?:\/\/)/i.test(url);
+}
+
+/**
+ * Provides a platform-specific method for Base64 encoding.
+ *
+ * - In a browser environment (where `window` and `document` are defined),
+ *   the native `btoa` function is used.
+ * - In a non-browser environment (like Node.js), a fallback is provided
+ *   that uses `Buffer` to perform the Base64 encoding.
+ */
+const stringToBase64 = exports.stringToBase64 = typeof window === 'object' && typeof window.document === 'object' ? btoa : unencoded => Buffer.from(unencoded).toString('base64');