@hook-sdk/template 0.10.0 → 0.11.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 {
@@ -160,7 +161,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;
 }
 
@@ -717,7 +720,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 +818,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 {
@@ -160,7 +161,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;
 }
 
@@ -717,7 +720,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 +818,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) {
@@ -2515,7 +2527,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 +2546,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, {}) });
 }