@hook-sdk/template 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -118,6 +118,16 @@ interface PushPromptTexts {
     iosInstallCta?: string;
     deniedTitle: string;
     deniedBody: string;
+    /**
+     * Audit Wave 3 — Fix #33: per-platform recovery copy shown when permission
+     * is denied. All four are optional; if the matching platform's copy is
+     * missing the recovery paragraph is omitted (back-compat for callers that
+     * haven't supplied them yet).
+     */
+    deniedRecoveryIos?: string;
+    deniedRecoveryAndroid?: string;
+    deniedRecoveryDesktop?: string;
+    deniedRecoveryInApp?: string;
     unsupportedBody: string;
 }
 interface PushPromptProps {
@@ -534,6 +544,8 @@ type PushUiState = {
     kind: 'subscribed';
 } | {
     kind: 'denied';
+} | {
+    kind: 'dismissed';
 } | {
     kind: 'error';
     code: string;
@@ -543,6 +555,7 @@ declare function usePush(): {
     state: PushUiState;
     subscribe: () => Promise<void>;
     unsubscribe: () => Promise<void>;
+    dismiss: () => void;
 };
 
 declare function useReminders(): {
@@ -560,7 +573,7 @@ declare function useReminders(): {
         sendAt: string | Date;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<{
         accepted: number;
         rejected: number;
@@ -572,7 +585,7 @@ declare function useReminders(): {
         slot: string;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<void>>[0]) => Promise<void>;
 };
 

package/dist/index.d.ts

@@ -118,6 +118,16 @@ interface PushPromptTexts {
     iosInstallCta?: string;
     deniedTitle: string;
     deniedBody: string;
+    /**
+     * Audit Wave 3 — Fix #33: per-platform recovery copy shown when permission
+     * is denied. All four are optional; if the matching platform's copy is
+     * missing the recovery paragraph is omitted (back-compat for callers that
+     * haven't supplied them yet).
+     */
+    deniedRecoveryIos?: string;
+    deniedRecoveryAndroid?: string;
+    deniedRecoveryDesktop?: string;
+    deniedRecoveryInApp?: string;
     unsupportedBody: string;
 }
 interface PushPromptProps {
@@ -534,6 +544,8 @@ type PushUiState = {
     kind: 'subscribed';
 } | {
     kind: 'denied';
+} | {
+    kind: 'dismissed';
 } | {
     kind: 'error';
     code: string;
@@ -543,6 +555,7 @@ declare function usePush(): {
     state: PushUiState;
     subscribe: () => Promise<void>;
     unsubscribe: () => Promise<void>;
+    dismiss: () => void;
 };
 
 declare function useReminders(): {
@@ -560,7 +573,7 @@ declare function useReminders(): {
         sendAt: string | Date;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<{
         accepted: number;
         rejected: number;
@@ -572,7 +585,7 @@ declare function useReminders(): {
         slot: string;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<void>>[0]) => Promise<void>;
 };
 

package/dist/index.js

@@ -2000,6 +2000,8 @@ function FallbackPaywall() {
 // src/hooks/usePush.ts
 import { useCallback as useCallback4, useEffect as useEffect6, useState as useState5 } from "react";
 import { useHook as useHook5 } from "@hook-sdk/sdk";
+var DISMISS_STORAGE_KEY = "push:dismissed-until";
+var DISMISS_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
 function detectIosNeedsInstall() {
   if (typeof navigator === "undefined" || typeof window === "undefined") return false;
   const ua = navigator.userAgent || "";
@@ -2010,6 +2012,21 @@ function detectIosNeedsInstall() {
   const legacyStandalone = typeof navigator.standalone === "boolean" ? navigator.standalone : false;
   return !(standalone || legacyStandalone);
 }
+function readDismissedUntil() {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const raw = localStorage.getItem(DISMISS_STORAGE_KEY);
+    if (raw === null) return null;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : null;
+  } catch {
+    return null;
+  }
+}
+function isDismissedNow() {
+  const until = readDismissedUntil();
+  return until !== null && until > Date.now();
+}
 function deriveState(push) {
   if (!push.isAvailable()) {
     if (detectIosNeedsInstall()) return { kind: "ios_needs_install" };
@@ -2022,6 +2039,7 @@ function deriveState(push) {
     if (detectIosNeedsInstall()) return { kind: "ios_needs_install" };
     return { kind: "unsupported" };
   }
+  if (isDismissedNow()) return { kind: "dismissed" };
   return { kind: "prompt" };
 }
 function usePush() {
@@ -2051,14 +2069,41 @@ function usePush() {
       throw e;
     }
   }, [push]);
-  return { state, subscribe, unsubscribe };
+  const dismiss = useCallback4(() => {
+    if (typeof localStorage !== "undefined") {
+      try {
+        localStorage.setItem(DISMISS_STORAGE_KEY, String(Date.now() + DISMISS_TTL_MS));
+      } catch {
+      }
+    }
+    setState({ kind: "dismissed" });
+  }, []);
+  return { state, subscribe, unsubscribe, dismiss };
 }
 
 // src/components/PushPrompt.tsx
 import { jsx as jsx19, jsxs as jsxs14 } from "react/jsx-runtime";
+function platformRecoveryCopy(texts) {
+  if (typeof navigator === "undefined") return null;
+  const ua = navigator.userAgent || "";
+  const platform = detectPlatform(ua);
+  switch (platform) {
+    case "ios-safari":
+    case "ios-other":
+      return texts.deniedRecoveryIos ?? null;
+    case "android":
+      return texts.deniedRecoveryAndroid ?? null;
+    case "desktop":
+      return texts.deniedRecoveryDesktop ?? null;
+    case "in-app":
+      return texts.deniedRecoveryInApp ?? null;
+    default:
+      return null;
+  }
+}
 function PushPrompt2({ texts, onSubscribed, onDeclined, onInstallRequested, className }) {
   const { state, subscribe } = usePush();
-  if (state.kind === "subscribed") return null;
+  if (state.kind === "subscribed" || state.kind === "dismissed") return null;
   if (state.kind === "ios_needs_install") {
     return /* @__PURE__ */ jsxs14("div", { className, role: "region", "aria-label": texts.iosInstallTitle, children: [
       /* @__PURE__ */ jsx19("h3", { children: texts.iosInstallTitle }),
@@ -2067,9 +2112,11 @@ function PushPrompt2({ texts, onSubscribed, onDeclined, onInstallRequested, clas
     ] });
   }
   if (state.kind === "denied") {
+    const recovery = platformRecoveryCopy(texts);
     return /* @__PURE__ */ jsxs14("div", { className, role: "region", "aria-label": texts.deniedTitle, children: [
       /* @__PURE__ */ jsx19("h3", { children: texts.deniedTitle }),
-      /* @__PURE__ */ jsx19("p", { children: texts.deniedBody })
+      /* @__PURE__ */ jsx19("p", { children: texts.deniedBody }),
+      recovery && /* @__PURE__ */ jsx19("p", { "data-testid": "denied-recovery", children: recovery })
     ] });
   }
   if (state.kind === "unsupported") {