@hexclave/next 1.0.49 → 1.0.52

package/src/utils/session-storage.ts

@@ -0,0 +1,45 @@
+
+//===========================================
+// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template
+//===========================================
+/**
+ * Guarded sessionStorage access for resilience layers (redirect loop breaking, redirect-back state
+ * mirroring). These layers must degrade to "no stored value" when storage is unavailable, instead
+ * of breaking the auth flow they are trying to protect.
+ */
+
+export function readSessionStorageItem(key: string): string | null {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  try {
+    return window.sessionStorage.getItem(key);
+  } catch {
+    // Storage can be blocked entirely (private browsing, sandboxed iframes, disabled cookies), in
+    // which case accessing window.sessionStorage throws. Treat that as "nothing stored".
+    return null;
+  }
+}
+
+export function writeSessionStorageItem(key: string, value: string): void {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    window.sessionStorage.setItem(key, value);
+  } catch {
+    // Storage can be blocked or full; see readSessionStorageItem. Values written here are only
+    // used as a fallback, so failing to persist must not fail the caller.
+  }
+}
+
+export function removeSessionStorageItem(key: string): void {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    window.sessionStorage.removeItem(key);
+  } catch {
+    // See readSessionStorageItem.
+  }
+}