@hook-sdk/template 0.10.0 → 0.11.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) {
@@ -2604,62 +2616,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, {}) });
 }