@esri/arcgis-rest-basemap-sessions 1.0.0

package/dist/bundled/basemap-sessions.umd.js

@@ -0,0 +1,376 @@
+/* @preserve
+* @esri/arcgis-rest-basemap-sessions - v1.0.0 - Apache-2.0
+* Copyright (c) 2017-2025 Esri, Inc.
+* Wed Jul 30 2025 12:24:38 GMT-0700 (Pacific Daylight Time)
+*/
+(function (global, factory) {
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@esri/arcgis-rest-request')) :
+  typeof define === 'function' && define.amd ? define(['exports', '@esri/arcgis-rest-request'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.arcgisRest = global.arcgisRest || {}, global.arcgisRest));
+})(this, (function (exports, arcgisRestRequest) { 'use strict';
+
+  function mitt(n){return {all:n=n||new Map,on:function(t,e){var i=n.get(t);i?i.push(e):n.set(t,[e]);},off:function(t,e){var i=n.get(t);i&&(e?i.splice(i.indexOf(e)>>>0,1):n.set(t,[]));},emit:function(t,e){var i=n.get(t);i&&i.slice().map(function(n){n(e);}),(i=n.get("*"))&&i.slice().map(function(n){n(t,e);});}}}
+
+  const DEFAULT_START_BASEMAP_STYLE_SESSION_URL = "https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/sessions/start";
+  const DEFAULT_SAFETY_MARGIN = 5 * 60; // Default to 5 minutes in seconds
+  const DEFAULT_CHECK_EXPIRATION_INTERVAL = 10; // Default to 10 seconds
+  const DEFAULT_DURATION = 12 * 60 * 60; // Default to 12 hours in seconds
+
+  function startNewSession({ startSessionUrl, authentication, styleFamily = "arcgis", duration = DEFAULT_DURATION }) {
+      return arcgisRestRequest.request(startSessionUrl, {
+          httpMethod: "GET",
+          authentication: authentication,
+          params: { styleFamily, durationSeconds: duration }
+      });
+  }
+
+  function determineSafetyMargin(duration, safetyMargin) {
+      if (safetyMargin) {
+          return safetyMargin;
+      }
+      // common cases are
+      // duration is 60 seconds, this will return a 1 second safety margin
+      // duration is 43200 seconds, this will return a 300 second (5 minutes) safety margin
+      return Math.min(Math.max(duration / 100, 1), DEFAULT_SAFETY_MARGIN);
+  }
+
+  /**
+   * The base class for all basemap sessions. This class implements the {@linkcode IAuthenticationManager} interface and provides methods to start, refresh, and check the expiration of a session.
+   * This is not intendet to be used directly, but instead is extended by other classes such as {@linkcode BasemapStyleSession} and {@linkcode StaticBasemapTilesSession}.
+   *
+   * @abstract
+   * @implements {IAuthenticationManager}
+   */
+  class BaseSession {
+      /**
+       * Creates a new instance of the BaseSession class. Generally you should not create an instance of this class directly, but instead use the static methods to start a session or deserialize a session.
+       *
+       * You may need to create an instance of this class directly if you are  not using the built in deserialize method.
+       *
+       * @param params - The parameters for the session.
+       * @param params.startSessionUrl - The URL to start the session.
+       * @param params.token - The token for the session.
+       * @param params.styleFamily - The style family of the session.
+       * @param params.authentication - The authentication manager or token used for the session.
+       * @param params.expires - The expiration date of the session.
+       * @param params.startTime - The start time of the session.
+       * @param params.endTime - The end time of the session.
+       * @param params.safetyMargin - The safety margin in milliseconds.
+       * @param params.duration - Indicates if this is a test session.
+       */
+      constructor(params) {
+          /**
+           * The ID of the timer used to check the expiration time of the session.
+           */
+          this.expirationTimerId = null;
+          /**
+           * A handler that is used to automatically refresh the session when it expires.
+           */
+          this.autoRefreshHandler = null;
+          this.startSessionUrl = params.startSessionUrl;
+          this.token = params.token;
+          this.styleFamily = params.styleFamily || "arcgis";
+          this.authentication = params.authentication;
+          this.duration = params.duration || DEFAULT_DURATION;
+          this.startTime = params.startTime;
+          this.endTime = params.endTime;
+          this.expires = params.expires;
+          this.safetyMargin = params.safetyMargin;
+          this.expirationCheckInterval =
+              Math.min(this.duration / 100, DEFAULT_CHECK_EXPIRATION_INTERVAL) * 1000;
+          this.emitter = mitt();
+      }
+      /**
+       * Checks if the session is expired. If it is expired, it emits an "expired" event. The event will fire **before** the method returns true.
+       *
+       * @returns {boolean} - Returns true if the session is expired, otherwise false.
+       */
+      isSessionExpired() {
+          if (this.isExpired) {
+              this.emitter.emit("expired", {
+                  token: this.token,
+                  startTime: this.startTime,
+                  endTime: this.endTime,
+                  expires: this.expires
+              });
+          }
+          return this.isExpired;
+      }
+      /**
+       * Starts checking the expiration time of the session. This will check the expiration time immediately and then on an interval.
+       * If the session is expired, it will emit an "expired" event.
+       */
+      startCheckingExpirationTime() {
+          const check = () => {
+              this.isSessionExpired();
+          };
+          if (!this.expirationTimerId) {
+              this.expirationTimerId = setInterval(check, 
+              // check every 10 seconds or 1/100th of the duration, whichever is smaller
+              this.expirationCheckInterval); // check immediatly then on an interval
+          }
+          setTimeout(() => {
+              check(); // check immediately after starting the interval
+          }, 10);
+          return this.expirationTimerId; // return the timer ID so it can be stopped later
+      }
+      /**
+       * Stops checking the expiration time of the session. This will clear the interval that was set by {@linkcode BaseSession.startCheckingExpirationTime}.
+       */
+      stopCheckingExpirationTime() {
+          if (this.expirationTimerId) {
+              clearInterval(this.expirationTimerId);
+              this.expirationTimerId = null;
+          }
+      }
+      /**
+       * Indicates if the session is currently checking for expiration time.
+       *
+       * @returns {boolean} - Returns true if the session is checking for expiration time, otherwise false.
+       */
+      get checkingExpirationTime() {
+          return !!this.expirationTimerId;
+      }
+      /**
+       * Starts a new session using the provided parameters and returns an instance of the session class.
+       *
+       * @param params - The parameters for starting the session.
+       * @param SessionClass - The class to use for the session.
+       * @returns A promise that resolves to an instance of the session class.
+       */
+      static async startSession({ startSessionUrl, styleFamily = "arcgis", authentication, safetyMargin, duration = DEFAULT_DURATION, autoRefresh = true }, SessionClass) {
+          const sessionResponse = await startNewSession({
+              startSessionUrl,
+              styleFamily,
+              authentication,
+              duration
+          });
+          const actualSafetyMargin = determineSafetyMargin(duration, safetyMargin);
+          const session = new SessionClass({
+              startSessionUrl: startSessionUrl,
+              token: sessionResponse.sessionToken,
+              styleFamily,
+              authentication,
+              safetyMargin: actualSafetyMargin,
+              expires: new Date(sessionResponse.endTime - actualSafetyMargin * 1000),
+              startTime: new Date(sessionResponse.startTime),
+              endTime: new Date(sessionResponse.endTime),
+              duration
+          });
+          session.startCheckingExpirationTime();
+          if (autoRefresh) {
+              session.startAutoRefresh();
+          }
+          return session;
+      }
+      /**
+       * Checks if the session is expired.
+       *
+       */
+      get isExpired() {
+          return this.expires < new Date();
+      }
+      /**
+       * Gets the session token. If the session is expired, it will refresh the credentials and return the new token.
+       *
+       * @returns A promise that resolves to the session token.
+       */
+      getToken() {
+          if (this.isExpired) {
+              return this.refreshCredentials().then(() => this.token);
+          }
+          return Promise.resolve(this.token);
+      }
+      /**
+       * Indicates if the session can be refreshed. This is always true for this class.
+       *
+       * @returns {boolean} - Always returns true.
+       */
+      get canRefresh() {
+          return true;
+      }
+      /**
+       * Indicates if the session is set to automatically refresh when it expires.
+       *
+       * @returns {boolean} - Returns true if auto-refresh is enabled, otherwise false.
+       */
+      get autoRefresh() {
+          return !!this.autoRefreshHandler && !!this.expirationTimerId;
+      }
+      /**
+       * Refreshes the session credentials by starting a new session.
+       * This will emit a "refreshed" event with the previous and current session details.
+       *
+       * @returns A promise that resolves to the current instance of the session.
+       */
+      async refreshCredentials() {
+          // @TODO switch this to structured clone when we upgrade to Node 20+ types so we don't have to parse the dates later
+          const previous = JSON.parse(JSON.stringify({
+              token: this.token,
+              startTime: this.startTime,
+              endTime: this.endTime,
+              expires: this.expires
+          }));
+          try {
+              const newSession = await startNewSession({
+                  startSessionUrl: this.startSessionUrl,
+                  styleFamily: this.styleFamily,
+                  authentication: this.authentication,
+                  duration: this.duration
+              });
+              this.setToken(newSession.sessionToken);
+              this.setStartTime(new Date(newSession.startTime));
+              this.setEndTime(new Date(newSession.endTime));
+              this.setExpires(new Date(newSession.endTime - this.safetyMargin * 1000));
+              this.emitter.emit("refreshed", {
+                  previous: {
+                      token: previous.token,
+                      startTime: new Date(previous.startTime),
+                      endTime: new Date(previous.endTime),
+                      expires: new Date(previous.expires)
+                  },
+                  current: {
+                      token: this.token,
+                      startTime: this.startTime,
+                      endTime: this.endTime,
+                      expires: this.expires
+                  }
+              });
+          }
+          catch (error) {
+              this.emitter.emit("error", error);
+              throw error;
+          }
+          return this;
+      }
+      /**
+       * Enables auto-refresh for the session. This will automatically refresh the session when it expires.
+       * It will also start checking the expiration time of the session if it is not already started via {@linkcode BaseSession.startCheckingExpirationTime}.
+       */
+      startAutoRefresh() {
+          if (!this.expirationTimerId) {
+              this.startCheckingExpirationTime();
+          }
+          this.autoRefreshHandler = () => {
+              this.refreshCredentials().catch((error) => {
+                  this.emitter.emit("error", error);
+              });
+          };
+          this.on("expired", this.autoRefreshHandler);
+      }
+      /**
+       * Disables auto-refresh for the session. This will stop automatically refreshing the session when it expires.
+       * This will  **not** stop checking the expiration time of the session. If you want to stop automated expiration
+       * checking, call {@linkcode BaseSession.stopCheckingExpirationTime} after calling this method.
+       */
+      stopAutoRefresh() {
+          if (this.autoRefreshHandler) {
+              this.off("expired", this.autoRefreshHandler);
+              this.autoRefreshHandler = null;
+          }
+      }
+      on(eventName, handler) {
+          this.emitter.on(eventName, handler);
+          this.isSessionExpired(); // check if the session is expired immediately after adding the handler
+      }
+      once(eventName, handler) {
+          const fn = (e) => {
+              this.emitter.off(eventName, fn);
+              handler(e);
+          };
+          this.emitter.on(eventName, fn);
+      }
+      off(eventName, handler) {
+          this.emitter.off(eventName, handler);
+      }
+      /**
+       * These private methods are used to set the internal state of the session.
+       */
+      setToken(token) {
+          this.token = token;
+      }
+      setStartTime(startTime) {
+          this.startTime = startTime;
+      }
+      setEndTime(endTime) {
+          this.endTime = endTime;
+      }
+      setExpires(expires) {
+          this.expires = expires;
+      }
+  }
+  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.
+  /* istanbul ignore next -- @preserve */
+  /**
+   * Event handler for when an error occurs during session management.
+   */
+  BaseSession.error = function error(e) { }; // eslint-disable-line @typescript-eslint/no-empty-function
+  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.
+  /* istanbul ignore next -- @preserve */
+  /**
+   * Event handler for when a session expires and the `token` it no longer valid.
+   *
+   * @event expired
+   * @param e - The parameters for the expired event.
+   * @param e.token - The session token that expired.
+   * @param e.startTime - The start time of the session.
+   * @param e.endTime - The end time of the session.
+   * @param e.expires - The expiration time of the session.
+   */
+  BaseSession.expired = function expired(e) { }; // eslint-disable-line @typescript-eslint/no-empty-function
+  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.
+  /* istanbul ignore next -- @preserve */
+  /**
+   * Event handler for when a session refreshes and a new `token` is available.
+   *
+   * @event refreshed
+   * @param e. - The parameters for the refreshed event.
+   * @param e.previous - The previous session details.
+   * @param e.previous.token - The previous session token.
+   * @param e.previous.startTime - The start time of the previous session.
+   * @param e.previous.endTime - The end time of the previous session.
+   * @param e.previous.expires - The expiration time of the previous session.
+   * @param e.current - The current session details.
+   * @param e.current.token - The current session token.
+   * @param e.current.startTime - The start time of the current token.
+   * @param e.current.endTime - The end time of the current session.
+   * @param e.current.expires - The expiration time of the current token.
+   */
+  BaseSession.refreshed = function refreshed(e) { }; // eslint-disable-line @typescript-eslint/no-empty-function
+
+  /**
+   * `BasemapStyleSession` is a class that extends {@linkcode BaseSession} to manage sessions
+   * for basemap styles. It provides methods to {@linkcode BasemapStyleSession.start} a new session
+   * which should be used instead of constructing a new instance directly.
+   *
+   * @class BasemapStyleSession
+   * @extends BaseSession
+   */
+  class BasemapStyleSession extends BaseSession {
+      /**
+       * Creates an instance of `BasemapStyleSession`. Constructing `BasemapStyleSession` directly is discouraged.
+       * Instead, use the static method {@linkcode BasemapStyleSession.start} to start a new session.
+       */
+      constructor(params) {
+          super(params);
+      }
+      /**
+       * Starts a new basemap style session.
+       */
+      static async start(params) {
+          return BaseSession.startSession(Object.assign(Object.assign({}, params), { startSessionUrl: (params === null || params === void 0 ? void 0 : params.startSessionUrl) || DEFAULT_START_BASEMAP_STYLE_SESSION_URL }), BasemapStyleSession);
+      }
+  }
+
+  exports.BaseSession = BaseSession;
+  exports.BasemapStyleSession = BasemapStyleSession;
+  exports.DEFAULT_CHECK_EXPIRATION_INTERVAL = DEFAULT_CHECK_EXPIRATION_INTERVAL;
+  exports.DEFAULT_DURATION = DEFAULT_DURATION;
+  exports.DEFAULT_SAFETY_MARGIN = DEFAULT_SAFETY_MARGIN;
+  exports.DEFAULT_START_BASEMAP_STYLE_SESSION_URL = DEFAULT_START_BASEMAP_STYLE_SESSION_URL;
+  exports.startNewSession = startNewSession;
+
+  Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+//# sourceMappingURL=basemap-sessions.umd.js.map

package/dist/bundled/basemap-sessions.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basemap-sessions.umd.js","sources":["../../node_modules/mitt/dist/mitt.mjs","../../src/utils/defaults.ts","../../src/utils/startNewSession.ts","../../src/utils/detemineSafetyMargin.ts","../../src/BaseSession.ts","../../src/BasemapStyleSession.ts"],"sourcesContent":["export default function(n){return{all:n=n||new Map,on:function(t,e){var i=n.get(t);i?i.push(e):n.set(t,[e])},off:function(t,e){var i=n.get(t);i&&(e?i.splice(i.indexOf(e)>>>0,1):n.set(t,[]))},emit:function(t,e){var i=n.get(t);i&&i.slice().map(function(n){n(e)}),(i=n.get(\"*\"))&&i.slice().map(function(n){n(t,e)})}}}\n//# sourceMappingURL=mitt.mjs.map\n","export const DEFAULT_START_BASEMAP_STYLE_SESSION_URL =\n  \"https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/sessions/start\";\n\nexport const DEFAULT_SAFETY_MARGIN = 5 * 60; // Default to 5 minutes in seconds\n\nexport const DEFAULT_CHECK_EXPIRATION_INTERVAL = 10; // Default to 10 seconds\n\nexport const DEFAULT_DURATION = 12 * 60 * 60; // Default to 12 hours in seconds\n","import { IAuthenticationManager, request } from \"@esri/arcgis-rest-request\";\nimport { StyleFamily } from \"../types/StyleFamily.js\";\nimport { DEFAULT_DURATION } from \"./defaults.js\";\n\nexport interface IRequestNewSessionParams {\n  startSessionUrl: string;\n  authentication: IAuthenticationManager | string;\n  styleFamily?: StyleFamily;\n  duration?: number;\n}\n\nexport interface IStartSessionResponse {\n  sessionToken: string;\n  endTime: number;\n  startTime: number;\n  styleFamily: StyleFamily;\n}\n\nexport function startNewSession({\n  startSessionUrl,\n  authentication,\n  styleFamily = \"arcgis\",\n  duration = DEFAULT_DURATION\n}: IRequestNewSessionParams): Promise<IStartSessionResponse> {\n  return request(startSessionUrl, {\n    httpMethod: \"GET\",\n    authentication: authentication,\n    params: { styleFamily, durationSeconds: duration }\n  });\n}\n","import { DEFAULT_SAFETY_MARGIN } from \"./defaults.js\";\n\nexport function determineSafetyMargin(\n  duration: number | undefined,\n  safetyMargin: number | undefined\n): number {\n  if (safetyMargin) {\n    return safetyMargin;\n  }\n  // common cases are\n  // duration is 60 seconds, this will return a 1 second safety margin\n  // duration is 43200 seconds, this will return a 300 second (5 minutes) safety margin\n  return Math.min(Math.max(duration / 100, 1), DEFAULT_SAFETY_MARGIN);\n}\n","import mitt from \"mitt\";\n\nimport { IAuthenticationManager } from \"@esri/arcgis-rest-request\";\nimport { StyleFamily } from \"./types/StyleFamily.js\";\nimport { startNewSession } from \"./utils/startNewSession.js\";\nimport { Writable } from \"./utils/writable.js\";\nimport { determineSafetyMargin } from \"./utils/detemineSafetyMargin.js\";\nimport {\n  DEFAULT_DURATION,\n  DEFAULT_SAFETY_MARGIN,\n  DEFAULT_CHECK_EXPIRATION_INTERVAL\n} from \"./utils/defaults.js\";\n\nexport interface IBasemapSessionParams {\n  token: string;\n  startSessionUrl: string;\n  styleFamily: StyleFamily;\n  authentication: IAuthenticationManager | string;\n  expires: Date;\n  startTime: Date;\n  endTime: Date;\n  safetyMargin?: number;\n  duration?: number;\n  autoRefresh?: boolean;\n}\n\nexport interface IStartSessionParams {\n  styleFamily?: StyleFamily;\n  authentication: IAuthenticationManager | string;\n  safetyMargin?: number;\n  duration?: number;\n  autoRefresh?: boolean;\n\n  /**\n   * The URL to start the session. If not provided, it will use the default URL.\n   * @private\n   */\n  startSessionUrl?: string;\n}\n\n/**\n * The base class for all basemap sessions. This class implements the {@linkcode IAuthenticationManager} interface and provides methods to start, refresh, and check the expiration of a session.\n * This is not intendet to be used directly, but instead is extended by other classes such as {@linkcode BasemapStyleSession} and {@linkcode StaticBasemapTilesSession}.\n *\n * @abstract\n * @implements {IAuthenticationManager}\n */\nexport abstract class BaseSession implements IAuthenticationManager {\n  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.\n  /* istanbul ignore next -- @preserve */\n  /**\n   * Event handler for when an error occurs during session management.\n   */\n  static readonly error = function error(e: Error): void {}; // eslint-disable-line @typescript-eslint/no-empty-function\n\n  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.\n  /* istanbul ignore next -- @preserve */\n  /**\n   * Event handler for when a session expires and the `token` it no longer valid.\n   *\n   * @event expired\n   * @param e - The parameters for the expired event.\n   * @param e.token - The session token that expired.\n   * @param e.startTime - The start time of the session.\n   * @param e.endTime - The end time of the session.\n   * @param e.expires - The expiration time of the session.\n   */\n  static readonly expired = function expired(e: {\n    token: string;\n    startTime: Date;\n    endTime: Date;\n    expires: Date;\n  }): void {}; // eslint-disable-line @typescript-eslint/no-empty-function\n\n  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.\n  /* istanbul ignore next -- @preserve */\n  /**\n   * Event handler for when a session refreshes and a new `token` is available.\n   *\n   * @event refreshed\n   * @param e. - The parameters for the refreshed event.\n   * @param e.previous - The previous session details.\n   * @param e.previous.token - The previous session token.\n   * @param e.previous.startTime - The start time of the previous session.\n   * @param e.previous.endTime - The end time of the previous session.\n   * @param e.previous.expires - The expiration time of the previous session.\n   * @param e.current - The current session details.\n   * @param e.current.token - The current session token.\n   * @param e.current.startTime - The start time of the current token.\n   * @param e.current.endTime - The end time of the current session.\n   * @param e.current.expires - The expiration time of the current token.\n   */\n  static readonly refreshed = function refreshed(e: {\n    previous: {\n      token: string;\n      startTime: Date;\n      endTime: Date;\n      expires: Date;\n    };\n    current: {\n      token: string;\n      startTime: Date;\n      endTime: Date;\n      expires: Date;\n    };\n  }): void {}; // eslint-disable-line @typescript-eslint/no-empty-function\n\n  /**\n   * The portal URL that the session is associated with. This generally is not used but exists to implement the `IAuthenticationManager` interface.\n   */\n  readonly portal: string;\n\n  /**\n   * The style family of the session. This is used to determine the type of basemap styles that are available.\n   */\n  readonly styleFamily: StyleFamily;\n\n  /**\n   * The authentication manager or token used for the session.\n   * This can be an instance of {@linkcode ApiKeyManager}, {@linkcode ArcGISIdentityManager}, {@linkcode ApplicationCredentialsManager} or a string token.\n   */\n  readonly authentication: IAuthenticationManager | string;\n\n  /**\n   * The expiration date of the session. This is the {@linkcode BaseSession.endTime} minus the {@linkcode BaseSession.safetyMargin}. This is used internally to determine if the session is expired.\n   */\n  readonly expires: Date;\n\n  /**\n   * The start time of the session. This is the time returned from the API when the session war started.\n   */\n  readonly startTime: Date;\n\n  /**\n   * The end time of the session. This is the time returned from the API when the session will end.\n   */\n  readonly endTime: Date;\n\n  /**\n   * The token for the session.\n   */\n  readonly token: string;\n\n  /**\n   * The URL used to start the session.\n   */\n  readonly startSessionUrl: string;\n\n  /**\n   * The safety margin in milliseconds. This subtracted from the {@linkcode BaseSession.endTime} to get the {@linkcode BaseSession.expiration}.\n   */\n  readonly safetyMargin: number;\n\n  /**\n   * The duration of the session in seconds. This is used to determine how long the session will last when the session is refreshed.\n   */\n  readonly duration: number;\n\n  /**\n   * The interval at which to check the expiration time of the session. This is always 10 seconds or 1/100th of the duration, whichever is smaller.\n   */\n  readonly expirationCheckInterval: number;\n\n  /**\n   * The ID of the timer used to check the expiration time of the session.\n   */\n  private expirationTimerId: any = null;\n\n  /**\n   * Internal instance of [`mitt`](https://github.com/developit/mitt) used for event handlers. It is recommended to use {@linkcode BasemapSession.on}, {@linkcode BasemapSession.off} or {@linkcode BasemapSession.once} instead of `emitter.`\n   */\n  private emitter: any;\n\n  /**\n   * A handler that is used to automatically refresh the session when it expires.\n   */\n  private autoRefreshHandler: (() => void) | null = null;\n\n  /**\n   * Creates a new instance of the BaseSession class. Generally you should not create an instance of this class directly, but instead use the static methods to start a session or deserialize a session.\n   *\n   * You may need to create an instance of this class directly if you are  not using the built in deserialize method.\n   *\n   * @param params - The parameters for the session.\n   * @param params.startSessionUrl - The URL to start the session.\n   * @param params.token - The token for the session.\n   * @param params.styleFamily - The style family of the session.\n   * @param params.authentication - The authentication manager or token used for the session.\n   * @param params.expires - The expiration date of the session.\n   * @param params.startTime - The start time of the session.\n   * @param params.endTime - The end time of the session.\n   * @param params.safetyMargin - The safety margin in milliseconds.\n   * @param params.duration - Indicates if this is a test session.\n   */\n  constructor(params: IBasemapSessionParams) {\n    this.startSessionUrl = params.startSessionUrl;\n    this.token = params.token;\n    this.styleFamily = params.styleFamily || \"arcgis\";\n    this.authentication = params.authentication;\n    this.duration = params.duration || DEFAULT_DURATION;\n    this.startTime = params.startTime;\n    this.endTime = params.endTime;\n    this.expires = params.expires;\n    this.safetyMargin = params.safetyMargin;\n    this.expirationCheckInterval =\n      Math.min(this.duration / 100, DEFAULT_CHECK_EXPIRATION_INTERVAL) * 1000;\n    this.emitter = mitt();\n  }\n\n  /**\n   * Checks if the session is expired. If it is expired, it emits an \"expired\" event. The event will fire **before** the method returns true.\n   *\n   * @returns {boolean} - Returns true if the session is expired, otherwise false.\n   */\n  isSessionExpired() {\n    if (this.isExpired) {\n      this.emitter.emit(\"expired\", {\n        token: this.token,\n        startTime: this.startTime,\n        endTime: this.endTime,\n        expires: this.expires\n      });\n    }\n    return this.isExpired;\n  }\n\n  /**\n   * Starts checking the expiration time of the session. This will check the expiration time immediately and then on an interval.\n   * If the session is expired, it will emit an \"expired\" event.\n   */\n  startCheckingExpirationTime() {\n    const check = () => {\n      this.isSessionExpired();\n    };\n\n    if (!this.expirationTimerId) {\n      this.expirationTimerId = setInterval(\n        check,\n        // check every 10 seconds or 1/100th of the duration, whichever is smaller\n        this.expirationCheckInterval\n      ); // check immediatly then on an interval\n    }\n\n    setTimeout(() => {\n      check(); // check immediately after starting the interval\n    }, 10);\n\n    return this.expirationTimerId; // return the timer ID so it can be stopped later\n  }\n\n  /**\n   * Stops checking the expiration time of the session. This will clear the interval that was set by {@linkcode BaseSession.startCheckingExpirationTime}.\n   */\n  stopCheckingExpirationTime() {\n    if (this.expirationTimerId) {\n      clearInterval(this.expirationTimerId);\n      this.expirationTimerId = null;\n    }\n  }\n\n  /**\n   * Indicates if the session is currently checking for expiration time.\n   *\n   * @returns {boolean} - Returns true if the session is checking for expiration time, otherwise false.\n   */\n  get checkingExpirationTime(): boolean {\n    return !!this.expirationTimerId;\n  }\n\n  /**\n   * Starts a new session using the provided parameters and returns an instance of the session class.\n   *\n   * @param params - The parameters for starting the session.\n   * @param SessionClass - The class to use for the session.\n   * @returns A promise that resolves to an instance of the session class.\n   */\n  protected static async startSession<T extends BaseSession>(\n    {\n      startSessionUrl,\n      styleFamily = \"arcgis\",\n      authentication,\n      safetyMargin,\n      duration = DEFAULT_DURATION,\n      autoRefresh = true\n    }: {\n      startSessionUrl?: string;\n      styleFamily?: StyleFamily;\n      authentication: IAuthenticationManager | string;\n      safetyMargin?: number;\n      duration?: number;\n      autoRefresh?: boolean;\n    },\n    SessionClass: new (params: IBasemapSessionParams) => T\n  ): Promise<T> {\n    const sessionResponse = await startNewSession({\n      startSessionUrl,\n      styleFamily,\n      authentication,\n      duration\n    });\n    const actualSafetyMargin = determineSafetyMargin(duration, safetyMargin);\n\n    const session = new SessionClass({\n      startSessionUrl: startSessionUrl,\n      token: sessionResponse.sessionToken,\n      styleFamily,\n      authentication,\n      safetyMargin: actualSafetyMargin,\n      expires: new Date(sessionResponse.endTime - actualSafetyMargin * 1000),\n      startTime: new Date(sessionResponse.startTime),\n      endTime: new Date(sessionResponse.endTime),\n      duration\n    });\n\n    session.startCheckingExpirationTime();\n\n    if (autoRefresh) {\n      session.startAutoRefresh();\n    }\n\n    return session as T;\n  }\n\n  /**\n   * Checks if the session is expired.\n   *\n   */\n  get isExpired(): boolean {\n    return this.expires < new Date();\n  }\n\n  /**\n   * Gets the session token. If the session is expired, it will refresh the credentials and return the new token.\n   *\n   * @returns A promise that resolves to the session token.\n   */\n  getToken(): Promise<string> {\n    if (this.isExpired) {\n      return this.refreshCredentials().then(() => this.token);\n    }\n\n    return Promise.resolve(this.token);\n  }\n\n  /**\n   * Indicates if the session can be refreshed. This is always true for this class.\n   *\n   * @returns {boolean} - Always returns true.\n   */\n  get canRefresh(): boolean {\n    return true;\n  }\n\n  /**\n   * Indicates if the session is set to automatically refresh when it expires.\n   *\n   * @returns {boolean} - Returns true if auto-refresh is enabled, otherwise false.\n   */\n  get autoRefresh(): boolean {\n    return !!this.autoRefreshHandler && !!this.expirationTimerId;\n  }\n\n  /**\n   * Refreshes the session credentials by starting a new session.\n   * This will emit a \"refreshed\" event with the previous and current session details.\n   *\n   * @returns A promise that resolves to the current instance of the session.\n   */\n  async refreshCredentials(): Promise<this> {\n    // @TODO switch this to structured clone when we upgrade to Node 20+ types so we don't have to parse the dates later\n    const previous = JSON.parse(\n      JSON.stringify({\n        token: this.token,\n        startTime: this.startTime,\n        endTime: this.endTime,\n        expires: this.expires\n      })\n    );\n\n    try {\n      const newSession = await startNewSession({\n        startSessionUrl: this.startSessionUrl,\n        styleFamily: this.styleFamily,\n        authentication: this.authentication,\n        duration: this.duration\n      });\n\n      this.setToken(newSession.sessionToken);\n      this.setStartTime(new Date(newSession.startTime));\n      this.setEndTime(new Date(newSession.endTime));\n      this.setExpires(new Date(newSession.endTime - this.safetyMargin * 1000));\n\n      this.emitter.emit(\"refreshed\", {\n        previous: {\n          token: previous.token,\n          startTime: new Date(previous.startTime),\n          endTime: new Date(previous.endTime),\n          expires: new Date(previous.expires)\n        },\n        current: {\n          token: this.token,\n          startTime: this.startTime,\n          endTime: this.endTime,\n          expires: this.expires\n        }\n      });\n    } catch (error) {\n      this.emitter.emit(\"error\", error);\n      throw error;\n    }\n\n    return this;\n  }\n  /**\n   * Enables auto-refresh for the session. This will automatically refresh the session when it expires.\n   * It will also start checking the expiration time of the session if it is not already started via {@linkcode BaseSession.startCheckingExpirationTime}.\n   */\n  startAutoRefresh() {\n    if (!this.expirationTimerId) {\n      this.startCheckingExpirationTime();\n    }\n\n    this.autoRefreshHandler = () => {\n      this.refreshCredentials().catch((error: Error) => {\n        this.emitter.emit(\"error\", error);\n      });\n    };\n\n    this.on(\"expired\", this.autoRefreshHandler);\n  }\n\n  /**\n   * Disables auto-refresh for the session. This will stop automatically refreshing the session when it expires.\n   * This will  **not** stop checking the expiration time of the session. If you want to stop automated expiration\n   * checking, call {@linkcode BaseSession.stopCheckingExpirationTime} after calling this method.\n   */\n  stopAutoRefresh() {\n    if (this.autoRefreshHandler) {\n      this.off(\"expired\", this.autoRefreshHandler);\n      this.autoRefreshHandler = null;\n    }\n  }\n\n  /**\n   * A handler that listens for an eventName and returns custom handler.\n   *\n   * @param eventName A string of what event to listen for.\n   * @param handler A function of what to do when eventName was called.\n   */\n  on(event: \"refreshed\", handler: typeof BaseSession.refreshed): void;\n  on(event: \"expired\", handler: typeof BaseSession.expired): void;\n  on(event: \"error\", handler: typeof BaseSession.error): void;\n  on(\n    eventName: string,\n    handler:\n      | typeof BaseSession.refreshed\n      | typeof BaseSession.expired\n      | typeof BaseSession.error\n  ) {\n    this.emitter.on(eventName, handler);\n    this.isSessionExpired(); // check if the session is expired immediately after adding the handler\n  }\n\n  /**\n   * A handler that listens for an event once and returns a custom handler. Events listened to with this method cannot be removed with {@linkcode BasemapSession.off}.\n   *\n   * @param eventName A string of what event to listen for.\n   * @param handler A function of what to do when eventName was called.\n   */\n  once(event: \"refreshed\", handler: typeof BaseSession.refreshed): void;\n  once(event: \"expired\", handler: typeof BaseSession.expired): void;\n  once(event: \"error\", handler: typeof BaseSession.error): void;\n  once(\n    eventName: string,\n    handler:\n      | typeof BaseSession.refreshed\n      | typeof BaseSession.expired\n      | typeof BaseSession.error\n  ) {\n    const fn = (e: any) => {\n      this.emitter.off(eventName, fn);\n      handler(e);\n    };\n\n    this.emitter.on(eventName, fn);\n  }\n\n  /**\n   * A handler that will remove a listener from a given event.\n   *\n   * @param eventName A string of what event to listen for.\n   * @param handler A function of what to do when eventName was called.\n   */\n  off(event: \"refreshed\", handler: typeof BaseSession.refreshed): void;\n  off(event: \"expired\", handler: typeof BaseSession.expired): void;\n  off(event: \"error\", handler: typeof BaseSession.error): void;\n  off(\n    eventName: string,\n    handler:\n      | typeof BaseSession.refreshed\n      | typeof BaseSession.expired\n      | typeof BaseSession.error\n  ) {\n    this.emitter.off(eventName, handler);\n  }\n\n  /**\n   * These private methods are used to set the internal state of the session.\n   */\n  private setToken(token: string) {\n    (this as Writable<typeof this>).token = token;\n  }\n  private setStartTime(startTime: Date) {\n    (this as Writable<typeof this>).startTime = startTime;\n  }\n  private setEndTime(endTime: Date) {\n    (this as Writable<typeof this>).endTime = endTime;\n  }\n  private setExpires(expires: Date) {\n    (this as Writable<typeof this>).expires = expires;\n  }\n}\n","import {\n  BaseSession,\n  IBasemapSessionParams,\n  IStartSessionParams\n} from \"./BaseSession.js\";\nimport { DEFAULT_START_BASEMAP_STYLE_SESSION_URL } from \"./utils/defaults.js\";\n\n/**\n * `BasemapStyleSession` is a class that extends {@linkcode BaseSession} to manage sessions\n * for basemap styles. It provides methods to {@linkcode BasemapStyleSession.start} a new session\n * which should be used instead of constructing a new instance directly.\n *\n * @class BasemapStyleSession\n * @extends BaseSession\n */\nexport class BasemapStyleSession extends BaseSession {\n  /**\n   * Creates an instance of `BasemapStyleSession`. Constructing `BasemapStyleSession` directly is discouraged.\n   * Instead, use the static method {@linkcode BasemapStyleSession.start} to start a new session.\n   */\n  constructor(params: IBasemapSessionParams) {\n    super(params);\n  }\n\n  /**\n   * Starts a new basemap style session.\n   */\n  static async start(params: IStartSessionParams) {\n    return BaseSession.startSession<BasemapStyleSession>(\n      {\n        ...params,\n        startSessionUrl:\n          params?.startSessionUrl || DEFAULT_START_BASEMAP_STYLE_SESSION_URL\n      },\n      BasemapStyleSession as new (\n        params: IBasemapSessionParams\n      ) => BasemapStyleSession\n    );\n  }\n}\n"],"names":["request"],"mappings":";;;;;;;;;;;EAAe,aAAQ,CAAC,CAAC,CAAC,CAAC,OAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC;;QCA5S,uCAAuC,GAClD,qFAAqF;QAE1E,qBAAqB,GAAG,CAAC,GAAG,GAAG;QAE/B,iCAAiC,GAAG,GAAG;QAEvC,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG;;WCW7B,eAAe,CAAC,EAC9B,eAAe,EACf,cAAc,EACd,WAAW,GAAG,QAAQ,EACtB,QAAQ,GAAG,gBAAgB,EACF;MACzB,OAAOA,yBAAO,CAAC,eAAe,EAAE;UAC9B,UAAU,EAAE,KAAK;UACjB,cAAc,EAAE,cAAc;UAC9B,MAAM,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE;OACnD,CAAC,CAAC;EACL;;WC3BgB,qBAAqB,CACnC,QAA4B,EAC5B,YAAgC;MAEhC,IAAI,YAAY,EAAE;UAChB,OAAO,YAAY,CAAC;OACrB;;;;MAID,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;EACtE;;EC2BA;;;;;;;QAOsB,WAAW;;;;;;;;;;;;;;;;;MAmJ/B,YAAY,MAA6B;;;;UA5BjC,sBAAiB,GAAQ,IAAI,CAAC;;;;UAU9B,uBAAkB,GAAwB,IAAI,CAAC;UAmBrD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;UAC9C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;UAC1B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC;UAClD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;UAC5C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;UACpD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;UAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;UAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;UAC9B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;UACxC,IAAI,CAAC,uBAAuB;cAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,EAAE,iCAAiC,CAAC,GAAG,IAAI,CAAC;UAC1E,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;OACvB;;;;;;MAOD,gBAAgB;UACd,IAAI,IAAI,CAAC,SAAS,EAAE;cAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE;kBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;kBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;kBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;kBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;eACtB,CAAC,CAAC;WACJ;UACD,OAAO,IAAI,CAAC,SAAS,CAAC;OACvB;;;;;MAMD,2BAA2B;UACzB,MAAM,KAAK,GAAG;cACZ,IAAI,CAAC,gBAAgB,EAAE,CAAC;WACzB,CAAC;UAEF,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;cAC3B,IAAI,CAAC,iBAAiB,GAAG,WAAW,CAClC,KAAK;;cAEL,IAAI,CAAC,uBAAuB,CAC7B,CAAC;WACH;UAED,UAAU,CAAC;cACT,KAAK,EAAE,CAAC;WACT,EAAE,EAAE,CAAC,CAAC;UAEP,OAAO,IAAI,CAAC,iBAAiB,CAAC;OAC/B;;;;MAKD,0BAA0B;UACxB,IAAI,IAAI,CAAC,iBAAiB,EAAE;cAC1B,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;cACtC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;WAC/B;OACF;;;;;;MAOD,IAAI,sBAAsB;UACxB,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;OACjC;;;;;;;;MASS,aAAa,YAAY,CACjC,EACE,eAAe,EACf,WAAW,GAAG,QAAQ,EACtB,cAAc,EACd,YAAY,EACZ,QAAQ,GAAG,gBAAgB,EAC3B,WAAW,GAAG,IAAI,EAQnB,EACD,YAAsD;UAEtD,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC;cAC5C,eAAe;cACf,WAAW;cACX,cAAc;cACd,QAAQ;WACT,CAAC,CAAC;UACH,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;UAEzE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;cAC/B,eAAe,EAAE,eAAe;cAChC,KAAK,EAAE,eAAe,CAAC,YAAY;cACnC,WAAW;cACX,cAAc;cACd,YAAY,EAAE,kBAAkB;cAChC,OAAO,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAAC;cACtE,SAAS,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;cAC9C,OAAO,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;cAC1C,QAAQ;WACT,CAAC,CAAC;UAEH,OAAO,CAAC,2BAA2B,EAAE,CAAC;UAEtC,IAAI,WAAW,EAAE;cACf,OAAO,CAAC,gBAAgB,EAAE,CAAC;WAC5B;UAED,OAAO,OAAY,CAAC;OACrB;;;;;MAMD,IAAI,SAAS;UACX,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;OAClC;;;;;;MAOD,QAAQ;UACN,IAAI,IAAI,CAAC,SAAS,EAAE;cAClB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;WACzD;UAED,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;OACpC;;;;;;MAOD,IAAI,UAAU;UACZ,OAAO,IAAI,CAAC;OACb;;;;;;MAOD,IAAI,WAAW;UACb,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;OAC9D;;;;;;;MAQD,MAAM,kBAAkB;;UAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,IAAI,CAAC,SAAS,CAAC;cACb,KAAK,EAAE,IAAI,CAAC,KAAK;cACjB,SAAS,EAAE,IAAI,CAAC,SAAS;cACzB,OAAO,EAAE,IAAI,CAAC,OAAO;cACrB,OAAO,EAAE,IAAI,CAAC,OAAO;WACtB,CAAC,CACH,CAAC;UAEF,IAAI;cACF,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC;kBACvC,eAAe,EAAE,IAAI,CAAC,eAAe;kBACrC,WAAW,EAAE,IAAI,CAAC,WAAW;kBAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;kBACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;eACxB,CAAC,CAAC;cAEH,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;cACvC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;cAClD,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;cAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;cAEzE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;kBAC7B,QAAQ,EAAE;sBACR,KAAK,EAAE,QAAQ,CAAC,KAAK;sBACrB,SAAS,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;sBACvC,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;sBACnC,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;mBACpC;kBACD,OAAO,EAAE;sBACP,KAAK,EAAE,IAAI,CAAC,KAAK;sBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;sBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;sBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;mBACtB;eACF,CAAC,CAAC;WACJ;UAAC,OAAO,KAAK,EAAE;cACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;cAClC,MAAM,KAAK,CAAC;WACb;UAED,OAAO,IAAI,CAAC;OACb;;;;;MAKD,gBAAgB;UACd,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;cAC3B,IAAI,CAAC,2BAA2B,EAAE,CAAC;WACpC;UAED,IAAI,CAAC,kBAAkB,GAAG;cACxB,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY;kBAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;eACnC,CAAC,CAAC;WACJ,CAAC;UAEF,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;OAC7C;;;;;;MAOD,eAAe;UACb,IAAI,IAAI,CAAC,kBAAkB,EAAE;cAC3B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;cAC7C,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;WAChC;OACF;MAWD,EAAE,CACA,SAAiB,EACjB,OAG4B;UAE5B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;UACpC,IAAI,CAAC,gBAAgB,EAAE,CAAC;OACzB;MAWD,IAAI,CACF,SAAiB,EACjB,OAG4B;UAE5B,MAAM,EAAE,GAAG,CAAC,CAAM;cAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;cAChC,OAAO,CAAC,CAAC,CAAC,CAAC;WACZ,CAAC;UAEF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;OAChC;MAWD,GAAG,CACD,SAAiB,EACjB,OAG4B;UAE5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;OACtC;;;;MAKO,QAAQ,CAAC,KAAa;UAC3B,IAA8B,CAAC,KAAK,GAAG,KAAK,CAAC;OAC/C;MACO,YAAY,CAAC,SAAe;UACjC,IAA8B,CAAC,SAAS,GAAG,SAAS,CAAC;OACvD;MACO,UAAU,CAAC,OAAa;UAC7B,IAA8B,CAAC,OAAO,GAAG,OAAO,CAAC;OACnD;MACO,UAAU,CAAC,OAAa;UAC7B,IAA8B,CAAC,OAAO,GAAG,OAAO,CAAC;OACnD;;EAxdD;EACA;EACA;;;EAGgB,iBAAK,GAAG,SAAS,KAAK,CAAC,CAAQ,KAAU,CAAC;EAE1D;EACA;EACA;;;;;;;;;;EAUgB,mBAAO,GAAG,SAAS,OAAO,CAAC,CAK1C,KAAU,CAAC;EAEZ;EACA;EACA;;;;;;;;;;;;;;;;EAgBgB,qBAAS,GAAG,SAAS,SAAS,CAAC,CAa9C,KAAU,CAAC;;EClGd;;;;;;;;QAQa,mBAAoB,SAAQ,WAAW;;;;;MAKlD,YAAY,MAA6B;UACvC,KAAK,CAAC,MAAM,CAAC,CAAC;OACf;;;;MAKD,aAAa,KAAK,CAAC,MAA2B;UAC5C,OAAO,WAAW,CAAC,YAAY,iCAExB,MAAM,KACT,eAAe,EACb,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,eAAe,KAAI,uCAAuC,KAEtE,mBAEwB,CACzB,CAAC;OACH;;;;;;;;;;;;;;;;;"}

package/dist/bundled/basemap-sessions.umd.min.js

@@ -0,0 +1,12 @@
+/* @preserve
+* @esri/arcgis-rest-basemap-sessions - v1.0.0 - Apache-2.0
+* Copyright (c) 2017-2025 Esri, Inc.
+* Wed Jul 30 2025 12:24:38 GMT-0700 (Pacific Daylight Time)
+*/
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("@esri/arcgis-rest-request")):"function"==typeof define&&define.amd?define(["exports","@esri/arcgis-rest-request"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).arcgisRest=e.arcgisRest||{},e.arcgisRest)}(this,(function(e,t){"use strict";const i="https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/sessions/start",s=43200;function r({startSessionUrl:e,authentication:i,styleFamily:s="arcgis",duration:r=43200}){return t.request(e,{httpMethod:"GET",authentication:i,params:{styleFamily:s,durationSeconds:r}})}class n{constructor(e){var t;this.expirationTimerId=null,this.autoRefreshHandler=null,this.startSessionUrl=e.startSessionUrl,this.token=e.token,this.styleFamily=e.styleFamily||"arcgis",this.authentication=e.authentication,this.duration=e.duration||s,this.startTime=e.startTime,this.endTime=e.endTime,this.expires=e.expires,this.safetyMargin=e.safetyMargin,this.expirationCheckInterval=1e3*Math.min(this.duration/100,10),this.emitter={all:t=t||new Map,on:function(e,i){var s=t.get(e);s?s.push(i):t.set(e,[i])},off:function(e,i){var s=t.get(e);s&&(i?s.splice(s.indexOf(i)>>>0,1):t.set(e,[]))},emit:function(e,i){var s=t.get(e);s&&s.slice().map((function(e){e(i)})),(s=t.get("*"))&&s.slice().map((function(t){t(e,i)}))}}}isSessionExpired(){return this.isExpired&&this.emitter.emit("expired",{token:this.token,startTime:this.startTime,endTime:this.endTime,expires:this.expires}),this.isExpired}startCheckingExpirationTime(){const e=()=>{this.isSessionExpired()};return this.expirationTimerId||(this.expirationTimerId=setInterval(e,this.expirationCheckInterval)),setTimeout((()=>{e()}),10),this.expirationTimerId}stopCheckingExpirationTime(){this.expirationTimerId&&(clearInterval(this.expirationTimerId),this.expirationTimerId=null)}get checkingExpirationTime(){return!!this.expirationTimerId}static async startSession({startSessionUrl:e,styleFamily:t="arcgis",authentication:i,safetyMargin:s,duration:n=43200,autoRefresh:a=!0},o){const h=await r({startSessionUrl:e,styleFamily:t,authentication:i,duration:n}),m=function(e,t){return t||Math.min(Math.max(e/100,1),300)}(n,s),u=new o({startSessionUrl:e,token:h.sessionToken,styleFamily:t,authentication:i,safetyMargin:m,expires:new Date(h.endTime-1e3*m),startTime:new Date(h.startTime),endTime:new Date(h.endTime),duration:n});return u.startCheckingExpirationTime(),a&&u.startAutoRefresh(),u}get isExpired(){return this.expires<new Date}getToken(){return this.isExpired?this.refreshCredentials().then((()=>this.token)):Promise.resolve(this.token)}get canRefresh(){return!0}get autoRefresh(){return!!this.autoRefreshHandler&&!!this.expirationTimerId}async refreshCredentials(){const e=JSON.parse(JSON.stringify({token:this.token,startTime:this.startTime,endTime:this.endTime,expires:this.expires}));try{const t=await r({startSessionUrl:this.startSessionUrl,styleFamily:this.styleFamily,authentication:this.authentication,duration:this.duration});this.setToken(t.sessionToken),this.setStartTime(new Date(t.startTime)),this.setEndTime(new Date(t.endTime)),this.setExpires(new Date(t.endTime-1e3*this.safetyMargin)),this.emitter.emit("refreshed",{previous:{token:e.token,startTime:new Date(e.startTime),endTime:new Date(e.endTime),expires:new Date(e.expires)},current:{token:this.token,startTime:this.startTime,endTime:this.endTime,expires:this.expires}})}catch(e){throw this.emitter.emit("error",e),e}return this}startAutoRefresh(){this.expirationTimerId||this.startCheckingExpirationTime(),this.autoRefreshHandler=()=>{this.refreshCredentials().catch((e=>{this.emitter.emit("error",e)}))},this.on("expired",this.autoRefreshHandler)}stopAutoRefresh(){this.autoRefreshHandler&&(this.off("expired",this.autoRefreshHandler),this.autoRefreshHandler=null)}on(e,t){this.emitter.on(e,t),this.isSessionExpired()}once(e,t){const i=s=>{this.emitter.off(e,i),t(s)};this.emitter.on(e,i)}off(e,t){this.emitter.off(e,t)}setToken(e){this.token=e}setStartTime(e){this.startTime=e}setEndTime(e){this.endTime=e}setExpires(e){this.expires=e}}
+/* istanbul ignore next -- @preserve */n.error=function(e){},
+/* istanbul ignore next -- @preserve */
+n.expired=function(e){},
+/* istanbul ignore next -- @preserve */
+n.refreshed=function(e){};class a extends n{constructor(e){super(e)}static async start(e){return n.startSession(Object.assign(Object.assign({},e),{startSessionUrl:(null==e?void 0:e.startSessionUrl)||i}),a)}}e.BaseSession=n,e.BasemapStyleSession=a,e.DEFAULT_CHECK_EXPIRATION_INTERVAL=10,e.DEFAULT_DURATION=s,e.DEFAULT_SAFETY_MARGIN=300,e.DEFAULT_START_BASEMAP_STYLE_SESSION_URL=i,e.startNewSession=r,Object.defineProperty(e,"__esModule",{value:!0})}));
+//# sourceMappingURL=basemap-sessions.umd.min.js.map

package/dist/bundled/basemap-sessions.umd.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basemap-sessions.umd.min.js","sources":["../../src/utils/defaults.ts","../../src/utils/startNewSession.ts","../../src/BaseSession.ts","../../node_modules/mitt/dist/mitt.mjs","../../src/utils/detemineSafetyMargin.ts","../../src/BasemapStyleSession.ts"],"sourcesContent":["export const DEFAULT_START_BASEMAP_STYLE_SESSION_URL =\n  \"https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/sessions/start\";\n\nexport const DEFAULT_SAFETY_MARGIN = 5 * 60; // Default to 5 minutes in seconds\n\nexport const DEFAULT_CHECK_EXPIRATION_INTERVAL = 10; // Default to 10 seconds\n\nexport const DEFAULT_DURATION = 12 * 60 * 60; // Default to 12 hours in seconds\n","import { IAuthenticationManager, request } from \"@esri/arcgis-rest-request\";\nimport { StyleFamily } from \"../types/StyleFamily.js\";\nimport { DEFAULT_DURATION } from \"./defaults.js\";\n\nexport interface IRequestNewSessionParams {\n  startSessionUrl: string;\n  authentication: IAuthenticationManager | string;\n  styleFamily?: StyleFamily;\n  duration?: number;\n}\n\nexport interface IStartSessionResponse {\n  sessionToken: string;\n  endTime: number;\n  startTime: number;\n  styleFamily: StyleFamily;\n}\n\nexport function startNewSession({\n  startSessionUrl,\n  authentication,\n  styleFamily = \"arcgis\",\n  duration = DEFAULT_DURATION\n}: IRequestNewSessionParams): Promise<IStartSessionResponse> {\n  return request(startSessionUrl, {\n    httpMethod: \"GET\",\n    authentication: authentication,\n    params: { styleFamily, durationSeconds: duration }\n  });\n}\n","import mitt from \"mitt\";\n\nimport { IAuthenticationManager } from \"@esri/arcgis-rest-request\";\nimport { StyleFamily } from \"./types/StyleFamily.js\";\nimport { startNewSession } from \"./utils/startNewSession.js\";\nimport { Writable } from \"./utils/writable.js\";\nimport { determineSafetyMargin } from \"./utils/detemineSafetyMargin.js\";\nimport {\n  DEFAULT_DURATION,\n  DEFAULT_SAFETY_MARGIN,\n  DEFAULT_CHECK_EXPIRATION_INTERVAL\n} from \"./utils/defaults.js\";\n\nexport interface IBasemapSessionParams {\n  token: string;\n  startSessionUrl: string;\n  styleFamily: StyleFamily;\n  authentication: IAuthenticationManager | string;\n  expires: Date;\n  startTime: Date;\n  endTime: Date;\n  safetyMargin?: number;\n  duration?: number;\n  autoRefresh?: boolean;\n}\n\nexport interface IStartSessionParams {\n  styleFamily?: StyleFamily;\n  authentication: IAuthenticationManager | string;\n  safetyMargin?: number;\n  duration?: number;\n  autoRefresh?: boolean;\n\n  /**\n   * The URL to start the session. If not provided, it will use the default URL.\n   * @private\n   */\n  startSessionUrl?: string;\n}\n\n/**\n * The base class for all basemap sessions. This class implements the {@linkcode IAuthenticationManager} interface and provides methods to start, refresh, and check the expiration of a session.\n * This is not intendet to be used directly, but instead is extended by other classes such as {@linkcode BasemapStyleSession} and {@linkcode StaticBasemapTilesSession}.\n *\n * @abstract\n * @implements {IAuthenticationManager}\n */\nexport abstract class BaseSession implements IAuthenticationManager {\n  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.\n  /* istanbul ignore next -- @preserve */\n  /**\n   * Event handler for when an error occurs during session management.\n   */\n  static readonly error = function error(e: Error): void {}; // eslint-disable-line @typescript-eslint/no-empty-function\n\n  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.\n  /* istanbul ignore next -- @preserve */\n  /**\n   * Event handler for when a session expires and the `token` it no longer valid.\n   *\n   * @event expired\n   * @param e - The parameters for the expired event.\n   * @param e.token - The session token that expired.\n   * @param e.startTime - The start time of the session.\n   * @param e.endTime - The end time of the session.\n   * @param e.expires - The expiration time of the session.\n   */\n  static readonly expired = function expired(e: {\n    token: string;\n    startTime: Date;\n    endTime: Date;\n    expires: Date;\n  }): void {}; // eslint-disable-line @typescript-eslint/no-empty-function\n\n  // the static methods for event handlers are used to provide doc via typedoc and do not need to be tested.\n  /* istanbul ignore next -- @preserve */\n  /**\n   * Event handler for when a session refreshes and a new `token` is available.\n   *\n   * @event refreshed\n   * @param e. - The parameters for the refreshed event.\n   * @param e.previous - The previous session details.\n   * @param e.previous.token - The previous session token.\n   * @param e.previous.startTime - The start time of the previous session.\n   * @param e.previous.endTime - The end time of the previous session.\n   * @param e.previous.expires - The expiration time of the previous session.\n   * @param e.current - The current session details.\n   * @param e.current.token - The current session token.\n   * @param e.current.startTime - The start time of the current token.\n   * @param e.current.endTime - The end time of the current session.\n   * @param e.current.expires - The expiration time of the current token.\n   */\n  static readonly refreshed = function refreshed(e: {\n    previous: {\n      token: string;\n      startTime: Date;\n      endTime: Date;\n      expires: Date;\n    };\n    current: {\n      token: string;\n      startTime: Date;\n      endTime: Date;\n      expires: Date;\n    };\n  }): void {}; // eslint-disable-line @typescript-eslint/no-empty-function\n\n  /**\n   * The portal URL that the session is associated with. This generally is not used but exists to implement the `IAuthenticationManager` interface.\n   */\n  readonly portal: string;\n\n  /**\n   * The style family of the session. This is used to determine the type of basemap styles that are available.\n   */\n  readonly styleFamily: StyleFamily;\n\n  /**\n   * The authentication manager or token used for the session.\n   * This can be an instance of {@linkcode ApiKeyManager}, {@linkcode ArcGISIdentityManager}, {@linkcode ApplicationCredentialsManager} or a string token.\n   */\n  readonly authentication: IAuthenticationManager | string;\n\n  /**\n   * The expiration date of the session. This is the {@linkcode BaseSession.endTime} minus the {@linkcode BaseSession.safetyMargin}. This is used internally to determine if the session is expired.\n   */\n  readonly expires: Date;\n\n  /**\n   * The start time of the session. This is the time returned from the API when the session war started.\n   */\n  readonly startTime: Date;\n\n  /**\n   * The end time of the session. This is the time returned from the API when the session will end.\n   */\n  readonly endTime: Date;\n\n  /**\n   * The token for the session.\n   */\n  readonly token: string;\n\n  /**\n   * The URL used to start the session.\n   */\n  readonly startSessionUrl: string;\n\n  /**\n   * The safety margin in milliseconds. This subtracted from the {@linkcode BaseSession.endTime} to get the {@linkcode BaseSession.expiration}.\n   */\n  readonly safetyMargin: number;\n\n  /**\n   * The duration of the session in seconds. This is used to determine how long the session will last when the session is refreshed.\n   */\n  readonly duration: number;\n\n  /**\n   * The interval at which to check the expiration time of the session. This is always 10 seconds or 1/100th of the duration, whichever is smaller.\n   */\n  readonly expirationCheckInterval: number;\n\n  /**\n   * The ID of the timer used to check the expiration time of the session.\n   */\n  private expirationTimerId: any = null;\n\n  /**\n   * Internal instance of [`mitt`](https://github.com/developit/mitt) used for event handlers. It is recommended to use {@linkcode BasemapSession.on}, {@linkcode BasemapSession.off} or {@linkcode BasemapSession.once} instead of `emitter.`\n   */\n  private emitter: any;\n\n  /**\n   * A handler that is used to automatically refresh the session when it expires.\n   */\n  private autoRefreshHandler: (() => void) | null = null;\n\n  /**\n   * Creates a new instance of the BaseSession class. Generally you should not create an instance of this class directly, but instead use the static methods to start a session or deserialize a session.\n   *\n   * You may need to create an instance of this class directly if you are  not using the built in deserialize method.\n   *\n   * @param params - The parameters for the session.\n   * @param params.startSessionUrl - The URL to start the session.\n   * @param params.token - The token for the session.\n   * @param params.styleFamily - The style family of the session.\n   * @param params.authentication - The authentication manager or token used for the session.\n   * @param params.expires - The expiration date of the session.\n   * @param params.startTime - The start time of the session.\n   * @param params.endTime - The end time of the session.\n   * @param params.safetyMargin - The safety margin in milliseconds.\n   * @param params.duration - Indicates if this is a test session.\n   */\n  constructor(params: IBasemapSessionParams) {\n    this.startSessionUrl = params.startSessionUrl;\n    this.token = params.token;\n    this.styleFamily = params.styleFamily || \"arcgis\";\n    this.authentication = params.authentication;\n    this.duration = params.duration || DEFAULT_DURATION;\n    this.startTime = params.startTime;\n    this.endTime = params.endTime;\n    this.expires = params.expires;\n    this.safetyMargin = params.safetyMargin;\n    this.expirationCheckInterval =\n      Math.min(this.duration / 100, DEFAULT_CHECK_EXPIRATION_INTERVAL) * 1000;\n    this.emitter = mitt();\n  }\n\n  /**\n   * Checks if the session is expired. If it is expired, it emits an \"expired\" event. The event will fire **before** the method returns true.\n   *\n   * @returns {boolean} - Returns true if the session is expired, otherwise false.\n   */\n  isSessionExpired() {\n    if (this.isExpired) {\n      this.emitter.emit(\"expired\", {\n        token: this.token,\n        startTime: this.startTime,\n        endTime: this.endTime,\n        expires: this.expires\n      });\n    }\n    return this.isExpired;\n  }\n\n  /**\n   * Starts checking the expiration time of the session. This will check the expiration time immediately and then on an interval.\n   * If the session is expired, it will emit an \"expired\" event.\n   */\n  startCheckingExpirationTime() {\n    const check = () => {\n      this.isSessionExpired();\n    };\n\n    if (!this.expirationTimerId) {\n      this.expirationTimerId = setInterval(\n        check,\n        // check every 10 seconds or 1/100th of the duration, whichever is smaller\n        this.expirationCheckInterval\n      ); // check immediatly then on an interval\n    }\n\n    setTimeout(() => {\n      check(); // check immediately after starting the interval\n    }, 10);\n\n    return this.expirationTimerId; // return the timer ID so it can be stopped later\n  }\n\n  /**\n   * Stops checking the expiration time of the session. This will clear the interval that was set by {@linkcode BaseSession.startCheckingExpirationTime}.\n   */\n  stopCheckingExpirationTime() {\n    if (this.expirationTimerId) {\n      clearInterval(this.expirationTimerId);\n      this.expirationTimerId = null;\n    }\n  }\n\n  /**\n   * Indicates if the session is currently checking for expiration time.\n   *\n   * @returns {boolean} - Returns true if the session is checking for expiration time, otherwise false.\n   */\n  get checkingExpirationTime(): boolean {\n    return !!this.expirationTimerId;\n  }\n\n  /**\n   * Starts a new session using the provided parameters and returns an instance of the session class.\n   *\n   * @param params - The parameters for starting the session.\n   * @param SessionClass - The class to use for the session.\n   * @returns A promise that resolves to an instance of the session class.\n   */\n  protected static async startSession<T extends BaseSession>(\n    {\n      startSessionUrl,\n      styleFamily = \"arcgis\",\n      authentication,\n      safetyMargin,\n      duration = DEFAULT_DURATION,\n      autoRefresh = true\n    }: {\n      startSessionUrl?: string;\n      styleFamily?: StyleFamily;\n      authentication: IAuthenticationManager | string;\n      safetyMargin?: number;\n      duration?: number;\n      autoRefresh?: boolean;\n    },\n    SessionClass: new (params: IBasemapSessionParams) => T\n  ): Promise<T> {\n    const sessionResponse = await startNewSession({\n      startSessionUrl,\n      styleFamily,\n      authentication,\n      duration\n    });\n    const actualSafetyMargin = determineSafetyMargin(duration, safetyMargin);\n\n    const session = new SessionClass({\n      startSessionUrl: startSessionUrl,\n      token: sessionResponse.sessionToken,\n      styleFamily,\n      authentication,\n      safetyMargin: actualSafetyMargin,\n      expires: new Date(sessionResponse.endTime - actualSafetyMargin * 1000),\n      startTime: new Date(sessionResponse.startTime),\n      endTime: new Date(sessionResponse.endTime),\n      duration\n    });\n\n    session.startCheckingExpirationTime();\n\n    if (autoRefresh) {\n      session.startAutoRefresh();\n    }\n\n    return session as T;\n  }\n\n  /**\n   * Checks if the session is expired.\n   *\n   */\n  get isExpired(): boolean {\n    return this.expires < new Date();\n  }\n\n  /**\n   * Gets the session token. If the session is expired, it will refresh the credentials and return the new token.\n   *\n   * @returns A promise that resolves to the session token.\n   */\n  getToken(): Promise<string> {\n    if (this.isExpired) {\n      return this.refreshCredentials().then(() => this.token);\n    }\n\n    return Promise.resolve(this.token);\n  }\n\n  /**\n   * Indicates if the session can be refreshed. This is always true for this class.\n   *\n   * @returns {boolean} - Always returns true.\n   */\n  get canRefresh(): boolean {\n    return true;\n  }\n\n  /**\n   * Indicates if the session is set to automatically refresh when it expires.\n   *\n   * @returns {boolean} - Returns true if auto-refresh is enabled, otherwise false.\n   */\n  get autoRefresh(): boolean {\n    return !!this.autoRefreshHandler && !!this.expirationTimerId;\n  }\n\n  /**\n   * Refreshes the session credentials by starting a new session.\n   * This will emit a \"refreshed\" event with the previous and current session details.\n   *\n   * @returns A promise that resolves to the current instance of the session.\n   */\n  async refreshCredentials(): Promise<this> {\n    // @TODO switch this to structured clone when we upgrade to Node 20+ types so we don't have to parse the dates later\n    const previous = JSON.parse(\n      JSON.stringify({\n        token: this.token,\n        startTime: this.startTime,\n        endTime: this.endTime,\n        expires: this.expires\n      })\n    );\n\n    try {\n      const newSession = await startNewSession({\n        startSessionUrl: this.startSessionUrl,\n        styleFamily: this.styleFamily,\n        authentication: this.authentication,\n        duration: this.duration\n      });\n\n      this.setToken(newSession.sessionToken);\n      this.setStartTime(new Date(newSession.startTime));\n      this.setEndTime(new Date(newSession.endTime));\n      this.setExpires(new Date(newSession.endTime - this.safetyMargin * 1000));\n\n      this.emitter.emit(\"refreshed\", {\n        previous: {\n          token: previous.token,\n          startTime: new Date(previous.startTime),\n          endTime: new Date(previous.endTime),\n          expires: new Date(previous.expires)\n        },\n        current: {\n          token: this.token,\n          startTime: this.startTime,\n          endTime: this.endTime,\n          expires: this.expires\n        }\n      });\n    } catch (error) {\n      this.emitter.emit(\"error\", error);\n      throw error;\n    }\n\n    return this;\n  }\n  /**\n   * Enables auto-refresh for the session. This will automatically refresh the session when it expires.\n   * It will also start checking the expiration time of the session if it is not already started via {@linkcode BaseSession.startCheckingExpirationTime}.\n   */\n  startAutoRefresh() {\n    if (!this.expirationTimerId) {\n      this.startCheckingExpirationTime();\n    }\n\n    this.autoRefreshHandler = () => {\n      this.refreshCredentials().catch((error: Error) => {\n        this.emitter.emit(\"error\", error);\n      });\n    };\n\n    this.on(\"expired\", this.autoRefreshHandler);\n  }\n\n  /**\n   * Disables auto-refresh for the session. This will stop automatically refreshing the session when it expires.\n   * This will  **not** stop checking the expiration time of the session. If you want to stop automated expiration\n   * checking, call {@linkcode BaseSession.stopCheckingExpirationTime} after calling this method.\n   */\n  stopAutoRefresh() {\n    if (this.autoRefreshHandler) {\n      this.off(\"expired\", this.autoRefreshHandler);\n      this.autoRefreshHandler = null;\n    }\n  }\n\n  /**\n   * A handler that listens for an eventName and returns custom handler.\n   *\n   * @param eventName A string of what event to listen for.\n   * @param handler A function of what to do when eventName was called.\n   */\n  on(event: \"refreshed\", handler: typeof BaseSession.refreshed): void;\n  on(event: \"expired\", handler: typeof BaseSession.expired): void;\n  on(event: \"error\", handler: typeof BaseSession.error): void;\n  on(\n    eventName: string,\n    handler:\n      | typeof BaseSession.refreshed\n      | typeof BaseSession.expired\n      | typeof BaseSession.error\n  ) {\n    this.emitter.on(eventName, handler);\n    this.isSessionExpired(); // check if the session is expired immediately after adding the handler\n  }\n\n  /**\n   * A handler that listens for an event once and returns a custom handler. Events listened to with this method cannot be removed with {@linkcode BasemapSession.off}.\n   *\n   * @param eventName A string of what event to listen for.\n   * @param handler A function of what to do when eventName was called.\n   */\n  once(event: \"refreshed\", handler: typeof BaseSession.refreshed): void;\n  once(event: \"expired\", handler: typeof BaseSession.expired): void;\n  once(event: \"error\", handler: typeof BaseSession.error): void;\n  once(\n    eventName: string,\n    handler:\n      | typeof BaseSession.refreshed\n      | typeof BaseSession.expired\n      | typeof BaseSession.error\n  ) {\n    const fn = (e: any) => {\n      this.emitter.off(eventName, fn);\n      handler(e);\n    };\n\n    this.emitter.on(eventName, fn);\n  }\n\n  /**\n   * A handler that will remove a listener from a given event.\n   *\n   * @param eventName A string of what event to listen for.\n   * @param handler A function of what to do when eventName was called.\n   */\n  off(event: \"refreshed\", handler: typeof BaseSession.refreshed): void;\n  off(event: \"expired\", handler: typeof BaseSession.expired): void;\n  off(event: \"error\", handler: typeof BaseSession.error): void;\n  off(\n    eventName: string,\n    handler:\n      | typeof BaseSession.refreshed\n      | typeof BaseSession.expired\n      | typeof BaseSession.error\n  ) {\n    this.emitter.off(eventName, handler);\n  }\n\n  /**\n   * These private methods are used to set the internal state of the session.\n   */\n  private setToken(token: string) {\n    (this as Writable<typeof this>).token = token;\n  }\n  private setStartTime(startTime: Date) {\n    (this as Writable<typeof this>).startTime = startTime;\n  }\n  private setEndTime(endTime: Date) {\n    (this as Writable<typeof this>).endTime = endTime;\n  }\n  private setExpires(expires: Date) {\n    (this as Writable<typeof this>).expires = expires;\n  }\n}\n","export default function(n){return{all:n=n||new Map,on:function(t,e){var i=n.get(t);i?i.push(e):n.set(t,[e])},off:function(t,e){var i=n.get(t);i&&(e?i.splice(i.indexOf(e)>>>0,1):n.set(t,[]))},emit:function(t,e){var i=n.get(t);i&&i.slice().map(function(n){n(e)}),(i=n.get(\"*\"))&&i.slice().map(function(n){n(t,e)})}}}\n//# sourceMappingURL=mitt.mjs.map\n","import { DEFAULT_SAFETY_MARGIN } from \"./defaults.js\";\n\nexport function determineSafetyMargin(\n  duration: number | undefined,\n  safetyMargin: number | undefined\n): number {\n  if (safetyMargin) {\n    return safetyMargin;\n  }\n  // common cases are\n  // duration is 60 seconds, this will return a 1 second safety margin\n  // duration is 43200 seconds, this will return a 300 second (5 minutes) safety margin\n  return Math.min(Math.max(duration / 100, 1), DEFAULT_SAFETY_MARGIN);\n}\n","import {\n  BaseSession,\n  IBasemapSessionParams,\n  IStartSessionParams\n} from \"./BaseSession.js\";\nimport { DEFAULT_START_BASEMAP_STYLE_SESSION_URL } from \"./utils/defaults.js\";\n\n/**\n * `BasemapStyleSession` is a class that extends {@linkcode BaseSession} to manage sessions\n * for basemap styles. It provides methods to {@linkcode BasemapStyleSession.start} a new session\n * which should be used instead of constructing a new instance directly.\n *\n * @class BasemapStyleSession\n * @extends BaseSession\n */\nexport class BasemapStyleSession extends BaseSession {\n  /**\n   * Creates an instance of `BasemapStyleSession`. Constructing `BasemapStyleSession` directly is discouraged.\n   * Instead, use the static method {@linkcode BasemapStyleSession.start} to start a new session.\n   */\n  constructor(params: IBasemapSessionParams) {\n    super(params);\n  }\n\n  /**\n   * Starts a new basemap style session.\n   */\n  static async start(params: IStartSessionParams) {\n    return BaseSession.startSession<BasemapStyleSession>(\n      {\n        ...params,\n        startSessionUrl:\n          params?.startSessionUrl || DEFAULT_START_BASEMAP_STYLE_SESSION_URL\n      },\n      BasemapStyleSession as new (\n        params: IBasemapSessionParams\n      ) => BasemapStyleSession\n    );\n  }\n}\n"],"names":["DEFAULT_START_BASEMAP_STYLE_SESSION_URL","DEFAULT_DURATION","startNewSession","startSessionUrl","authentication","styleFamily","duration","request","httpMethod","params","durationSeconds","BaseSession","constructor","n","this","token","startTime","endTime","expires","safetyMargin","expirationCheckInterval","Math","min","emitter","all","Map","on","t","e","i","get","push","set","off","splice","indexOf","emit","slice","map","isSessionExpired","isExpired","startCheckingExpirationTime","check","expirationTimerId","setInterval","setTimeout","stopCheckingExpirationTime","clearInterval","checkingExpirationTime","static","autoRefresh","SessionClass","sessionResponse","actualSafetyMargin","max","determineSafetyMargin","session","sessionToken","Date","startAutoRefresh","getToken","refreshCredentials","then","Promise","resolve","canRefresh","autoRefreshHandler","async","previous","JSON","parse","stringify","newSession","setToken","setStartTime","setEndTime","setExpires","current","error","catch","stopAutoRefresh","eventName","handler","once","fn","BasemapStyleSession","super","startSession"],"mappings":"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"}