@hot-updater/console 0.33.0 → 0.33.2

package/.output/server/_libs/tanstack__history.mjs

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@tanstack+history@1.161.4/node_modules/@tanstack/history/dist/esm/index.js
+//#region ../../node_modules/.pnpm/@tanstack+history@1.162.0/node_modules/@tanstack/history/dist/esm/index.js
 var stateIndexKey = "__TSR_index";
 var popStateEvent = "popstate";
 var beforeUnloadEvent = "beforeunload";
@@ -118,8 +118,8 @@ function createHistory(opts) {
 			const blockers = opts.getBlockers?.() ?? [];
 			opts.setBlockers([...blockers, blocker]);
 			return () => {
-				const blockers2 = opts.getBlockers?.() ?? [];
-				opts.setBlockers?.(blockers2.filter((b) => b !== blocker));
+				const blockers = opts.getBlockers?.() ?? [];
+				opts.setBlockers?.(blockers.filter((b) => b !== blocker));
 			};
 		},
 		flush: () => opts.flush?.(),
@@ -137,6 +137,22 @@ function assignKeyAndIndex(index, state) {
 		[stateIndexKey]: index
 	};
 }
+/**
+* Creates a history object that can be used to interact with the browser's
+* navigation. This is a lightweight API wrapping the browser's native methods.
+* It is designed to work with TanStack Router, but could be used as a standalone API as well.
+* IMPORTANT: This API implements history throttling via a microtask to prevent
+* excessive calls to the history API. In some browsers, calling history.pushState or
+* history.replaceState in quick succession can cause the browser to ignore subsequent
+* calls. This API smooths out those differences and ensures that your application
+* state will *eventually* match the browser state. In most cases, this is not a problem,
+* but if you need to ensure that the browser state is up to date, you can use the
+* `history.flush` method to immediately flush all pending state changes to the browser URL.
+* @param opts
+* @param opts.getHref A function that returns the current href (path + search + hash)
+* @param opts.createHref A function that takes a path and returns a href (path + search + hash)
+* @returns A history instance
+*/
 function createBrowserHistory(opts) {
 	const win = opts?.window ?? (typeof document !== "undefined" ? window : void 0);
 	const originalPushState = win.history.pushState;
@@ -205,9 +221,9 @@ function createBrowserHistory(opts) {
 		} : { type: isBack ? "BACK" : "FORWARD" };
 		if (skipBlockerNextPop) skipBlockerNextPop = false;
 		else {
-			const blockers2 = _getBlockers();
-			if (typeof document !== "undefined" && blockers2.length) {
-				for (const blocker of blockers2) if (await blocker.blockerFn({
+			const blockers = _getBlockers();
+			if (typeof document !== "undefined" && blockers.length) {
+				for (const blocker of blockers) if (await blocker.blockerFn({
 					currentLocation,
 					nextLocation,
 					action
@@ -228,8 +244,8 @@ function createBrowserHistory(opts) {
 			return;
 		}
 		let shouldBlock = false;
-		const blockers2 = _getBlockers();
-		if (typeof document !== "undefined" && blockers2.length) for (const blocker of blockers2) {
+		const blockers = _getBlockers();
+		if (typeof document !== "undefined" && blockers.length) for (const blocker of blockers) {
 			const shouldHaveBeforeUnload = blocker.enableBeforeUnload ?? true;
 			if (shouldHaveBeforeUnload === true) {
 				shouldBlock = true;
@@ -293,6 +309,10 @@ function createBrowserHistory(opts) {
 	};
 	return history;
 }
+/**
+* Sanitize a path to prevent open redirect vulnerabilities.
+* Removes control characters and collapses leading double slashes.
+*/
 function sanitizePath(path) {
 	let sanitized = path.replace(/[\x00-\x1f\x7f]/g, "");
 	if (sanitized.startsWith("//")) sanitized = "/" + sanitized.replace(/^\/+/, "");