@wix/himalaya-cli 0.1587.0 → 0.1589.0

package/templates/community-club/tier5-src/himi-branded-lite-my-groups/index.ts

@@ -0,0 +1,236 @@
+import { defineService } from "@himalaya/state";
+import { getGroup, listMemberships, type WixGroup, type WixGroupMembership } from "@himalaya/wix-groups";
+import { getMyMember } from "@himalaya/wix-members";
+import { copyParam, stashCopy } from "../_shared/himi-copy.js";
+import { groupImage } from "../_shared/himi-media.js";
+import { memberAccess, memberAccessDenied, type MemberAccess } from "../_shared/member-access.js";
+
+// The groups the SIGNED-IN member belongs to (the One App "My groups" list). Two reads, both as the
+// member: the memberships (GET /social-groups-proxy/members/v2/members/{id}/memberships, which Wix
+// answers for the caller's own id only) and then one getGroup per membership, because a membership
+// carries a group id and a role, never the group's name or cover.
+//
+// A visitor makes ZERO calls: the screen shows its sign-in card. The member id is the current
+// member's (`getMyMember`), never taken from input. Read-only and online-only.
+
+type Failure = "forbidden" | "failed";
+
+/** Memberships read in one page. A member with more is told so, not shown a silently short list. */
+const PAGE_LIMIT = 50;
+const DETAIL_SCREEN = "himi_group";
+
+interface MyGroupRow {
+  id: string;
+  title: string;
+  /** "Admin", "Member" or "Pending request" — the member's standing in the group. */
+  statusLabel: string;
+  meta: string;
+  image: string;
+  initial: string;
+  hasImage: boolean;
+  noImage: boolean;
+  detailScreenId: string;
+}
+
+interface State {
+  status: "loading" | "ready" | "error" | "signedOut";
+  rows: MyGroupRow[];
+  emptyText: string;
+  errorText: string;
+  /** Some groups could not be read, or the member has more than one page: said above the list. */
+  partialText: string;
+  notLoading: boolean;
+  notErrored: boolean;
+  noRows: boolean;
+  noEmpty: boolean;
+  noPartial: boolean;
+  needsSignIn: boolean;
+  noSignIn: boolean;
+}
+
+const initial: State = {
+  status: "loading",
+  rows: [],
+  emptyText: "",
+  errorText: "",
+  partialText: "",
+  notLoading: false,
+  notErrored: true,
+  noRows: true,
+  noEmpty: true,
+  noPartial: true,
+  needsSignIn: false,
+  noSignIn: true,
+};
+
+/** Bumped by every load, so a response that arrives after a newer load began is dropped. */
+let loadSeq = 0;
+
+const signedOutState: State = { ...initial, status: "signedOut", notLoading: true, needsSignIn: true, noSignIn: false };
+
+function errorState(failure: Failure): State {
+  return {
+    ...initial,
+    status: "error",
+    notLoading: true,
+    notErrored: false,
+    errorText: failure === "forbidden"
+      ? copyParam("myGroups.forbiddenText", "Your groups are unavailable for this account. Sign in again.")
+      : copyParam("myGroups.errorText", "Your groups could not be loaded."),
+  };
+}
+
+function failureOf(error: unknown): Failure {
+  return memberAccessDenied(error) ? "forbidden" : "failed";
+}
+
+function isNotFound(error: unknown): boolean {
+  return /HTTP 404\b/.test(String((error as Error)?.message ?? error));
+}
+
+function statusLabelOf(membership: WixGroupMembership): string {
+  if ((membership.status ?? "").toUpperCase() === "PENDING") return copyParam("myGroups.status.pending", "Pending request");
+  return (membership.role?.value ?? "").toUpperCase() === "ADMIN"
+    ? copyParam("myGroups.status.admin", "Admin")
+    : copyParam("myGroups.status.member", "Member");
+}
+
+function rowOf(group: WixGroup, membership: WixGroupMembership): MyGroupRow {
+  const title = (group.name || copyParam("groups.groupFallbackName", "Group")).trim();
+  const count = group.membersCount ?? group.memberCount;
+  const image = groupImage(group);
+  return {
+    id: String(membership.groupId),
+    title,
+    statusLabel: statusLabelOf(membership),
+    meta: typeof count === "number" ? `${count} ${count === 1 ? "member" : "members"}` : "",
+    image,
+    initial: (title[0] || "G").toUpperCase(),
+    hasImage: Boolean(image),
+    noImage: !image,
+    detailScreenId: DETAIL_SCREEN,
+  };
+}
+
+/** JOINED and PENDING memberships with a group id; an UNKNOWN status is not a membership to show. */
+function shownMemberships(response: unknown): WixGroupMembership[] | undefined {
+  const memberships = (response as { memberships?: unknown } | null | undefined)?.memberships;
+  if (!Array.isArray(memberships)) return undefined;
+  const seen = new Set<string>();
+  return (memberships as WixGroupMembership[]).filter((m) => {
+    const status = (m?.status ?? "").toUpperCase();
+    if (typeof m?.groupId !== "string" || !m.groupId || (status !== "JOINED" && status !== "PENDING") || seen.has(m.groupId)) return false;
+    seen.add(m.groupId);
+    return true;
+  });
+}
+
+function readyState(rows: MyGroupRow[], partialText: string): State {
+  return {
+    ...initial,
+    status: "ready",
+    rows,
+    emptyText: copyParam("myGroups.emptyText", "You haven’t joined any groups yet."),
+    partialText,
+    notLoading: true,
+    noRows: rows.length === 0,
+    noEmpty: rows.length > 0,
+    noPartial: !partialText,
+  };
+}
+
+const sameMember = (a: MemberAccess, b: MemberAccess) => a.email === b.email && a.scope === b.scope;
+
+/** Whose groups the rows on screen are. A load for anybody else clears them first. */
+let rowsOwner: MemberAccess | undefined;
+
+/** The sign-in card is what the screen shows. A load that finds a member now (they signed in and came back)
+ *  shows the loading state at once instead of leaving the card up over the network calls. A module flag, not
+ *  a read of the state: the reload this starts must not see the card again and restart forever. */
+let showingSignIn = false;
+
+/** The member changed while this load ran or the rows were on screen: show the loading state at once,
+ *  so the previous member's group names and standing are never on screen, and load for the current one. */
+function restart(): State {
+  rowsOwner = undefined;
+  showingSignIn = false;
+  loadSeq++;
+  void svc.load();
+  return { ...initial };
+}
+
+/** An error for THIS member, unless a newer load began or the member left meanwhile: then it is stale. */
+async function failureFor(seq: number, access: MemberAccess, failure: Failure): Promise<State | undefined> {
+  if (seq !== loadSeq) return undefined;
+  const now = await memberAccess();
+  // A newer load began while the identity was read: its answer is the fresher one.
+  if (seq !== loadSeq) return undefined;
+  if (!sameMember(access, now)) return restart();
+  return errorState(failure);
+}
+
+async function loadOnce(access: MemberAccess): Promise<State | undefined> {
+  const seq = ++loadSeq;
+  if (!access.email) { showingSignIn = true; return signedOutState; }
+  try {
+    const me = await getMyMember();
+    const memberId = String(me?.member?.id ?? "");
+    if (!memberId) return failureFor(seq, access, "failed");
+    const response = await listMemberships(memberId, { limit: PAGE_LIMIT });
+    const memberships = shownMemberships(response);
+    if (!memberships) return failureFor(seq, access, "failed");
+    const reads = await Promise.allSettled(memberships.map((m) => getGroup(String(m.groupId))));
+    // Another load began, or the member signed out / switched account while these reads were in
+    // flight: these rows belong to somebody else now.
+    if (seq !== loadSeq) return undefined;
+    const now = await memberAccess();
+    // Re-checked after the await: a newer load may have committed while the identity was read.
+    if (seq !== loadSeq) return undefined;
+    if (!sameMember(access, now)) return restart();
+    const rows: MyGroupRow[] = [];
+    let failed = 0;
+    let firstFailure: unknown;
+    reads.forEach((read, index) => {
+      if (read.status === "fulfilled") {
+        // Social Groups wraps the entity as `{ group }`; the typed signature claims a bare group.
+        const group = ((read.value as unknown as { group?: WixGroup }).group ?? read.value) as WixGroup;
+        if (group && typeof group === "object") { rows.push(rowOf(group, memberships[index])); return; }
+      }
+      // A group deleted since the membership was listed is gone, not a failed read.
+      if (read.status === "rejected" && isNotFound(read.reason)) return;
+      failed++;
+      firstFailure ??= read.status === "rejected" ? read.reason : undefined;
+    });
+    // Memberships exist but not one group could be shown: that is unreadable (a pending request on a
+    // private group answers 404 until approved) or gone, never "you have no groups".
+    if (memberships.length > 0 && rows.length === 0) return errorState(failed > 0 ? failureOf(firstFailure) : "failed");
+    // Wix omits `total` when it is too many to count, and says so in `tooManyToCount`.
+    const truncated = response.metadata?.tooManyToCount === true || Number(response.metadata?.total ?? 0) > PAGE_LIMIT;
+    const partialText = [
+      failed > 0 ? copyParam("myGroups.partialText", "Some of your groups could not be loaded.") : "",
+      truncated ? copyParam("myGroups.truncatedText", "Showing your first groups only.") : "",
+    ].filter(Boolean).join(" ");
+    rowsOwner = access;
+    return readyState(rows, partialText);
+  } catch (error) {
+    // A request that rejects because the member left is the old member's error, not the current one's.
+    return failureFor(seq, access, failureOf(error));
+  }
+}
+
+const svc = defineService<State, {
+  load: (state: State, arg?: unknown) => Promise<State | undefined>;
+}>("himiBrandedMyGroups", {
+  state: initial,
+  actions: {
+    load: async (_state, arg) => {
+      stashCopy(arg);
+      const access = await memberAccess();
+      if ((rowsOwner && !sameMember(rowsOwner, access)) || (showingSignIn && access.email)) return restart();
+      return loadOnce(access);
+    },
+  },
+});
+
+svc.load();
+export { svc };

package/templates/events-meetups/config.ts

@@ -231,6 +231,13 @@ export default defineApp({
         "parentScreenId": "himi_group",
         "tabId": "groups"
       },
+      {
+        "screenId": "himi_my_groups",
+        "isPublic": true,
+        "paramKeys": [],
+        "parentScreenId": "himi_groups",
+        "tabId": "groups"
+      },
       {
         "screenId": "himi_account",
         "isPublic": true,