@hook-sdk/template 0.10.0 → 0.12.0

package/dist/index.d.cts

@@ -68,6 +68,7 @@ type AppConfig = {
     onboarding?: OnboardingConfig;
     deepLinks?: DeepLinks;
     features_enabled?: string[];
+    theme?: Record<string, unknown>;
 };
 
 interface AuthScreenProps {
@@ -117,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 {
@@ -160,7 +171,9 @@ interface State {
 declare class ErrorBoundary extends Component<Props, State> {
     state: State;
     static getDerivedStateFromError(error: Error): State;
-    componentDidCatch(error: Error): void;
+    componentDidCatch(error: Error, info: {
+        componentStack: string;
+    }): void;
     render(): string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element;
 }
 
@@ -531,6 +544,8 @@ type PushUiState = {
     kind: 'subscribed';
 } | {
     kind: 'denied';
+} | {
+    kind: 'dismissed';
 } | {
     kind: 'error';
     code: string;
@@ -540,6 +555,7 @@ declare function usePush(): {
     state: PushUiState;
     subscribe: () => Promise<void>;
     unsubscribe: () => Promise<void>;
+    dismiss: () => void;
 };
 
 declare function useReminders(): {
@@ -557,7 +573,7 @@ declare function useReminders(): {
         sendAt: string | Date;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<{
         accepted: number;
         rejected: number;
@@ -569,7 +585,7 @@ declare function useReminders(): {
         slot: string;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<void>>[0]) => Promise<void>;
 };
 
@@ -717,7 +733,7 @@ type OnboardingFlowProps = {
     onComplete: (value: Record<string, unknown>) => void;
     persistKey: string;
 };
-declare function OnboardingFlow({ steps, screens, onComplete, persistKey, }: OnboardingFlowProps): react_jsx_runtime.JSX.Element;
+declare function OnboardingFlow({ steps, screens, onComplete, persistKey, }: OnboardingFlowProps): react_jsx_runtime.JSX.Element | null;
 
 type OnboardingStepCtx = {
     stepIndex: number;
@@ -815,6 +831,7 @@ declare const AppConfigSchema: z.ZodObject<{
         emailVerify: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     features_enabled: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    theme: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
 }, z.core.$strict>;
 declare function parseAppConfig(input: unknown): AppConfig;
 

package/dist/index.d.ts

@@ -68,6 +68,7 @@ type AppConfig = {
     onboarding?: OnboardingConfig;
     deepLinks?: DeepLinks;
     features_enabled?: string[];
+    theme?: Record<string, unknown>;
 };
 
 interface AuthScreenProps {
@@ -117,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 {
@@ -160,7 +171,9 @@ interface State {
 declare class ErrorBoundary extends Component<Props, State> {
     state: State;
     static getDerivedStateFromError(error: Error): State;
-    componentDidCatch(error: Error): void;
+    componentDidCatch(error: Error, info: {
+        componentStack: string;
+    }): void;
     render(): string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element;
 }
 
@@ -531,6 +544,8 @@ type PushUiState = {
     kind: 'subscribed';
 } | {
     kind: 'denied';
+} | {
+    kind: 'dismissed';
 } | {
     kind: 'error';
     code: string;
@@ -540,6 +555,7 @@ declare function usePush(): {
     state: PushUiState;
     subscribe: () => Promise<void>;
     unsubscribe: () => Promise<void>;
+    dismiss: () => void;
 };
 
 declare function useReminders(): {
@@ -557,7 +573,7 @@ declare function useReminders(): {
         sendAt: string | Date;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<{
         accepted: number;
         rejected: number;
@@ -569,7 +585,7 @@ declare function useReminders(): {
         slot: string;
         title: string;
         body: string;
-        url?: string;
+        url: string;
     }>) => Promise<void>>[0]) => Promise<void>;
 };
 
@@ -717,7 +733,7 @@ type OnboardingFlowProps = {
     onComplete: (value: Record<string, unknown>) => void;
     persistKey: string;
 };
-declare function OnboardingFlow({ steps, screens, onComplete, persistKey, }: OnboardingFlowProps): react_jsx_runtime.JSX.Element;
+declare function OnboardingFlow({ steps, screens, onComplete, persistKey, }: OnboardingFlowProps): react_jsx_runtime.JSX.Element | null;
 
 type OnboardingStepCtx = {
     stepIndex: number;
@@ -815,6 +831,7 @@ declare const AppConfigSchema: z.ZodObject<{
         emailVerify: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     features_enabled: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    theme: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
 }, z.core.$strict>;
 declare function parseAppConfig(input: unknown): AppConfig;
 

package/dist/index.js

@@ -83,7 +83,12 @@ var AppConfigSchema = z.object({
   persistedKeys: z.array(PersistedKeySchema),
   onboarding: OnboardingSchema.optional(),
   deepLinks: DeepLinksSchema.optional(),
-  features_enabled: z.array(z.string()).optional()
+  features_enabled: z.array(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: z.object({}).passthrough().optional()
 }).strict();
 function parseAppConfig(input) {
   const r = AppConfigSchema.safeParse(input);
@@ -1759,8 +1764,15 @@ var ErrorBoundary = class extends 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) {
@@ -1988,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 || "";
@@ -1998,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" };
@@ -2010,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() {
@@ -2039,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 }),
@@ -2055,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") {
@@ -2515,7 +2574,7 @@ function PreAuthShell({
 }
 
 // src/OnboardingFlow.tsx
-import { useCallback as useCallback11, useMemo as useMemo8, useRef as useRef3, useState as useState12 } from "react";
+import { useCallback as useCallback11, useMemo as useMemo8, useRef as useRef3 } from "react";
 import { usePersistedState } from "@hook-sdk/sdk";
 
 // src/hooks/useOnboardingStep.ts
@@ -2534,62 +2593,82 @@ function useOnboardingStep() {
 // src/OnboardingFlow.tsx
 import { jsx as jsx24 } from "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] = usePersistedState(persistKey, {});
-  const [idx, setIdx] = useState12(0);
+  const [draft, setDraft, status] = usePersistedState(persistKey, {});
   const draftRef = useRef3(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 = useMemo8(
-    () => (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 = useCallback11(
+    (n) => {
+      setDraft((prev) => {
+        const prevIdx = readPersistedStepIdx(prev);
+        const nextIdx = typeof n === "function" ? n(prevIdx) : n;
+        return { ...prev, [CURRENT_STEP_FIELD]: nextIdx };
+      });
+    },
+    [setDraft]
   );
   const setValue = useCallback11(
     (patch) => {
       draftRef.current = { ...draftRef.current, ...patch };
-      setDraft((prev2) => ({ ...prev2, ...patch }));
+      setDraft((prev) => ({ ...prev, ...patch }));
     },
     [setDraft]
   );
+  const step = steps[clampedIdx];
+  const valid = useMemo8(
+    () => step ? (step.validates ?? []).every((field) => isFilled(draft[field])) : false,
+    [draft, step]
+  );
   const next = useCallback11(() => {
+    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 = useCallback11(() => setIdx((i) => Math.max(0, i - 1)), []);
+  }, [clampedIdx, onComplete, step, steps.length, setIdx]);
+  const prevStep = useCallback11(() => setIdx((i) => Math.max(0, i - 1)), [setIdx]);
   const ctx = useMemo8(
     () => ({
-      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__ */ jsx24(OnboardingStepContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx24(Screen, {}) });
 }