@hook-sdk/template 0.10.0 → 0.12.0

package/dist/index.cjs

@@ -153,7 +153,12 @@ var AppConfigSchema = import_zod.z.object({
   persistedKeys: import_zod.z.array(PersistedKeySchema),
   onboarding: OnboardingSchema.optional(),
   deepLinks: DeepLinksSchema.optional(),
-  features_enabled: import_zod.z.array(import_zod.z.string()).optional()
+  features_enabled: import_zod.z.array(import_zod.z.string()).optional(),
+  // Build-time injected theme metadata (e.g. icon_url for InstallSplash).
+  // Apps don't author this directly; deploy workflows fill it from
+  // env-resolved bundle host. Permissive shape so apps/workflows can
+  // extend without re-bumping the template schema.
+  theme: import_zod.z.object({}).passthrough().optional()
 }).strict();
 function parseAppConfig(input) {
   const r = AppConfigSchema.safeParse(input);
@@ -1829,8 +1834,15 @@ var ErrorBoundary = class extends import_react9.Component {
   static getDerivedStateFromError(error) {
     return { error };
   }
-  componentDidCatch(error) {
-    console.error("[ErrorBoundary] caught", error);
+  componentDidCatch(error, info) {
+    console.error(
+      "[ErrorBoundary] caught:",
+      error?.message || "(no message)",
+      "\nstack:",
+      error?.stack || "(no stack)",
+      "\ncomponentStack:",
+      info?.componentStack || "(no componentStack)"
+    );
   }
   render() {
     if (this.state.error) {
@@ -2058,6 +2070,8 @@ function FallbackPaywall() {
 // src/hooks/usePush.ts
 var import_react12 = require("react");
 var import_sdk5 = require("@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 || "";
@@ -2068,6 +2082,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" };
@@ -2080,6 +2109,7 @@ function deriveState(push) {
     if (detectIosNeedsInstall()) return { kind: "ios_needs_install" };
     return { kind: "unsupported" };
   }
+  if (isDismissedNow()) return { kind: "dismissed" };
   return { kind: "prompt" };
 }
 function usePush() {
@@ -2109,14 +2139,41 @@ function usePush() {
       throw e;
     }
   }, [push]);
-  return { state, subscribe, unsubscribe };
+  const dismiss = (0, import_react12.useCallback)(() => {
+    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
 var import_jsx_runtime19 = require("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__ */ (0, import_jsx_runtime19.jsxs)("div", { className, role: "region", "aria-label": texts.iosInstallTitle, children: [
       /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("h3", { children: texts.iosInstallTitle }),
@@ -2125,9 +2182,11 @@ function PushPrompt2({ texts, onSubscribed, onDeclined, onInstallRequested, clas
     ] });
   }
   if (state.kind === "denied") {
+    const recovery = platformRecoveryCopy(texts);
     return /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)("div", { className, role: "region", "aria-label": texts.deniedTitle, children: [
       /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("h3", { children: texts.deniedTitle }),
-      /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("p", { children: texts.deniedBody })
+      /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("p", { children: texts.deniedBody }),
+      recovery && /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("p", { "data-testid": "denied-recovery", children: recovery })
     ] });
   }
   if (state.kind === "unsupported") {
@@ -2604,62 +2663,82 @@ function useOnboardingStep() {
 // src/OnboardingFlow.tsx
 var import_jsx_runtime24 = require("react/jsx-runtime");
 var isFilled = (v) => v != null && v !== "";
+var CURRENT_STEP_FIELD = "currentStep";
+function readPersistedStepIdx(draft) {
+  const raw = draft[CURRENT_STEP_FIELD];
+  return typeof raw === "number" && Number.isFinite(raw) && raw >= 0 ? raw : 0;
+}
 function OnboardingFlow({
   steps,
   screens,
   onComplete,
   persistKey
 }) {
-  const [draft, setDraft] = (0, import_sdk16.usePersistedState)(persistKey, {});
-  const [idx, setIdx] = (0, import_react21.useState)(0);
+  const [draft, setDraft, status] = (0, import_sdk16.usePersistedState)(persistKey, {});
   const draftRef = (0, import_react21.useRef)(draft);
   draftRef.current = draft;
-  const step = steps[idx];
-  if (!step) {
-    throw new Error(
-      `[hook-template] OnboardingFlow: step index ${idx} out of range (steps.length=${steps.length})`
-    );
-  }
-  const Screen = screens[step.screen];
-  if (!Screen) {
-    throw new Error(
-      `[hook-template] OnboardingFlow: missing screen component for step '${step.id}' (expected key '${step.screen}' in screens prop)`
-    );
-  }
-  const valid = (0, import_react21.useMemo)(
-    () => (step.validates ?? []).every((field) => isFilled(draft[field])),
-    [draft, step]
+  const idx = readPersistedStepIdx(draft);
+  const clampedIdx = Math.min(Math.max(idx, 0), Math.max(steps.length - 1, 0));
+  const setIdx = (0, import_react21.useCallback)(
+    (n) => {
+      setDraft((prev) => {
+        const prevIdx = readPersistedStepIdx(prev);
+        const nextIdx = typeof n === "function" ? n(prevIdx) : n;
+        return { ...prev, [CURRENT_STEP_FIELD]: nextIdx };
+      });
+    },
+    [setDraft]
   );
   const setValue = (0, import_react21.useCallback)(
     (patch) => {
       draftRef.current = { ...draftRef.current, ...patch };
-      setDraft((prev2) => ({ ...prev2, ...patch }));
+      setDraft((prev) => ({ ...prev, ...patch }));
     },
     [setDraft]
   );
+  const step = steps[clampedIdx];
+  const valid = (0, import_react21.useMemo)(
+    () => step ? (step.validates ?? []).every((field) => isFilled(draft[field])) : false,
+    [draft, step]
+  );
   const next = (0, import_react21.useCallback)(() => {
+    if (!step) return;
     const current = draftRef.current;
     const validNow = (step.validates ?? []).every((field) => isFilled(current[field]));
     if (!validNow) return;
-    if (idx + 1 >= steps.length) {
+    if (clampedIdx + 1 >= steps.length) {
       onComplete(current);
     } else {
-      setIdx(idx + 1);
+      setIdx(clampedIdx + 1);
     }
-  }, [idx, onComplete, step, steps.length]);
-  const prev = (0, import_react21.useCallback)(() => setIdx((i) => Math.max(0, i - 1)), []);
+  }, [clampedIdx, onComplete, step, steps.length, setIdx]);
+  const prevStep = (0, import_react21.useCallback)(() => setIdx((i) => Math.max(0, i - 1)), [setIdx]);
   const ctx = (0, import_react21.useMemo)(
     () => ({
-      stepIndex: idx,
+      stepIndex: clampedIdx,
       totalSteps: steps.length,
       value: draft,
       setValue,
       valid,
       next,
-      prev
+      prev: prevStep
     }),
-    [idx, steps.length, draft, setValue, valid, next, prev]
+    [clampedIdx, steps.length, draft, setValue, valid, next, prevStep]
   );
+  if (status.loading) {
+    return null;
+  }
+  if (!step) {
+    throw new Error(
+      `[hook-template] OnboardingFlow: step index ${clampedIdx} out of range (steps.length=${steps.length})`
+    );
+  }
+  const Screen = screens[step.screen];
+  if (!Screen) {
+    throw new Error(
+      `[hook-template] OnboardingFlow: missing screen component for step '${step.id}' (expected key '${step.screen}' in screens prop)`
+    );
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(OnboardingStepContext.Provider, { value: ctx, children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(Screen, {}) });
 }