@wix/himalaya-cli 0.1024.0 → 0.1026.0

package/templates/branded-lite/tier5-src/_shared/detail-presence.ts

@@ -0,0 +1,51 @@
+// Whether a detail screen's entity is there — the worker half of the shared not-found
+// state (the `detailNotFound` descriptor builder).
+//
+// A detail screen's descriptor asks two questions, both as `hiddenWhen` flags:
+//   • `noEntity`     → hide the entity's content AND its actions (Like, Follow, Send…)
+//   • `hideNotFound` → hide the not-found state
+// Four answers exist, and only one of them shows the not-found state:
+//   loading  — a loading line (`hideLoading` false); no content, no actions, no verdict
+//   found    — content + actions shown
+//   missing  — not-found shown, content + actions hidden
+//   failed   — a load-error line (`hideLoadError` false); no content, no actions
+// A load that FAILS for any reason other than "not found" is `failed`, never `missing`:
+// an offline device must not tell the user their invoice was deleted.
+
+export type Presence = "loading" | "found" | "missing" | "failed";
+
+export interface PresenceFlags {
+  found: boolean;
+  notFound: boolean;
+  noEntity: boolean;
+  hideNotFound: boolean;
+  hideLoading: boolean;
+  hideLoadError: boolean;
+}
+
+export function presence(p: Presence): PresenceFlags {
+  return {
+    found: p === "found", notFound: p === "missing", noEntity: p !== "found", hideNotFound: p !== "missing",
+    hideLoading: p !== "loading", hideLoadError: p !== "failed",
+  };
+}
+
+/** The entity id the host baked into this detail screen (`himi.open` params). */
+export function detailInputId(): string {
+  const v = (globalThis as { himalaya?: { input?: { id?: unknown } } }).himalaya?.input?.id;
+  return typeof v === "string" ? v.trim() : "";
+}
+
+/** True when a Wix read failed because the record does not exist: the SDK rejects
+ *  with "HTTP <code>: <body>", so an HTTP 404, or Wix's `NOT_FOUND` error code. A bare
+ *  "not found" in a message is NOT enough — "capability wix_api not found" or "Method
+ *  not found" is a broken integration, and must not tell the user the record is gone. */
+export function isNotFoundError(error: unknown): boolean {
+  const msg = String((error as { message?: unknown } | null)?.message ?? error ?? "");
+  return /\bHTTP\s*404\b/.test(msg) || /\bNOT_FOUND\b/.test(msg);
+}
+
+/** `missing` for a not-found failure, `failed` (claim nothing) otherwise. */
+export function presenceAfterError(error: unknown): PresenceFlags {
+  return presence(isNotFoundError(error) ? "missing" : "failed");
+}

package/templates/branded-lite/tier5-src/himi-branded-lite-orders/index.ts

@@ -54,6 +54,7 @@ interface State {
   noEmpty: boolean;
   hideList: boolean;
   needsSignIn?: boolean;
+  noSignIn?: boolean;
   nextCursor?: string;
   complete?: boolean;
   pageError?: boolean;
@@ -127,7 +128,9 @@ function derive(state: State): State {
     notLoading: state.status !== "loading",
     isErrored: state.status === "error",
     notErrored: state.status !== "error",
-    noEmpty: state.status !== "ready" || hasRows,
+    // A guest gets the shared member gate, not the "Browse products" empty card.
+    noEmpty: state.status !== "ready" || hasRows || state.needsSignIn === true,
+    noSignIn: state.status !== "ready" || state.needsSignIn !== true,
     hideList: state.status !== "ready" || state.needsSignIn === true,
   };
 }

package/templates/branded-lite/tier5-src/himi-branded-lite-portfolio-project/index.ts

@@ -5,6 +5,7 @@ import { defineService } from "@himalaya/state";
 import { listProjectItems, listProjects, type WixPortfolioProjectItem } from "@himalaya/wix-portfolio";
 import { wixMediaUrl, WIX_DETAIL_IMAGE } from "@himalaya/wix-media";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
+import { presence, type PresenceFlags } from "../_shared/detail-presence.js";
 
 interface MediaRow {
   id: string;
@@ -20,7 +21,7 @@ interface MediaRow {
   noMedia: boolean;
 }
 
-interface State {
+interface State extends PresenceFlags {
   status: "loading" | "ready" | "error";
   id: string;
   title: string;
@@ -99,6 +100,9 @@ function unavailableProject(state: State, status: "ready" | "error", id: string,
     coverImage: "",
     items: [],
     emptyText,
+    // A project that is not there is `missing`; one that failed to load is not — the
+    // error card speaks, and nothing claims the project was removed.
+    ...presence(status === "ready" ? "missing" : "failed"),
   });
 }
 
@@ -106,7 +110,7 @@ const svc = defineService<State, { load: (state: State, arg?: unknown) => Promis
   state: derive({
     status: "loading", id: "", title: "", initial: "", description: "", coverImage: "", items: [], emptyText: "",
     isLoading: true, notLoading: false, isErrored: false, notErrored: true,
-    hasCover: false, noCover: true, hasItems: false, noItems: true, hideContent: true, noEmpty: true,
+    hasCover: false, noCover: true, hasItems: false, noItems: true, hideContent: true, noEmpty: true, ...presence("loading"),
   }),
   actions: {
     load: async (state, arg) => {
@@ -132,6 +136,7 @@ const svc = defineService<State, { load: (state: State, arg?: unknown) => Promis
           coverImage: wixMediaUrl(project.coverImage || "", WIX_DETAIL_IMAGE),
           items,
           emptyText: items.length ? "" : copyParam("portfolioProject.noMediaText", "This project has no published media yet."),
+          ...presence("found"),
         });
       } catch {
         return unavailableProject(state, "error", id, copyParam("portfolioProject.errorText", "This project could not be loaded. Try again."));

package/templates/branded-lite/tier5-src/himi-branded-lite-simple-detail/index.ts

@@ -13,8 +13,9 @@
 // a no-op action wired to CTAs so those buttons are truthful rather than
 // silently absent capability).
 import { defineService } from "@himalaya/state";
+import { presence, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S {
+interface S extends PresenceFlags {
   status: "ready";
   id: string;
   name: string;
@@ -39,11 +40,11 @@ const svc = defineService<S, {
   load: (s: S) => S;
   touch: (s: S, arg?: unknown) => S;
 }>("himiBrandedSimpleDetail", {
-  state: { status: "ready", id: "", name: "", subtitle: "", hasId: false, noId: true, hint: "" },
+  state: { status: "ready", id: "", name: "", subtitle: "", hasId: false, noId: true, hint: "", ...presence("loading") },
   actions: {
     load: (s) => {
       const id = inputStr("id");
-      return { ...s, id, name: inputStr("name"), subtitle: inputStr("subtitle"), hasId: !!id, noId: !id, hint: "" };
+      return { ...s, id, name: inputStr("name"), subtitle: inputStr("subtitle"), hasId: !!id, noId: !id, hint: "", ...presence(id ? "found" : "missing") };
     },
     touch: (s, arg) => {
       const kind = (arg && typeof arg === "object" ? (arg as { kind?: string }).kind : typeof arg === "string" ? arg : undefined) ?? "";

package/templates/branded-lite/tier5-src/wix-spaces-chat-thread/index.ts

@@ -7,12 +7,13 @@ import { defineService } from "@himalaya/state";
 import { getMessages, sendChatMessage, getOrCreateDirectChatroom, type ChatMessage } from "@himalaya/wix-chat-web";
 import { getMyData } from "@himalaya/wix-users";
 import { formatMonthDayTime } from "../_shared/engine-intl.js";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
 // leadFill gates a per-row right-align: " " for MY messages (a flexible gated
 // spacer to the bubble's left → bubble hugs the right edge), "" for others
 // (spacer collapses → bubble stays left). mine drives the bubble tint.
 interface Row { id: string; text: string; when: string; leadFill: string; mine: string }
-interface S { status: "loading" | "ready"; messages: Row[]; emptyText: string; draft: string; sendHint: string; resolvedChatroomId: string; myUserId: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; messages: Row[]; emptyText: string; draft: string; sendHint: string; resolvedChatroomId: string; myUserId: string }
 
 function inputId(): string {
   return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
@@ -63,16 +64,28 @@ const svc = defineService<S, {
   setDraft: (s: S, a?: unknown) => S;
   send: (s: S) => Promise<S>;
 }>("spacesChatThread", {
-  state: { status: "loading", messages: [], emptyText: "", draft: "", sendHint: "", resolvedChatroomId: "", myUserId: "" },
+  state: { status: "loading", messages: [], emptyText: "", draft: "", sendHint: "", resolvedChatroomId: "", myUserId: "", ...presence("loading") },
   actions: {
     load: async (s) => {
       const raw = inputId();
+      // No thread / recipient id (a stale link, a route opened directly) -> the shared
+      // not-found state, and no composer: there is nobody to send to.
+      if (!detailInputId()) return { ...s, status: "ready", messages: [], emptyText: "", ...presence("missing") };
       // Resolve chatroom + my user id concurrently (myUserId tags own messages).
       const [chatroomId, myUserId] = await Promise.all([resolveChatroomId(raw, inputKind()), resolveMyUserId()]);
+      // A recipient whose 1:1 chatroom could not be resolved is not a conversation yet:
+      // reload("") would return [] without throwing and publish a live, empty thread
+      // whose Send can only fail. Show the load-error line instead.
+      if (!chatroomId) return { ...s, status: "ready", resolvedChatroomId: "", myUserId, messages: [], emptyText: "", ...presence("failed") };
       try {
         const messages = await reload(chatroomId, myUserId);
-        return { ...s, status: "ready", resolvedChatroomId: chatroomId, myUserId, messages, emptyText: messages.length ? "" : "No messages yet. Say hello!" };
-      } catch { return { ...s, status: "ready", resolvedChatroomId: chatroomId, myUserId, messages: [], emptyText: "No messages yet. Say hello!" }; }
+        return { ...s, status: "ready", resolvedChatroomId: chatroomId, myUserId, messages, emptyText: messages.length ? "" : "No messages yet. Say hello!", ...presence("found") };
+      } catch (e) {
+        // A thread whose messages cannot be read is not a live, empty conversation: a 404
+        // is the shared not-found state, anything else the load-error line — never a
+        // "Say hello!" composer that can only fail.
+        return { ...s, status: "ready", resolvedChatroomId: chatroomId, myUserId, messages: [], emptyText: "", ...presenceAfterError(e) };
+      }
     },
     setDraft: (s, a) => ({ ...s, draft: val(a) }),
     // REAL WRITE: send the typed message to the RESOLVED chatroom id, then re-read.

package/templates/branded-lite/tier5-src/wix-spaces-collection-detail/index.ts

@@ -7,19 +7,17 @@ import {
   getStoreCategory,
   type WixCollection,
 } from "@himalaya/wix-stores-collections";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; name: string; subtitle: string; description: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; name: string; subtitle: string; description: string }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 
 const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesCollectionDetail", {
-  state: { status: "loading", name: "", subtitle: "", description: "" },
+  state: { status: "loading", name: "", subtitle: "", description: "", ...presence("loading") },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      if (!id) return { ...s, status: "ready" };
+      const id = detailInputId();
+      if (!id) return { ...s, status: "ready", ...presence("missing") };
       try {
         const res = await getStoreCategory(id);
         const c = res.category;
@@ -29,6 +27,7 @@ const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesCollectionDe
             name: c.name || "Category",
             subtitle: categoryCount(c),
             description: c.description || "",
+            ...presence("found"),
           };
         }
       } catch { /* fall through to V1 */ }
@@ -43,9 +42,10 @@ const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesCollectionDe
           name: c.name || "Collection",
           subtitle: n != null ? `${n} ${n === 1 ? "product" : "products"}` : "",
           description: c.description || "",
+          ...presence("found"),
         };
-      } catch {
-        return { ...s, status: "ready" };
+      } catch (e) {
+        return { ...s, status: "ready", ...presenceAfterError(e) };
       }
     },
   },

package/templates/branded-lite/tier5-src/wix-spaces-coupon-detail/index.ts

@@ -5,19 +5,17 @@
 import { defineService } from "@himalaya/state";
 import { getCoupon, type WixCoupon } from "@himalaya/wix-coupons";
 import { writeText } from "@himalaya/clipboard";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; name: string; code: string; rawCode: string; discount: string; copyHint: string; hasCode: boolean; noCode: boolean }
+interface S extends PresenceFlags { status: "loading" | "ready"; name: string; code: string; rawCode: string; discount: string; copyHint: string; hasCode: boolean; noCode: boolean }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 
 const svc = defineService<S, { load: (s: S) => Promise<S>; copyCode: (s: S) => Promise<S> }>("spacesCouponDetail", {
-  state: { status: "loading", name: "", code: "", rawCode: "", discount: "", copyHint: "", hasCode: false, noCode: true },
+  state: { status: "loading", name: "", code: "", rawCode: "", discount: "", copyHint: "", hasCode: false, noCode: true, ...presence("loading") },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      if (!id) return { ...s, status: "ready" };
+      const id = detailInputId();
+      if (!id) return { ...s, status: "ready", ...presence("missing") };
       try {
         const res = await getCoupon(id);
         const c = (((res as unknown as { coupon?: WixCoupon }).coupon) ?? (res as unknown as WixCoupon)) as unknown as {
@@ -27,8 +25,8 @@ const svc = defineService<S, { load: (s: S) => Promise<S>; copyCode: (s: S) => P
         const sp = c.specification;
         const discount = sp?.percentOffRate ? `${sp.percentOffRate}% off` : sp?.moneyOffAmount ? `${sp.moneyOffAmount} off` : sp?.fixedPriceAmount ? `Fixed price ${sp.fixedPriceAmount}` : "";
         const rawCode = c.code || "";
-        return { status: "ready", name: c.name || c.code || "Coupon", code: rawCode ? `Code: ${rawCode}` : "", rawCode, discount, copyHint: "", hasCode: !!rawCode, noCode: !rawCode };
-      } catch { return { ...s, status: "ready" }; }
+        return { status: "ready", name: c.name || c.code || "Coupon", code: rawCode ? `Code: ${rawCode}` : "", rawCode, discount, copyHint: "", hasCode: !!rawCode, noCode: !rawCode, ...presence("found") };
+      } catch (e) { return { ...s, status: "ready", ...presenceAfterError(e) }; }
     },
     copyCode: async (s) => {
       if (!s.rawCode) return { ...s, copyHint: "No code to copy." };

package/templates/branded-lite/tier5-src/wix-spaces-create-post/index.ts

@@ -4,6 +4,7 @@
 // create endpoint in the SDK; blog is the available authored-content write.)
 import { defineService } from "@himalaya/state";
 import { createDraftPost, publishDraftPost } from "@himalaya/wix-blog";
+import { memberAccess } from "../_shared/member-access.js";
 
 // `bodyFocus` is a focus TOKEN, not a flag: the body field focuses whenever this
 // becomes a new non-empty value (`TextFieldProps.focus_path`). A monotonic counter
@@ -14,7 +15,11 @@ import { createDraftPost, publishDraftPost } from "@himalaya/wix-blog";
 // the new state), so there is no way to observe an intermediate value while `submit`
 // is awaiting the network. A type that promises a state nobody can ever see reads as
 // an in-flight guard that exists — see `posting` below for the one that works.
-interface S { status: "ready"; title: string; body: string; hint: string; bodyFocus: string }
+// `needsSignIn` / `noSignIn` / `hideForm` drive the member gate: a guest sees the
+// gate and NO form, a member sees the form, and until `load` has asked the
+// host who is signed in, neither shows — so a guest can never start typing a post
+// that would only fail on submit.
+interface S { status: "ready"; title: string; body: string; hint: string; bodyFocus: string; needsSignIn: boolean; noSignIn: boolean; hideForm: boolean }
 
 // The real double-press guard, module-local because it must live OUTSIDE published
 // state for the reason above. One worker instance owns one composer, so a module flag
@@ -33,15 +38,20 @@ function val(arg?: unknown): string {
   return typeof arg === "string" ? arg : ((arg as { value?: string; text?: string })?.value ?? (arg as { text?: string })?.text ?? "");
 }
 
-const svc = defineService<S, { setTitle: (s: S, a?: unknown) => S; setBody: (s: S, a?: unknown) => S; focusBody: (s: S) => S; submit: (s: S) => Promise<S> }>("spacesCreatePost", {
-  state: { status: "ready", title: "", body: "", hint: "Share something with the community.", bodyFocus: "" },
+const svc = defineService<S, { load: (s: S) => Promise<S>; setTitle: (s: S, a?: unknown) => S; setBody: (s: S, a?: unknown) => S; focusBody: (s: S) => S; submit: (s: S) => Promise<S> }>("spacesCreatePost", {
+  state: { status: "ready", title: "", body: "", hint: "Share something with the community.", bodyFocus: "", needsSignIn: false, noSignIn: true, hideForm: true },
   actions: {
+    load: async (s) => {
+      const { email } = await memberAccess();
+      return { ...s, needsSignIn: !email, noSignIn: !!email, hideForm: !email };
+    },
     setTitle: (s, a) => ({ ...s, title: val(a) }),
     setBody: (s, a) => ({ ...s, body: val(a) }),
     // Title's Next key lands here. The keyboard stays up (that is the "next"
     // contract) and the body field takes focus.
     focusBody: (s) => ({ ...s, bodyFocus: bumpToken(s.bodyFocus) }),
     submit: async (s) => {
+      if (s.needsSignIn) return { ...s, hint: "Sign in to post." };
       const title = s.title.trim();
       if (!title) return { ...s, hint: "Please enter a title." };
       // A second press while the first is still in flight is a NO-OP, not a second
@@ -63,7 +73,7 @@ const svc = defineService<S, { setTitle: (s: S, a?: unknown) => S; setBody: (s:
         // steals focus, so those transitions must clear it (see himi-store-account's
         // NO_FOCUS on its mode switches). Same token, opposite fix; the deciding
         // question is always whether the field stays mounted.
-        return { status: "ready", title: "", body: "", bodyFocus: s.bodyFocus, hint: `Posted “${title}” ✓ — it now appears in Blog.` };
+        return { ...s, status: "ready", title: "", body: "", bodyFocus: s.bodyFocus, hint: `Posted “${title}” ✓ — it now appears in Blog.` };
       } catch {
         return { ...s, status: "ready", hint: "Couldn't post — check your connection and try again." };
       } finally {

package/templates/branded-lite/tier5-src/wix-spaces-food-order-detail/index.ts

@@ -1,13 +1,16 @@
 // Tier-5 bundle: Wix Spaces clone — explicit secure-site handoff.
 // The owner-capable Restaurant Orders API must never be queried from a member device.
 import { defineService } from "@himalaya/state";
+import { presence, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; name: string; status_: string; total: string; items: string; message: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; name: string; status_: string; total: string; items: string; message: string }
 
 const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesFoodOrderDetail", {
-  state: { status: "loading", name: "", status_: "", total: "", items: "", message: "" },
+  state: { status: "loading", name: "", status_: "", total: "", items: "", message: "", ...presence("loading") },
   actions: {
-    load: async () => ({
+    // No order id → the shared not-found state; an id → the secure-site handoff.
+    load: async () => (!detailInputId() ? { status: "ready", name: "", status_: "", total: "", items: "", message: "", ...presence("missing") } : {
+      ...presence("found"),
       status: "ready",
       name: "",
       status_: "",

package/templates/branded-lite/tier5-src/wix-spaces-form-detail/index.ts

@@ -1,19 +1,17 @@
 // Tier-5 bundle: Wix Spaces clone — Form detail (ON-DEVICE, site-scoped).
 import { defineService } from "@himalaya/state";
 import { getForm, type WixForm } from "@himalaya/wix-forms";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; name: string; subtitle: string; fields: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; name: string; subtitle: string; fields: string }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 
 const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesFormDetail", {
-  state: { status: "loading", name: "", subtitle: "", fields: "" },
+  state: { status: "loading", name: "", subtitle: "", fields: "", ...presence("loading") },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      if (!id) return { ...s, status: "ready" };
+      const id = detailInputId();
+      if (!id) return { ...s, status: "ready", ...presence("missing") };
       try {
         const res = await getForm(id);
         const f = (((res as unknown as { form?: WixForm }).form) ?? (res as unknown as WixForm)) as unknown as {
@@ -23,8 +21,8 @@ const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesFormDetail",
         };
         const list = (f.fieldsV2 || f.fields || []) as Array<{ label?: string; inputOptions?: { label?: string } }>;
         const fields = list.map((x) => `• ${x.label || x.inputOptions?.label || "Field"}`).join("\n");
-        return { status: "ready", name: f.name || f.title || "Form", subtitle: list.length ? `${list.length} fields` : "", fields };
-      } catch { return { ...s, status: "ready" }; }
+        return { status: "ready", name: f.name || f.title || "Form", subtitle: list.length ? `${list.length} fields` : "", fields, ...presence("found") };
+      } catch (e) { return { ...s, status: "ready", ...presenceAfterError(e) }; }
     },
   },
 });

package/templates/branded-lite/tier5-src/wix-spaces-forum-post/index.ts

@@ -3,12 +3,10 @@
 // post and "Post Comment" creates a real comment, via the Wix Forum + comments APIs.
 import { defineService } from "@himalaya/state";
 import { getPost, reactToPost, removePostReaction, createForumComment, type WixPost } from "@himalaya/wix-forum";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; id: string; title: string; author: string; subtitle: string; body: string; initial: string; likeHint: string; commentText: string; commentHint: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; id: string; title: string; author: string; subtitle: string; body: string; initial: string; likeHint: string; commentText: string; commentHint: string }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 function plain(html?: string): string {
   return (html || "").replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
 }
@@ -23,11 +21,11 @@ const svc = defineService<S, {
   setComment: (s: S, a?: unknown) => S;
   comment: (s: S) => Promise<S>;
 }>("spacesForumPost", {
-  state: { status: "loading", id: "", title: "", author: "", subtitle: "", body: "", initial: "", likeHint: "", commentText: "", commentHint: "" },
+  state: { status: "loading", id: "", title: "", author: "", subtitle: "", body: "", initial: "", likeHint: "", commentText: "", commentHint: "", ...presence("loading") },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      if (!id) return { ...s, status: "ready" };
+      const id = detailInputId();
+      if (!id) return { ...s, status: "ready", ...presence("missing") };
       try {
         const res = await getPost(id);
         const p = ((res as unknown as { post?: WixPost }).post) ?? (res as unknown as WixPost);
@@ -38,8 +36,8 @@ const svc = defineService<S, {
         if (pp.viewCount != null) bits.push(`${pp.viewCount} views`);
         return { status: "ready", id, title: pp.title || "Post", author, subtitle: bits.join(" · "),
           body: plain(pp.contentText || pp.content) || "No content.", initial: (author[0] || "#").toUpperCase(),
-          likeHint: "", commentText: "", commentHint: "" };
-      } catch { return { ...s, status: "ready", id }; }
+          likeHint: "", commentText: "", commentHint: "", ...presence("found") };
+      } catch (e) { return { ...s, status: "ready", id, ...presenceAfterError(e) }; }
     },
     // REAL WRITE: react to / un-react to the post.
     like: async (s) => {

package/templates/branded-lite/tier5-src/wix-spaces-invoice-detail/index.ts

@@ -2,19 +2,17 @@
 import { defineService } from "@himalaya/state";
 import { getInvoice, type WixInvoice } from "@himalaya/wix-invoices";
 import { formatDateMedium } from "../_shared/engine-intl.js";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; name: string; status_: string; total: string; due: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; name: string; status_: string; total: string; due: string }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 
 const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesInvoiceDetail", {
-  state: { status: "loading", name: "", status_: "", total: "", due: "" },
+  state: { status: "loading", name: "", status_: "", total: "", due: "", ...presence("loading") },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      if (!id) return { ...s, status: "ready" };
+      const id = detailInputId();
+      if (!id) return { ...s, status: "ready", ...presence("missing") };
       try {
         const res = await getInvoice(id);
         const v = (((res as unknown as { invoice?: WixInvoice }).invoice) ?? (res as unknown as WixInvoice)) as unknown as {
@@ -24,8 +22,8 @@ const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesInvoiceDetai
         const due = v.dates?.dueDate ? `Due ${formatDateMedium(new Date(v.dates.dueDate))}` : "";
         return { status: "ready", name: v.title || `Invoice ${v.number || ""}`.trim(),
           status_: v.status ? v.status.charAt(0) + v.status.slice(1).toLowerCase() : "",
-          total: v.total?.formattedAmount || "", due };
-      } catch { return { ...s, status: "ready" }; }
+          total: v.total?.formattedAmount || "", due, ...presence("found") };
+      } catch (e) { return { ...s, status: "ready", ...presenceAfterError(e) }; }
     },
   },
 });

package/templates/branded-lite/tier5-src/wix-spaces-member-detail/index.ts

@@ -12,8 +12,9 @@ import {
   isFollowingMember,
   type WixMember,
 } from "@himalaya/wix-members";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S {
+interface S extends PresenceFlags {
   status: "loading" | "ready";
   id: string;
   name: string;
@@ -29,9 +30,6 @@ interface S {
   followCount: string;
 }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 function name(m: WixMember): string {
   const nick = m.profile?.nickname?.trim();
   if (nick) return nick;
@@ -63,11 +61,12 @@ const svc = defineService<S, {
     following: 0,
     followLabel: "Follow",
     followCount: "0 Followers · 0 Following",
+    ...presence("loading"),
   },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      if (!id) return { ...s, status: "ready" };
+      const id = detailInputId();
+      if (!id) return { ...s, status: "ready", ...presence("missing") };
       try {
         const res = await getMember(id);
         const m = ((res as unknown as { member?: WixMember }).member) ?? (res as unknown as WixMember);
@@ -102,9 +101,10 @@ const svc = defineService<S, {
           following,
           followLabel: followLabelFor(isFollowing),
           followCount: followCountFor(followers, following),
+          ...presence("found"),
         };
-      } catch {
-        return { ...s, status: "ready", id };
+      } catch (e) {
+        return { ...s, status: "ready", id, ...presenceAfterError(e) };
       }
     },
     // REAL WRITE: two-state toggle. Flips the relationship and optimistically

package/templates/branded-lite/tier5-src/wix-spaces-photo-albums/index.ts

@@ -1,15 +1,21 @@
 // Tier-5 bundle: Wix Spaces clone — Photo Albums (ON-DEVICE, site-scoped).
 // No albums API wired yet → renders the real empty state, never fabricated rows.
+// The emptyTitle/emptyBody copy is the Spaces clone's LIST screen. An app that opens
+// this for ONE album (branded-lite's gallery "Open album", which passes the album id)
+// renders its own single-album copy and gates it on `noEntity`; opened with no id at
+// all it shows the shared not-found state.
 import { defineService } from "@himalaya/state";
+import { presence, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "ready"; emptyTitle: string; emptyBody: string }
+interface S extends PresenceFlags { status: "ready"; emptyTitle: string; emptyBody: string }
 
 const svc = defineService<S, { load: (s: S) => S }>("spacesPhotoAlbums", {
   state: {
     status: "ready",
     emptyTitle: "No albums yet",
     emptyBody: "Photo albums shared on this site will appear here.",
+    ...presence("loading"),
   },
-  actions: { load: (s) => s },
+  actions: { load: (s) => ({ ...s, ...presence(detailInputId() ? "found" : "missing") }) },
 });
 export { svc };

package/templates/branded-lite/tier5-src/wix-spaces-plan-detail/index.ts

@@ -2,12 +2,10 @@
 // himalaya.input.id carries the plan id; fetched via getPlan.
 import { defineService } from "@himalaya/state";
 import { getPlan, type WixPlan } from "@himalaya/wix-pricing-plans";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; name: string; price: string; description: string; perks: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; name: string; price: string; description: string; perks: string }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 function priceOf(p: WixPlan): string {
   const m = p.pricing?.price as unknown as { formattedAmount?: string; amount?: string; currency?: string } | undefined;
   if (!m) return p.pricing?.freeTrialDays ? "Free trial" : "";
@@ -15,17 +13,17 @@ function priceOf(p: WixPlan): string {
 }
 
 const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesPlanDetail", {
-  state: { status: "loading", name: "", price: "", description: "", perks: "" },
+  state: { status: "loading", name: "", price: "", description: "", perks: "", ...presence("loading") },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      if (!id) return { ...s, status: "ready" };
+      const id = detailInputId();
+      if (!id) return { ...s, status: "ready", ...presence("missing") };
       try {
         const res = await getPlan(id);
         const p = ((res as unknown as { plan?: WixPlan }).plan) ?? (res as unknown as WixPlan);
         const perks = (p.perks?.values ?? []).map((v) => `• ${v}`).join("\n");
-        return { status: "ready", name: p.name || "Plan", price: priceOf(p), description: p.description || "", perks };
-      } catch { return { ...s, status: "ready" }; }
+        return { status: "ready", name: p.name || "Plan", price: priceOf(p), description: p.description || "", perks, ...presence("found") };
+      } catch (e) { return { ...s, status: "ready", ...presenceAfterError(e) }; }
     },
   },
 });

package/templates/branded-lite/tier5-src/wix-spaces-subscription-detail/index.ts

@@ -2,23 +2,23 @@
 import { defineService } from "@himalaya/state";
 import { getPlanOrder, type WixPlanOrder } from "@himalaya/wix-pricing-plans";
 import { formatDateMedium } from "../_shared/engine-intl.js";
+import { presence, presenceAfterError, detailInputId, type PresenceFlags } from "../_shared/detail-presence.js";
 
-interface S { status: "loading" | "ready"; name: string; subtitle: string; price: string; validity: string }
+interface S extends PresenceFlags { status: "loading" | "ready"; name: string; subtitle: string; price: string; validity: string }
 
-function inputId(): string {
-  return (globalThis as { himalaya?: { input?: { id?: string } } }).himalaya?.input?.id ?? "";
-}
 
+// Shown by hosts without the shared not-found state (the Spaces clone renders `subtitle`
+// directly); branded-lite hides the whole content block behind `notFound`.
 const EMPTY_DETAIL = "Open a subscription from My Subscriptions — detail needs a plan-order id.";
 const LOAD_FAILED = "This subscription could not be loaded. Try again from My Subscriptions.";
 
 const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesSubscriptionDetail", {
-  state: { status: "loading", name: "", subtitle: "", price: "", validity: "" },
+  state: { status: "loading", name: "", subtitle: "", price: "", validity: "", ...presence("loading") },
   actions: {
     load: async (s) => {
-      const id = inputId();
-      // Honest empty (not a blank chrome-only screen) when nav lost the order id.
-      if (!id) return { status: "ready", name: "", subtitle: EMPTY_DETAIL, price: "", validity: "" };
+      const id = detailInputId();
+      // No order id (a stale link, a route opened directly) → the shared not-found state.
+      if (!id) return { status: "ready", name: "", subtitle: EMPTY_DETAIL, price: "", validity: "", ...presence("missing") };
       try {
         const res = await getPlanOrder(id);
         const o = (((res as unknown as { order?: WixPlanOrder }).order) ?? (res as unknown as WixPlanOrder)) as unknown as {
@@ -29,9 +29,10 @@ const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesSubscription
         const price = o.pricing?.prices?.[0]?.price?.formattedTotal || "";
         const end = o.currentCycle?.endedDate ? `Renews ${formatDateMedium(new Date(o.currentCycle.endedDate))}` : "";
         return { status: "ready", name: o.planName || "Subscription",
-          subtitle: o.status ? o.status.charAt(0) + o.status.slice(1).toLowerCase() : "", price, validity: end };
-      } catch {
-        return { status: "ready", name: "", subtitle: LOAD_FAILED, price: "", validity: "" };
+          subtitle: o.status ? o.status.charAt(0) + o.status.slice(1).toLowerCase() : "", price, validity: end, ...presence("found") };
+      } catch (e) {
+        const flags = presenceAfterError(e);
+        return { status: "ready", name: "", subtitle: flags.notFound ? "" : LOAD_FAILED, price: "", validity: "", ...flags };
       }
     },
   },