@esri/arcgis-rest-basemap-sessions 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+[![npm version][npm-img]][npm-url]
+[![gzip bundle size][gzip-image]][npm-url]
+[![Coverage Status][coverage-img]][coverage-url]
+[![apache licensed](https://img.shields.io/badge/license-Apache-green.svg?style=flat-square)](https://raw.githubusercontent.com/Esri/arcgis-rest-js/master/LICENSE)
+
+[npm-img]: https://img.shields.io/npm/v/@esri/arcgis-rest-basemap-sessions.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-basemap-sessions
+[gzip-image]: https://img.badgesize.io/https://unpkg.com/@esri/arcgis-rest-basemap-sessions/dist/bundled/basemap-sessions.umd.min.js?compression=gzip
+[coverage-img]: https://codecov.io/gh/Esri/arcgis-rest-js/branch/master/graph/badge.svg
+[coverage-url]: https://codecov.io/gh/Esri/arcgis-rest-js
+
+# @esri/arcgis-rest-basemap-sessions
+
+> Helpers to initiate and manage a basemap session in for use with te Basemap Style Service in ArcGIS REST JS helpers.
+
+### Example
+
+```bash
+@TODO
+```
+
+### [API Reference](https://developers.arcgis.com/arcgis-rest-js/api-reference/arcgis-rest-geocoding/)
+
+@TODO
+
+### Issues
+
+If something isn't working the way you expected, please take a look at [previously logged issues](https://github.com/Esri/arcgis-rest-js/issues) first. Have you found a new bug? Want to request a new feature? We'd [**love**](https://github.com/Esri/arcgis-rest-js/issues/new) to hear from you.
+
+If you're looking for help you can also post issues on [GIS Stackexchange](http://gis.stackexchange.com/questions/ask?tags=esri-oss).
+
+### Versioning
+
+For transparency into the release cycle and in striving to maintain backward compatibility, @esri/arcgis-rest-js is maintained under Semantic Versioning guidelines and will adhere to these rules whenever possible.
+
+For more information on SemVer, please visit <http://semver.org/>.
+
+### Contributing
+
+Esri welcomes contributions from anyone and everyone. Please see our [guidelines for contributing](CONTRIBUTING.md).
+
+### [Changelog](https://github.com/Esri/arcgis-rest-js/blob/master/CHANGELOG.md)
+
+### License
+
+Copyright &copy; 2025 Esri
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+> http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+A copy of the license is available in the repository's [LICENSE](../../LICENSE) file.

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

@@ -0,0 +1,362 @@
+/* @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)
+*/
+import { request } from '@esri/arcgis-rest-request';
+
+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 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);
+    }
+}
+
+export { BaseSession, BasemapStyleSession, DEFAULT_CHECK_EXPIRATION_INTERVAL, DEFAULT_DURATION, DEFAULT_SAFETY_MARGIN, DEFAULT_START_BASEMAP_STYLE_SESSION_URL, startNewSession };
+//# sourceMappingURL=basemap-sessions.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basemap-sessions.esm.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":[],"mappings":"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"}

package/dist/bundled/basemap-sessions.esm.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)
+*/
+import{request as t}from"@esri/arcgis-rest-request";const e="https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/sessions/start",i=300,s=10,r=43200;function n({startSessionUrl:e,authentication:i,styleFamily:s="arcgis",duration:r=43200}){return t(e,{httpMethod:"GET",authentication:i,params:{styleFamily:s,durationSeconds:r}})}class a{constructor(t){var e;this.expirationTimerId=null,this.autoRefreshHandler=null,this.startSessionUrl=t.startSessionUrl,this.token=t.token,this.styleFamily=t.styleFamily||"arcgis",this.authentication=t.authentication,this.duration=t.duration||r,this.startTime=t.startTime,this.endTime=t.endTime,this.expires=t.expires,this.safetyMargin=t.safetyMargin,this.expirationCheckInterval=1e3*Math.min(this.duration/100,10),this.emitter={all:e=e||new Map,on:function(t,i){var s=e.get(t);s?s.push(i):e.set(t,[i])},off:function(t,i){var s=e.get(t);s&&(i?s.splice(s.indexOf(i)>>>0,1):e.set(t,[]))},emit:function(t,i){var s=e.get(t);s&&s.slice().map((function(t){t(i)})),(s=e.get("*"))&&s.slice().map((function(e){e(t,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 t=()=>{this.isSessionExpired()};return this.expirationTimerId||(this.expirationTimerId=setInterval(t,this.expirationCheckInterval)),setTimeout((()=>{t()}),10),this.expirationTimerId}stopCheckingExpirationTime(){this.expirationTimerId&&(clearInterval(this.expirationTimerId),this.expirationTimerId=null)}get checkingExpirationTime(){return!!this.expirationTimerId}static async startSession({startSessionUrl:t,styleFamily:e="arcgis",authentication:i,safetyMargin:s,duration:r=43200,autoRefresh:a=!0},o){const h=await n({startSessionUrl:t,styleFamily:e,authentication:i,duration:r}),m=function(t,e){return e||Math.min(Math.max(t/100,1),300)}(r,s),c=new o({startSessionUrl:t,token:h.sessionToken,styleFamily:e,authentication:i,safetyMargin:m,expires:new Date(h.endTime-1e3*m),startTime:new Date(h.startTime),endTime:new Date(h.endTime),duration:r});return c.startCheckingExpirationTime(),a&&c.startAutoRefresh(),c}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 t=JSON.parse(JSON.stringify({token:this.token,startTime:this.startTime,endTime:this.endTime,expires:this.expires}));try{const e=await n({startSessionUrl:this.startSessionUrl,styleFamily:this.styleFamily,authentication:this.authentication,duration:this.duration});this.setToken(e.sessionToken),this.setStartTime(new Date(e.startTime)),this.setEndTime(new Date(e.endTime)),this.setExpires(new Date(e.endTime-1e3*this.safetyMargin)),this.emitter.emit("refreshed",{previous:{token:t.token,startTime:new Date(t.startTime),endTime:new Date(t.endTime),expires:new Date(t.expires)},current:{token:this.token,startTime:this.startTime,endTime:this.endTime,expires:this.expires}})}catch(t){throw this.emitter.emit("error",t),t}return this}startAutoRefresh(){this.expirationTimerId||this.startCheckingExpirationTime(),this.autoRefreshHandler=()=>{this.refreshCredentials().catch((t=>{this.emitter.emit("error",t)}))},this.on("expired",this.autoRefreshHandler)}stopAutoRefresh(){this.autoRefreshHandler&&(this.off("expired",this.autoRefreshHandler),this.autoRefreshHandler=null)}on(t,e){this.emitter.on(t,e),this.isSessionExpired()}once(t,e){const i=s=>{this.emitter.off(t,i),e(s)};this.emitter.on(t,i)}off(t,e){this.emitter.off(t,e)}setToken(t){this.token=t}setStartTime(t){this.startTime=t}setEndTime(t){this.endTime=t}setExpires(t){this.expires=t}}
+/* istanbul ignore next -- @preserve */a.error=function(t){},
+/* istanbul ignore next -- @preserve */
+a.expired=function(t){},
+/* istanbul ignore next -- @preserve */
+a.refreshed=function(t){};class o extends a{constructor(t){super(t)}static async start(t){return a.startSession(Object.assign(Object.assign({},t),{startSessionUrl:(null==t?void 0:t.startSessionUrl)||e}),o)}}export{a as BaseSession,o as BasemapStyleSession,s as DEFAULT_CHECK_EXPIRATION_INTERVAL,r as DEFAULT_DURATION,i as DEFAULT_SAFETY_MARGIN,e as DEFAULT_START_BASEMAP_STYLE_SESSION_URL,n as startNewSession};
+//# sourceMappingURL=basemap-sessions.esm.min.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basemap-sessions.esm.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_SAFETY_MARGIN","DEFAULT_CHECK_EXPIRATION_INTERVAL","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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"}