@flamingo-stack/openframe-frontend-core 0.0.583 → 0.0.584-1967.5424.1

package/dist/utils/dismiss-cookie.d.ts

@@ -3,10 +3,15 @@
  * dismissed", shared by every dismissible surface (announcement bar, floating
  * walkthrough video, and anything added later).
  *
- * The dismissal rule is an ID MATCH, never mere cookie presence: the cookie
- * stores the id of the LAST dismissed item, so publishing a NEW item re-shows
+ * The dismissal rule is an ID MATCH, never mere cookie presence: the store
+ * holds the id of the LAST dismissed item, so publishing a NEW item re-shows
  * the surface while the old dismissal still suppresses the old item.
  *
+ * TWO TIERS. The cookie is primary wherever cookies work; on a cookie-averse
+ * document `localStorage` takes over under the same key. See `canUseCookies`
+ * for when that is, and `fallbackStore` for why it is a fallback and not a
+ * mirror.
+ *
  * No `"use client"` on purpose — `isDismissedCookieValue` is pure and is used by
  * server code (the hub's root layout reads the cookie during SSR to avoid a
  * flash); the DOM-touching helpers guard on `typeof document`.
@@ -14,14 +19,28 @@
 /** THE dismissal match rule. `undefined` id (nothing active) → not dismissed. */
 export declare function isDismissedCookieValue(cookieValue: string | undefined, id: string | undefined): boolean;
 /**
- * Read a dismissal cookie. Returns `undefined` when absent OR malformed:
- * `decodeURIComponent` throws `URIError` on bad percent-encoding, and callers
- * run this inside reveal paths where an uncaught throw would hide the surface
- * permanently. Failing open (treated as not-dismissed) is always the safe side.
+ * Read a dismissal. Returns `undefined` when absent OR unreadable — one
+ * guarantee with two causes: a cookie with bad percent-encoding, where
+ * `decodeURIComponent` throws `URIError`, and a fallback value that is not the
+ * JSON string it should be, where the adapter swallows the parse failure.
+ * Callers run this inside reveal paths where an uncaught throw would hide the
+ * surface permanently, so failing open — treated as not-dismissed — is always
+ * the safe side.
  */
 export declare function readDismissCookie(name: string): string | undefined;
-/** Persist a dismissal (cookie only, 1 year). */
+/** Persist a dismissal. */
 export declare function writeDismissCookie(name: string, id: string): void;
-/** Clear a dismissal (test/story helper). */
+/**
+ * Clear a dismissal (test/story helper).
+ *
+ * BOTH tiers, unconditionally — the tier check governs writes, not removal.
+ * Clearing writes nothing and cannot resurrect a dismissal, so it carries none
+ * of the reasons the write path commits to one tier, and a clear that leaves
+ * the other tier holding a value is a lie.
+ *
+ * NOT for a shell that changes the scheme it serves under: that is an origin
+ * change, so the old tier moves to a storage bucket no code in the new origin
+ * can reach — `clear` included.
+ */
 export declare function clearDismissCookie(name: string): void;
 //# sourceMappingURL=dismiss-cookie.d.ts.map

package/dist/utils/dismiss-cookie.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dismiss-cookie.d.ts","sourceRoot":"","sources":["../../src/utils/dismiss-cookie.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEvG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASlE;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGrD"}
+{"version":3,"file":"dismiss-cookie.d.ts","sourceRoot":"","sources":["../../src/utils/dismiss-cookie.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAyDH,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUlE;AAED,2BAA2B;AAC3B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAOjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrD"}

package/dist/utils/dismissal-storage.d.ts

@@ -15,8 +15,8 @@ export declare const WALKTHROUGH_VIDEO_DISMISS_KEY = "walkthrough-video-dismisse
  *  it once more. Deliberate and one-time: the alternative is reading both names
  *  forever to save a single re-dismissal. */
 export declare function walkthroughDismissCookieName(platform: string): string;
-/** Client-side dismissal check (id-match). Reads a cookie, so call it from an
- *  effect, never during render. */
+/** Client-side dismissal check (id-match). Reads browser storage, so call it
+ *  from an effect, never during render. */
 export declare function isWalkthroughDismissed(key: string, id: string | undefined): boolean;
 /** Persist a dismissal for this video id. */
 export declare function dismissWalkthrough(key: string, id: string): void;

package/dist/utils/dismissal-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dismissal-storage.d.ts","sourceRoot":"","sources":["../../src/utils/dismissal-storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAwB;AACxB,eAAO,MAAM,6BAA6B,gCAAgC,CAAC;AAE3E;;;;;;;;6CAQ6C;AAC7C,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;mCACmC;AACnC,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnF;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3D"}
+{"version":3,"file":"dismissal-storage.d.ts","sourceRoot":"","sources":["../../src/utils/dismissal-storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAwB;AACxB,eAAO,MAAM,6BAA6B,gCAAgC,CAAC;AAE3E;;;;;;;;6CAQ6C;AAC7C,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;2CAC2C;AAC3C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnF;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3D"}

package/dist/utils/index.cjs

@@ -2569,13 +2569,78 @@ function isGenericWebsiteDomain(website) {
   return isGenericDomain(normalizeDomain(website));
 }
 
+// src/utils/local-storage-adapter.ts
+function getStorage(backend) {
+  if (typeof window === "undefined") return null;
+  try {
+    return backend === "session" ? window.sessionStorage : window.localStorage;
+  } catch {
+    return null;
+  }
+}
+function createLocalStorageAdapter(options) {
+  const tag = options.logTag ?? "[local-storage]";
+  const backend = options.backend ?? "local";
+  const resolveKey = () => {
+    const ns = options.namespace?.();
+    return ns ? `${ns}.${options.key}` : options.key;
+  };
+  return {
+    resolveKey,
+    load() {
+      const storage = getStorage(backend);
+      if (!storage) return null;
+      try {
+        const raw = storage.getItem(resolveKey());
+        if (!raw) return null;
+        const parsed = JSON.parse(raw);
+        if (options.validate && !options.validate(parsed)) return null;
+        return parsed;
+      } catch (err) {
+        console.warn(`${tag} parse failed for key ${resolveKey()}:`, err);
+        return null;
+      }
+    },
+    save(value) {
+      const storage = getStorage(backend);
+      if (!storage) return;
+      try {
+        storage.setItem(resolveKey(), JSON.stringify(value));
+      } catch (err) {
+        console.warn(`${tag} write failed for key ${resolveKey()}:`, err);
+      }
+    },
+    clear() {
+      const storage = getStorage(backend);
+      if (!storage) return;
+      try {
+        storage.removeItem(resolveKey());
+      } catch (err) {
+        console.warn(`${tag} clear failed for key ${resolveKey()}:`, err);
+      }
+    }
+  };
+}
+
 // src/utils/dismiss-cookie.ts
 var DISMISS_COOKIE_MAX_AGE_SECONDS = 31536e3;
+function canUseCookies() {
+  if (typeof document === "undefined") return false;
+  return document.URL.startsWith("http:") || document.URL.startsWith("https:");
+}
+function fallbackStore(name) {
+  return createLocalStorageAdapter({
+    key: name,
+    logTag: "[dismiss-cookie]",
+    validate: (parsed) => typeof parsed === "string"
+  });
+}
 function isDismissedCookieValue(cookieValue, id) {
   return !!id && cookieValue === id;
 }
 function readDismissCookie(name) {
   if (typeof document === "undefined") return void 0;
+  if (!canUseCookies()) return fallbackStore(name).load() ?? void 0;
   const match = document.cookie.split("; ").find((row) => row.startsWith(`${name}=`));
   if (!match) return void 0;
   try {
@@ -2586,10 +2651,15 @@ function readDismissCookie(name) {
 }
 function writeDismissCookie(name, id) {
   if (typeof document === "undefined") return;
+  if (!canUseCookies()) {
+    fallbackStore(name).save(id);
+    return;
+  }
   document.cookie = `${name}=${encodeURIComponent(id)}; path=/; max-age=${DISMISS_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;
 }
 function clearDismissCookie(name) {
   if (typeof document === "undefined") return;
+  fallbackStore(name).clear();
   document.cookie = `${name}=; path=/; max-age=0`;
 }
 
@@ -2925,59 +2995,6 @@ function getAppType() {
   }
 }
 
-// src/utils/local-storage-adapter.ts
-function getStorage(backend) {
-  if (typeof window === "undefined") return null;
-  try {
-    return backend === "session" ? window.sessionStorage : window.localStorage;
-  } catch {
-    return null;
-  }
-}
-function createLocalStorageAdapter(options) {
-  const tag = options.logTag ?? "[local-storage]";
-  const backend = options.backend ?? "local";
-  const resolveKey = () => {
-    const ns = options.namespace?.();
-    return ns ? `${ns}.${options.key}` : options.key;
-  };
-  return {
-    resolveKey,
-    load() {
-      const storage = getStorage(backend);
-      if (!storage) return null;
-      try {
-        const raw = storage.getItem(resolveKey());
-        if (!raw) return null;
-        const parsed = JSON.parse(raw);
-        if (options.validate && !options.validate(parsed)) return null;
-        return parsed;
-      } catch (err) {
-        console.warn(`${tag} parse failed for key ${resolveKey()}:`, err);
-        return null;
-      }
-    },
-    save(value) {
-      const storage = getStorage(backend);
-      if (!storage) return;
-      try {
-        storage.setItem(resolveKey(), JSON.stringify(value));
-      } catch (err) {
-        console.warn(`${tag} write failed for key ${resolveKey()}:`, err);
-      }
-    },
-    clear() {
-      const storage = getStorage(backend);
-      if (!storage) return;
-      try {
-        storage.removeItem(resolveKey());
-      } catch (err) {
-        console.warn(`${tag} clear failed for key ${resolveKey()}:`, err);
-      }
-    }
-  };
-}
-
 // src/utils/embed-proxy-auth-storage.ts
 function isValidPersistedAuth(value) {
   if (!value || typeof value !== "object") return false;