@mundogamernetwork/shared-ui 1.8.22 → 1.9.0

package/utils/embargo.ts

@@ -3,20 +3,49 @@
  *
  * An embargo is a day AND a time: "August 12" alone is not something a creator
  * can comply with — publishing at 09:00 or at 23:00 on that day are very
- * different acts. The API stores `embargo_date` as an instant (UTC) plus the
- * `embargo_timezone` the campaign creator confirmed it in.
+ * different acts.
  *
- * Both matter to the creator, so both are shown: the campaign's own wall-clock
- * (how the studio communicates the embargo everywhere else) and, when the
- * viewer is somewhere else, the same instant on their own clock — so nobody has
- * to do timezone arithmetic to know when they may publish.
+ * Both clocks matter to the creator, so both are shown: the campaign's own
+ * wall-clock (how the studio communicates the embargo everywhere else) and,
+ * when the viewer is somewhere else, the same instant on their own clock — so
+ * nobody has to do timezone arithmetic to know when they may publish.
+ *
+ * The *instant and the zone* come from the API's `embargo_display` block rather
+ * than from the raw `embargo_date`/`embargo_timezone` columns, so every client
+ * agrees on which moment is being described — the mobile app cannot name a zone
+ * itself (Dart ships no timezone database) and reads the server's rendering.
+ * `campaign_zone` there is already resolved: an unusable stored value has been
+ * collapsed to UTC server-side instead of reaching the formatter.
+ *
+ * The *formatting* stays here on purpose. Rendering the server's pre-built
+ * string would freeze the text in whatever locale the payload was fetched
+ * under, so switching language would leave a stale line until a refetch;
+ * Intl re-runs on every locale change.
  */
 
+/** The API's `embargo_display` block. Null/absent means: no embargo. */
+export interface EmbargoDisplay {
+	utc: string
+	campaign_zone: string
+	campaign_zone_label?: string | null
+	campaign_offset?: string | null
+	campaign_wall_clock?: string | null
+	locale?: string | null
+}
+
+type MaybeEmbargo = EmbargoDisplay | null | undefined
+
+/** The embargo instant, or null when there is none / it is unparseable. */
+function instantOf(display: MaybeEmbargo): Date | null {
+	if (!display?.utc) return null
+	const date = new Date(display.utc)
+	return isNaN(date.getTime()) ? null : date
+}
+
 /** True while the embargo is set and has not lifted yet. */
-export function isEmbargoActive(dateString: string | null | undefined): boolean {
-	if (!dateString) return false
-	const date = new Date(dateString)
-	return !isNaN(date.getTime()) && date.getTime() > Date.now()
+export function isEmbargoActive(display: MaybeEmbargo): boolean {
+	const date = instantOf(display)
+	return date !== null && date.getTime() > Date.now()
 }
 
 /**
@@ -27,11 +56,12 @@ export function isEmbargoActive(dateString: string | null | undefined): boolean
  * Returns "" once the embargo has lifted (or when there is none).
  */
 export function formatEmbargoCountdown(
-	dateString: string | null | undefined,
+	display: MaybeEmbargo,
 	locale: string,
 ): string {
-	if (!isEmbargoActive(dateString)) return ""
-	const diffMs = new Date(dateString as string).getTime() - Date.now()
+	const date = instantOf(display)
+	if (!date || date.getTime() <= Date.now()) return ""
+	const diffMs = date.getTime() - Date.now()
 
 	const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" })
 	const minutes = Math.round(diffMs / 60000)
@@ -88,14 +118,13 @@ function dayIn(date: Date, timeZone?: string): string {
  * Returns "" for a missing/invalid date so callers can `v-if` on it.
  */
 export function formatEmbargoDateTime(
-	dateString: string | null | undefined,
-	timezone: string | null | undefined,
+	display: MaybeEmbargo,
 	locale: string,
 ): string {
-	if (!dateString) return ""
-	const date = new Date(dateString)
-	if (isNaN(date.getTime())) return ""
+	const date = instantOf(display)
+	if (!date) return ""
 
+	const timezone = display?.campaign_zone
 	const viewerZone = Intl.DateTimeFormat().resolvedOptions().timeZone
 
 	if (!timezone || timezone === viewerZone) {

package/utils/navigation.ts

@@ -0,0 +1,26 @@
+/**
+ * Go back without falling out of the app.
+ *
+ * `window.history.length > 1` is the wrong test: it counts the whole tab
+ * session, so a user who landed here from a Google result has length 2 and
+ * `history.back()` returns them to Google. Same for an email link, a Discord
+ * link, or anything else external.
+ *
+ * Vue Router records the previous in-app entry in `history.state.back`. It is
+ * only set when the navigation happened inside the SPA, which is exactly the
+ * condition under which going back is safe. Anything else falls through to an
+ * explicit route.
+ */
+export function goBackWithin(fallbackPath: string): void {
+	if (typeof window === "undefined") return
+
+	const router = useRouter()
+	const previous = (router.options.history.state as Record<string, unknown> | undefined)?.back
+
+	if (typeof previous === "string" && previous.length > 0) {
+		router.back()
+		return
+	}
+
+	navigateTo(fallbackPath)
+}