@wix/agent-skills 1.36.0 → 1.36.1

package/skills/wix-vibe-headless/references/members/INSTRUCTIONS.md

@@ -1,328 +0,0 @@
-# Wix Members — ready-made custom-login client
-
-The members client is **shipped as real files**, not snippets to regenerate. It's a complete
-**custom login** — email+password sign-up/sign-in, "Continue with Google/Facebook" (and custom SSO),
-a member session, an account area, and route gating — styled with your app's design tokens (base44's
-`src/index.css` — the shadcn palette the design phase already set). Copy it into the app and wire the
-routes — you generate almost none of the auth code (the OAuth state machine, PKCE, the hidden-iframe
-token exchange, and the social `/callback` all ship and are correct).
-
-**Custom login only.** The member types credentials in **your own form on your own page** (or clicks
-your own social button) — they are **never redirected to a Wix-hosted login page**. Talks to Wix
-directly over the public `WIX_CLIENT_ID`; login swaps the token set on the one shared client, so
-**every later `wixApiRequest` runs as the member** (their cart, orders, plans, "my …" reads). Never
-mock a logged-in member; never mint a second client after login.
-
-## Prerequisites
-- The site's **Wix OAuth app** (headless) is the auth target — members **self-register**, so there is
-  **nothing to seed** (see **Seeding** below); the client renders the shipped logged-out state until a
-  member signs in.
-- The **Members Area app** installed *only if* you need member **profile** data (name, photo, roles,
-  custom fields). Pure "logged-in vs. not" gating needs no app — see **Identity vs. profile** below.
-- The public headless **`WIX_CLIENT_ID`** from your prompt (buyer-facing, safe to hardcode/commit).
-- **OAuth-app allow-listing — the #1 gotcha, a manual owner-only step you can't do from client code.**
-  Two *different* fields gate the two mechanisms:
-
-  | Mechanism | What must be allow-listed | OAuth-app field | On `localhost:4321`? |
-  | :-- | :-- | :-- | :-- |
-  | **credential** (your form) | your app **origin** (the hidden iframe `postMessage`s the code back) | `allowedRedirectDomains` | ✅ allowed by default |
-  | **social / SSO** | the **exact `/callback` URL** (full-page redirect target) | `allowedRedirectUris` | ❌ **must be added** |
-
-  `localhost:4321` is Wix's default-allowed dev **origin**, so **credential login works there with zero
-  setup**; social **still fails** until you add `http://localhost:4321/callback` to `allowedRedirectUris`.
-  Any non-default origin (deployed domain, other port) needs both the origin and `<origin>/callback`.
-  **Symptoms:** unregistered origin → credential login hangs then throws `MemberAuthError('timeout')`
-  (+ a console *"postMessage… target origin does not match"*); unregistered callback → the Wix
-  authorize page shows *"Invalid redirect URI"* before returning, so the client can't catch it.
-
-  > **⚠️ AGENT: surface this proactively.** As soon as a run uses social/SSO (or deploys credential
-  > login to a non-`4321` origin), **tell the user the exact URIs to add and where** (deep link under
-  > **Point the user to their dashboard**), and note that **social login stays dead until they do it**.
-
-## STEP 1 — The client is already in `src/`
-The install step (base44.md STEP 1) deployed the whole members UI client + REST scaffolds into
-`src/` (imports use the `@/` alias → `src/`). Here's every file and what it is — **this is your map,
-so you don't need to open them:**
-
-| file | what it is |
-|---|---|
-| `context/MemberContext.jsx` | `useMember()` provider: current member, `loggedIn`, `refresh()`, `logout()` |
-| `hooks/useLoginForm.js` | credential state machine (login/register/verify, error mapping) — logic only |
-| `components/LoginForm.jsx` | email+password form UI (sign-in/sign-up tabs, verify-code + pending phases) |
-| `components/SocialButtons.jsx` | "Continue with Google/Facebook" buttons (kick off the redirect) |
-| `components/MemberMenu.jsx` | header account control — "Log in" vs. member name + log-out (like a cart button) |
-| `components/RequireAuth.jsx` | route gate: renders children for a member, else redirects to `/login` |
-| `components/WixManageBanner.jsx` | preview-only manage banner — drop it into your Layout (STEP 3) |
-| `pages/Login.jsx`, `pages/Account.jsx` | the shipped login + account routes (`/login`, `/account`) |
-| `pages/Callback.jsx` | social/SSO return route — mount at **exactly** `/callback` |
-| `rest/wix-config.js` | the two ids, written by the install step |
-| `rest/wix-client.js` + `rest/wix-members-auth.js` | REST transport + the auth helper (copy verbatim) |
-
-They're already in place — go **straight to theming + wiring**, nothing to verify first. **Don't
-`read_file` the shipped page/component/hook source to inspect it** — the table says what each is and
-every shape you need is in the snippets below. Read a shipped file's source **only** on a real
-fallback — a runtime error, or a field the snippets don't cover (see "Fallback only" at the end).
-(Files missing? the install's `deploy` result lists what it wrote; re-run install, or copy
-`references/members/app/` → `src/`.)
-
-**Their `Link`/`useParams` imports come from `@/lib/nav`**, so the same sources run on either
-template. That adapter is installed at `src/lib/nav.js` with the rest of the deployed tree — use
-the file that is there, and on TanStack check it first ([which template?](../_shared/routing.md)).
-Import from `@/lib/nav` in the pages you write too, and they stay portable the same way.
-
-
-> **⚠️ Copy `wix-members-auth.js` verbatim — do NOT rewrite its internals.** The OAuth wire shapes are
-> exact and unforgiving: the `createRedirectSession` body needs the `auth.authRequest` wrapper, flat
-> PKCE fields, and `responseType`/`scope` — "simplifying" it returns **400** and login dies. Extend by
-> *calling* the exports, never by editing them. Its full JSDoc (state machine, `profile`, errors) is at
-> the top of the file — read that, not the whole body, if you need the contract.
-
-
-## STEP 2 — Theme
-Use the existing Base44 theme in `src/index.css` so your pages and the shipped components
-share the same colors and typography.
-
-## STEP 3 — Wire routes + provider (surgical `find_replace` on `src/App.jsx`, never a rewrite)
-
-> **The template decides this step, and `src/routes/__root.jsx` is the question to ask first.**
-> Present → TanStack Start, which mounts these pages as route files at the end of this step; absent
-> → React Router, which the wiring below is written for. Ask in that order: an `src/App.jsx` can
-> exist on a TanStack app because an agent created one, and `__root.jsx` is never there by mistake.
-> The installed `src/lib/nav.js` defaults to the React Router adapter, so on TanStack swap it:
-> [both patterns](../_shared/routing.md).
->
-> **Import `Link`, `useParams` and friends from `@/lib/nav` in the pages you write too** — same
-> names as the router exports, and nothing you write is pinned to one template.
-
-**No file reads needed to wire this.** Every shipped page and `WixManageBanner` is a default export that takes **no props** — wire them exactly as the snippet shows; nothing in those files needs looking up.
-`App.jsx` carries required platform auth scaffolding (`AuthProvider`/`useAuth`, the **Base44 builder
-account**) — edit it in, don't replace it. The Wix member session is separate and ships under its own
-name, **`MemberProvider`/`useMember`**, so the two never collide (do NOT rename it to `useAuth`).
-- Wrap the routed tree in `<MemberProvider>` (from `@/context/MemberContext`).
-- Put your **header + footer in a `Layout`** that renders `<Outlet/>` between them, and nest every
-  route under one pathless `<Route element={<Layout/>}>`. Your brand chrome then wraps **every** page
-  — including the shipped `Login`/`Account`/`Callback` — so you **never edit the shipped pages to add
-  a header/footer** (they render inside `<Outlet/>` as-is).
-- **Pin the top chrome as one fixed block.** Put `<WixManageBanner/>` (shipped, preview-only) **above**
-  your `<Header/>` inside a single `position:fixed` top region — the header itself is plain in-flow
-  markup, the region owns the fixing — so banner + header ride together (no scroll drift/gap). Pad
-  the content by the region's measured height so it clears the chrome and self-corrects when the
-  banner is dismissed.
-- Routes under the Layout: `/login` → `Login`, `/callback` → `Callback` (both shipped, as-is), and
-  `/account` → `Account` **wrapped in `<RequireAuth>`** so a visitor is bounced to `/login`. **You add
-  `/` → your own Home** page. Gate your own member-only routes ("my orders", "my plans") the same way.
-
-```jsx
-import { useRef, useState, useEffect } from "react";
-import { Routes, Route, Outlet } from "react-router-dom";
-import { MemberProvider } from "@/context/MemberContext";
-import WixManageBanner from "@/components/WixManageBanner";   // shipped, preview-only · default export, no props
-import RequireAuth from "@/components/RequireAuth";           // shipped route gate
-import Login from "@/pages/Login";                     // shipped · default export, no props
-import Account from "@/pages/Account";                 // shipped · default export, no props
-import Callback from "@/pages/Callback";               // shipped · default export, no props
-import Home from "@/pages/Home";       // YOU build
-import Header from "@/components/Header";   // YOU build — plain in-flow markup, NOT position:fixed
-import Footer from "@/components/Footer";   // YOU build
-
-function Layout() {
-  const topRef = useRef(null);
-  const [offset, setOffset] = useState(0);
-  useEffect(() => {                                  // measure the fixed region → pad content below it
-    const ro = new ResizeObserver(() => setOffset(topRef.current?.offsetHeight ?? 0));
-    if (topRef.current) ro.observe(topRef.current);
-    return () => ro.disconnect();
-  }, []);
-  return (<>
-    <div ref={topRef} style={{ position: "fixed", top: 0, left: 0, right: 0, zIndex: 50 }}>
-      <WixManageBanner />                    {/* null on the published site / when dismissed */}
-      <Header />                             {/* your brand header, in-flow inside this fixed block */}
-    </div>
-    <div style={{ paddingTop: offset }}>     {/* clears the chrome; shrinks when the banner is dismissed */}
-      <Outlet />                             {/* shipped Login/Account/Callback render here, untouched */}
-      <Footer />
-    </div>
-  </>);
-}
-
-<MemberProvider>
-  <Routes>
-    <Route element={<Layout />}>                                          {/* chrome wraps all */}
-      <Route path="/" element={<Home />} />                               {/* yours */}
-      <Route path="/login" element={<Login />} />                         {/* shipped, as-is */}
-      <Route path="/callback" element={<Callback />} />                   {/* shipped — must be /callback */}
-      <Route path="/account" element={<RequireAuth><Account /></RequireAuth>} />  {/* gated, shipped */}
-    </Route>
-  </Routes>
-</MemberProvider>
-```
-
-
-### TanStack Start template — the same pages, mounted as files
-
-Chrome (header, footer, the fixed banner region described above) goes in `src/routes/__root.jsx`
-around its `<Outlet/>`, and any provider this vertical asks for wraps that `<Outlet/>` once. Each
-route is a two-line file; shipped pages stay in `src/pages/` untouched.
-
-| route | file | component |
-|---|---|---|
-| `/` | `src/routes/index.jsx` | `Home` |
-| `/login` | `src/routes/login.jsx` | `Login` |
-| `/callback` | `src/routes/callback.jsx` | `Callback` |
-
-```jsx
-// src/routes/login.jsx
-import { createFileRoute } from "@tanstack/react-router";
-import Login from "@/pages/Login";
-
-export const Route = createFileRoute("/login")({ component: Login });
-```
-
-Path params are `$name` in both the filename and the route path; `useParams()` from `@/lib/nav`
-reads them unchanged. Full pattern, including `ssr: false` for per-user routes:
-[`../_shared/routing.md`](../_shared/routing.md).
-
-## What you build (not shipped)
-The **home / landing page**, the **`Header`** (mount `<MemberMenu/>` in it) and a **`Footer`** — the
-two you drop into the `Layout` (STEP 3) so they wrap every route — plus the overall brand story,
-styled from the same base44 tokens/classes. The nav's account control is a `<MemberMenu/>` (shows
-"Log in" for a visitor, the member's name + log-out once signed in — render it as-is, don't wrap it in
-your own auth text button):
-
-```jsx
-import { useState, useEffect } from "react";
-import { Link } from "react-router-dom";
-import MemberMenu from "@/components/MemberMenu";
-
-// Responsive header: choose ONE branch with a state flag, so <MemberMenu/> mounts once.
-// Do NOT render a desktop nav AND a mobile nav toggled by `hidden md:flex` / `md:hidden`:
-// these navs are inline-styled, and an inline `display` beats a Tailwind class, so `hidden`
-// never applies — BOTH branches render and you get two menus. One branch = one menu.
-export function Header() {
-  const [mobile, setMobile] = useState(() => window.innerWidth < 768);
-  useEffect(() => {
-    const onResize = () => setMobile(window.innerWidth < 768);
-    window.addEventListener("resize", onResize);            // keep it reactive to viewport changes
-    return () => window.removeEventListener("resize", onResize);
-  }, []);
-  return (
-    <nav style={{ display: "flex", alignItems: "center", justifyContent: "space-between" }}>
-      {/* brand/logo */}
-      {mobile
-        ? <YourMenu />                                       // your hamburger + <MemberMenu/> here
-        : <div style={{ display: "flex", gap: 24 }}><Link to="/">Home</Link><MemberMenu /></div>}
-    </nav>
-  );
-}
-```
-Everything visual reads base44's design tokens (`index.css`), so your home/nav match the shipped pages automatically.
-
-**Editing a component and the change doesn't show? It's the preview, not your code.** The dev preview
-can serve a stale module after a write. Before diagnosing a visual bug you just "fixed", do a fresh
-full navigate/reload of the preview and re-check — don't keep rewriting correct code against a stale
-render.
-
-## Using the client from your own UI (session, gating, "my …" reads)
-
-```jsx
-import { useMember } from "@/context/MemberContext";
-
-// useMember() gives:
-// { member, loggedIn, loading, refresh(), logout(returnTo?) }
-// - member is null for a visitor OR when the Members Area app isn't installed (loggedIn still true).
-// - login/register happen in the shipped LoginForm; call refresh() after your own login call.
-
-function Greeting() {
-  const { loggedIn, member, loading } = useMember();
-  if (loading) return null;
-  return loggedIn ? <span>Hi, {member?.profile?.nickname || "member"}</span> : <a href="/login">Log in</a>;
-}
-
-// A member-only read runs as the member on the SAME shared client — no extra auth, no `elevate`:
-import { wixApiRequest } from "@/rest/wix-client";
-const { orders } = await wixApiRequest("/ecom/v1/orders/query", { body: { query: {} } }); // member's own
-```
-
-**"My items" in a CMS collection** (member-owned rows) → the **OWNED RECORDS** recipe in
-`references/cms/INSTRUCTIONS.md`. Two facts from this vertical carry over: the member id lives at
-**`member.id`**, and `member` is `null` for a logged-in member whenever the Members Area app is absent
-(see *Identity vs. profile* below). Because of that second one, prefer a collection seeded
-`read: SITE_MEMBER_AUTHOR` — the server scopes reads by the caller's own token, so it works in both states.
-
-## Extending the client — the auth helper's exports (copy as-is, do NOT re-derive)
-Building auth UI beyond the shipped pages? Call these exports (from `@/rest/wix-members-auth`) — the
-same ones the shipped hook/pages use:
-
-```js
-// (A) Credential — handle EVERY branch, not just SUCCESS. register/login/verifyEmail → { state, ... }:
-import { login, register, verifyEmail, MemberAuthError } from "@/rest/wix-members-auth";
-try {
-  const res = await login(email, password);
-  if (res.state === "SUCCESS") { /* logged in; res.member (or null w/o Members Area app) */ }
-  else if (res.state === "REQUIRE_EMAIL_VERIFICATION") { /* 6-digit code emailed; verifyEmail(code, res.stateToken) */ }
-  else if (res.state === "REQUIRE_OWNER_APPROVAL") { /* show a pending notice — not an error */ }
-} catch (e) {
-  if (e instanceof MemberAuthError) show(e.message); else throw e;   // .code: invalidCredentials, emailAlreadyExists, …
-}
-// Custom sign-up fields → register's 3rd arg `profile` ({ firstName, lastName, nickname, addresses, … }).
-// Arbitrary customFields keys must be defined in the Members Area app first, or they're silently dropped.
-
-// (B) Social / SSO — button + the shipped /callback page:
-import { startSocialLogin, IDP } from "@/rest/wix-members-auth";
-const callbackUri = new URL("/callback", window.location.origin).href;   // must be allow-listed
-startSocialLogin(IDP.GOOGLE, callbackUri, window.location.pathname);      // custom SSO: pass a connectionId as idp
-```
-
-Every export in `wix-members-auth.js` links its own reference page inline. The two areas they sit in
-map onto the identity / profile split below — auth is the headless OAuth app, the profile is the
-Members Area app:
-- Headless authentication (login, register, verify, tokens): https://dev.wix.com/docs/api-reference/business-management/headless/authentication.md
-- Headless redirects (social/SSO + logout): https://dev.wix.com/docs/api-reference/business-management/headless/redirects.md
-- Members (the member profile, needs the Members Area app): https://dev.wix.com/docs/api-reference/crm/members-contacts/members.md
-
-## Identity vs. profile — don't conflate them
-- **Identity / auth** — sign up, log in, log out, "is this caller a member?". Native to the headless
-  OAuth app. **No app install needed** — every login mechanism here runs on this layer alone.
-- **Member profile / Members Area** — name / photo / roles, an account page, custom-field definitions.
-  Served by the **Members Area app**, which must be installed. If `getCurrentMember()`/`useMember().member`
-  is `null` while `loggedIn` is `true`, suspect the app isn't installed — **not a code bug**.
-
-Fallback only — when you hit an error or need something not shown here (password reset, custom SSO
-connection ids, a profile field these snippets don't have): read the relevant shipped file under
-`src/rest/`, or look it up via the documentation skill available in your environment.
-
-## Hard rules
-- **Custom login only** — the member logs in on **your** UI; never redirect them to a Wix-hosted login page.
-- **One shared client** — login swaps the token set on `wix-client.js`; reuse it for everything so the
-  member identity carries across the app. Never mint a second client or re-mint anonymously after login.
-- Copy `wix-members-auth.js` verbatim; extend by *calling* its exports, never by editing them.
-- Header/footer live in a `Layout` around `<Outlet/>` (STEP 3) — never edit the shipped `Login`/`Account`/`Callback` to add chrome; the fixed top region owns positioning (`<WixManageBanner/>` above a plain in-flow `<Header/>`).
-- **Never fake a member** — no mock logged-in state, invented profile, or roles. Render the real member or the real logged-out state.
-- **Fail loudly** — the helper throws `MemberAuthError`; surface `.message`, don't swallow it.
-- No `elevate` / admin scope, and no headless MFA/TOTP — those security layers are dashboard-governed.
-
-## Point the user to their dashboard
-Some setup only happens in the Wix dashboard — always give the user the deep links (substitute the
-site's `metaSiteId` from the handoff / `ListWixSites`):
-- **Allowed authorization redirect URIs** (the #1 gotcha) — `https://manage.wix.com/dashboard/{metaSiteId}/oauth-apps-settings`.
-  Add the **app origin** (for credential login off `localhost:4321`) and the **exact `/callback` URL**
-  (for social/SSO) — character-for-character matching your `startSocialLogin` `callbackUri`.
-- **Members Area app** (profile data + custom fields) — `https://manage.wix.com/dashboard/{metaSiteId}/member-permissions`
-- **Signup security** (email verification, owner approval, reCAPTCHA) — `Dashboard → Settings → Login & Security`
-- **Custom SSO connection** (to obtain a `connectionId`) — the project's IAM / SSO settings in the Business Manager.
-
-## Seeding
-**Nothing to seed** — members self-register; there is no build-time member to create. See
-`seed/SEED.md` (separate from this client build; the members work is entirely frontend wiring).
-
-## Verify (before declaring done)
-- [ ] Client files copied into `src/`; `WIX_CLIENT_ID` set (not the placeholder).
-- [ ] Opened the vertical's data route(s) (not just the home page) — `/login` and `/account` — and confirmed the shipped components render themed (surface, text, brand) with images.
-- [ ] `Layout` (fixed `<WixManageBanner/>` + `<Header/>` region, then `<Outlet/>` + Footer) wraps all routes; shipped `Login`/`Account`/`Callback` untouched; content clears the fixed chrome; `<MemberProvider>` wraps the tree; `<MemberMenu/>` in the header.
-- [ ] Sign-up: `register()` reaches `SUCCESS` (or `REQUIRE_EMAIL_VERIFICATION` handled via the code entry).
-- [ ] Log-in: `login()` reaches `SUCCESS`; wrong password shows `invalidCredentials`, not a crash.
-- [ ] After login `useMember().loggedIn` is `true`; `/account` renders the member (or the identity-only fallback with the Members Area app not installed — documented, not a bug). `/account` bounces a visitor to `/login`.
-- [ ] Session survives reload (same client); logout clears it and the next load is a clean anonymous visitor.
-- [ ] Social: the button redirects to the provider and `/callback` logs the member in (callback URL allow-listed), or is flagged as pending host setup.
-- [ ] No mocked member state, profile, or roles anywhere.
-- [ ] Told the user about any required dashboard setup (allowed redirect URIs, Members Area app) with deep links.

package/skills/wix-vibe-headless/references/members/app/components/LoginForm.jsx

@@ -1,101 +0,0 @@
-// Credential login/sign-up form — a thin view over useLoginForm (all logic lives in the hook).
-// Styled with base44 design tokens (shadcn Tailwind classes); don't rewrite this JSX. Renders one of
-// three phases the hook drives: the email/password form, the 6-digit verification-code entry, or a
-// pending-approval notice.
-import { useLoginForm } from "@/hooks/useLoginForm";
-
-const inputCls =
-  "w-full py-[11px] px-3 box-border text-[15px] border border-input rounded-sm bg-background text-foreground";
-const labelCls = "block text-[13px] text-muted-foreground mb-1.5";
-
-export default function LoginForm({ onSuccess }) {
-  const f = useLoginForm({ onSuccess });
-
-  if (f.phase === "pending") {
-    return <Notice>Your account is awaiting owner approval. You'll be able to sign in once it's approved.</Notice>;
-  }
-
-  if (f.phase === "verify") {
-    return (
-      <form onSubmit={f.submitCode} className={formCls}>
-        <p className="text-muted-foreground m-0 leading-normal">
-          We emailed you a 6-digit code. Enter it to finish.
-        </p>
-        <div>
-          <label className={labelCls} htmlFor="mf-code">Verification code</label>
-          <input id="mf-code" className={inputCls} inputMode="numeric" autoComplete="one-time-code"
-            value={f.code} onChange={(e) => f.setCode(e.target.value)} />
-        </div>
-        {f.error && <ErrorText>{f.error}</ErrorText>}
-        <SubmitButton busy={f.busy}>Verify</SubmitButton>
-      </form>
-    );
-  }
-
-  return (
-    <form onSubmit={f.submit} className={formCls}>
-      <div className="flex gap-2">
-        <ModeTab active={f.mode === "login"} onClick={() => f.switchMode("login")}>Sign in</ModeTab>
-        <ModeTab active={f.mode === "register"} onClick={() => f.switchMode("register")}>Sign up</ModeTab>
-      </div>
-
-      {f.mode === "register" && (
-        <div className="flex gap-3">
-          <div className="flex-1">
-            <label className={labelCls} htmlFor="mf-first">First name</label>
-            <input id="mf-first" className={inputCls} value={f.fields.firstName}
-              onChange={(e) => f.setField("firstName", e.target.value)} />
-          </div>
-          <div className="flex-1">
-            <label className={labelCls} htmlFor="mf-last">Last name</label>
-            <input id="mf-last" className={inputCls} value={f.fields.lastName}
-              onChange={(e) => f.setField("lastName", e.target.value)} />
-          </div>
-        </div>
-      )}
-
-      <div>
-        <label className={labelCls} htmlFor="mf-email">Email</label>
-        <input id="mf-email" type="email" autoComplete="email" required className={inputCls}
-          value={f.fields.email} onChange={(e) => f.setField("email", e.target.value)} />
-      </div>
-      <div>
-        <label className={labelCls} htmlFor="mf-pass">Password</label>
-        <input id="mf-pass" type="password" required className={inputCls}
-          autoComplete={f.mode === "register" ? "new-password" : "current-password"}
-          value={f.fields.password} onChange={(e) => f.setField("password", e.target.value)} />
-      </div>
-
-      {f.error && <ErrorText>{f.error}</ErrorText>}
-      <SubmitButton busy={f.busy}>{f.mode === "register" ? "Create account" : "Sign in"}</SubmitButton>
-    </form>
-  );
-}
-
-const formCls = "flex flex-col gap-4";
-
-function ModeTab({ active, onClick, children }) {
-  return (
-    <button type="button" onClick={onClick}
-      className={`flex-1 py-2 px-0 cursor-pointer text-sm font-semibold border border-border rounded-sm ${active ? "bg-card text-foreground" : "bg-transparent text-muted-foreground"}`}
-    >{children}</button>
-  );
-}
-
-function SubmitButton({ busy, children }) {
-  return (
-    <button type="submit" disabled={busy}
-      className="px-6 py-3 cursor-pointer bg-primary text-primary-foreground border-none rounded-sm text-[15px] font-semibold disabled:opacity-50 disabled:cursor-not-allowed"
-    >{busy ? "…" : children}</button>
-  );
-}
-
-function ErrorText({ children }) {
-  return <p role="alert" className="text-destructive m-0 text-sm">{children}</p>;
-}
-
-function Notice({ children }) {
-  return (
-    <p className="p-4 bg-card text-foreground border border-border rounded-lg leading-normal m-0">{children}</p>
-  );
-}

package/skills/wix-vibe-headless/references/members/app/components/MemberMenu.jsx

@@ -1,33 +0,0 @@
-// Header account control — the members analog of a cart button. Reads useMember() and renders the
-// session state: a "Log in" link for a visitor, or the member's name + a log-out button once signed
-// in. Drop it into the Header you build (STEP 4), same as the storefront's CartButton. Pure UI reading
-// useMember + base44 design tokens (shadcn Tailwind classes) — render it as-is; don't wrap it in your own auth logic.
-import { Link } from "@/lib/nav";
-import { useMember } from "@/context/MemberContext";
-
-export default function MemberMenu() {
-  const { loggedIn, member, loading, logout } = useMember();
-
-  if (loading) return <span className="text-muted-foreground text-sm">…</span>;
-
-  if (!loggedIn) {
-    return (
-      <Link to="/login" className="text-primary no-underline text-sm font-semibold">Log in</Link>
-    );
-  }
-
-  // member may be null when logged in but the Members Area app isn't installed — fall back to a
-  // generic label rather than assuming a profile (see INSTRUCTIONS → identity vs. profile).
-  const name = member?.profile?.nickname || member?.contact?.firstName || member?.loginEmail || "Account";
-
-  return (
-    <div className="flex items-center gap-3">
-      <Link to="/account" className="text-foreground no-underline text-sm font-semibold">
-        {name}
-      </Link>
-      <button type="button" onClick={() => logout()}
-        className="bg-transparent border border-border rounded-full py-1 px-3 text-[13px] cursor-pointer text-muted-foreground"
-      >Log out</button>
-    </div>
-  );
-}

package/skills/wix-vibe-headless/references/members/app/components/RequireAuth.jsx

@@ -1,21 +0,0 @@
-// Route gate for member-only surfaces. Wrap any protected element in <RequireAuth> — it renders the
-// children only for a logged-in member, otherwise redirects to /login (carrying the attempted path so
-// login can return there). This is the gate the shipped Account page uses; reuse it for your own
-// member-only routes ("my orders", "my plans", …). Reads useMember; no styling of its own.
-import { Navigate, useLocation } from "@/lib/nav";
-import { useMember } from "@/context/MemberContext";
-
-export default function RequireAuth({ children, fallback = "/login" }) {
-  const { loggedIn, loading } = useMember();
-  const location = useLocation();
-
-  // Wait for the initial session read before deciding — otherwise a logged-in member gets bounced to
-  // /login on first paint while the token check is still resolving.
-  if (loading) {
-    return <div className="p-12 text-center text-muted-foreground">Loading…</div>;
-  }
-  if (!loggedIn) {
-    return <Navigate to={fallback} replace state={{ from: location.pathname }} />;
-  }
-  return children;
-}

package/skills/wix-vibe-headless/references/members/app/components/SocialButtons.jsx

@@ -1,29 +0,0 @@
-// "Continue with Google / Facebook" buttons. Social/SSO is a FULL-PAGE redirect: this kicks it off
-// with startSocialLogin, which sends the browser to the provider and returns to your /callback route
-// (mount Callback there). callbackUri MUST be allow-listed on the OAuth app or Wix rejects it before
-// returning — see INSTRUCTIONS (allowedRedirectUris). Styled with base44 design tokens (shadcn Tailwind classes).
-import { startSocialLogin, IDP } from "@/rest/wix-members-auth";
-
-// The exact /callback URL that must be registered as an allowed redirect URI. `returnTo` is where
-// the member lands after login — carry the current path so they resume where they started.
-function go(idp) {
-  const callbackUri = new URL("/callback", window.location.origin).href;
-  startSocialLogin(idp, callbackUri, window.location.pathname);
-}
-
-export default function SocialButtons() {
-  return (
-    <div className="flex flex-col gap-2.5">
-      <ProviderButton onClick={() => go(IDP.GOOGLE)}>Continue with Google</ProviderButton>
-      <ProviderButton onClick={() => go(IDP.FACEBOOK)}>Continue with Facebook</ProviderButton>
-    </div>
-  );
-}
-
-function ProviderButton({ onClick, children }) {
-  return (
-    <button type="button" onClick={onClick}
-      className="w-full py-[11px] px-4 cursor-pointer text-[15px] font-semibold bg-background text-foreground border border-border rounded-sm"
-    >{children}</button>
-  );
-}

package/skills/wix-vibe-headless/references/members/app/context/MemberContext.jsx

@@ -1,54 +0,0 @@
-// Member auth state — mirrors the Wix SESSION on the shared client (never a local guess). Wrap the
-// app in <MemberProvider>; every component reads useMember(). Login mechanisms (credential/social)
-// write member tokens onto @/rest/wix-client via the auth helper; this provider reads that session
-// and exposes the current member + logout. Data wiring is correct as-is — do not re-derive it.
-//
-// NAMED useMember (not useAuth) ON PURPOSE: the Base44 App.jsx already ships a platform
-// AuthProvider/useAuth for the builder account — a second `useAuth` would shadow it. This is the
-// WIX member session, kept under its own name so the two never collide.
-import { createContext, useContext, useState, useEffect, useCallback } from "react";
-import { isLoggedIn, getCurrentMember, logout as apiLogout } from "@/rest/wix-members-auth";
-
-const MemberContext = createContext(null);
-
-export function MemberProvider({ children }) {
-  const [member, setMember] = useState(null);
-  const [loggedIn, setLoggedIn] = useState(false);
-  const [loading, setLoading] = useState(true);
-
-  // Re-read the session from the shared client. Call after a successful login so the header/account
-  // update without a reload. `member` stays null (with loggedIn true) when the Members Area app
-  // isn't installed — that's setup, not a bug (see INSTRUCTIONS → identity vs. profile).
-  const refresh = useCallback(async () => {
-    setLoading(true);
-    try {
-      const active = isLoggedIn();
-      setLoggedIn(active);
-      setMember(active ? await getCurrentMember() : null);
-    } finally {
-      setLoading(false);
-    }
-  }, []);
-
-  useEffect(() => { refresh(); }, [refresh]);
-
-  // logout() clears local tokens then redirects through the Wix logout URL, so it navigates away;
-  // we still reset local state first for the instant before the redirect lands.
-  const logout = useCallback(async (returnTo) => {
-    setMember(null);
-    setLoggedIn(false);
-    await apiLogout(returnTo);
-  }, []);
-
-  return (
-    <MemberContext.Provider value={{ member, loggedIn, loading, refresh, logout }}>
-      {children}
-    </MemberContext.Provider>
-  );
-}
-
-export function useMember() {
-  const ctx = useContext(MemberContext);
-  if (!ctx) throw new Error("useMember must be used within <MemberProvider>");
-  return ctx;
-}

package/skills/wix-vibe-headless/references/members/app/hooks/useLoginForm.js

@@ -1,77 +0,0 @@
-// useLoginForm — all credential-auth logic, no markup: hold the form fields, run login/register,
-// and DRIVE THE STATE MACHINE. register()/login()/verifyEmail() resolve to { state, member?,
-// stateToken? }; SUCCESS is only one of the branches. Handling every branch (email verification,
-// owner approval) and mapping MemberAuthError to a message is the bug-prone part — keep it verbatim;
-// the LoginForm component only renders what this returns. Social/SSO does NOT go through here (it's
-// a full-page redirect — see SocialButtons + the /callback page).
-import { useState } from "react";
-import { login, register, verifyEmail, MemberAuthError } from "@/rest/wix-members-auth";
-import { useMember } from "@/context/MemberContext";
-
-export function useLoginForm({ onSuccess } = {}) {
-  const { refresh } = useMember();
-  const [mode, setMode] = useState("login");        // "login" | "register"
-  const [fields, setFields] = useState({ email: "", password: "", firstName: "", lastName: "" });
-  // phase drives which UI shows: the form, the 6-digit code entry, or a pending-approval notice.
-  const [phase, setPhase] = useState("form");        // "form" | "verify" | "pending"
-  const [stateToken, setStateToken] = useState(null);
-  const [code, setCode] = useState("");
-  const [error, setError] = useState(null);
-  const [busy, setBusy] = useState(false);
-
-  const setField = (name, value) => setFields((f) => ({ ...f, [name]: value }));
-
-  // Route a resolved { state } to the right phase. On SUCCESS refresh the member session (so the
-  // header/account update) and hand control back to the caller (navigate away).
-  async function applyResult(res) {
-    if (res.state === "SUCCESS") {
-      await refresh();
-      onSuccess?.(res.member);
-    } else if (res.state === "REQUIRE_EMAIL_VERIFICATION") {
-      setStateToken(res.stateToken);
-      setPhase("verify");
-    } else if (res.state === "REQUIRE_OWNER_APPROVAL") {
-      setPhase("pending");
-    }
-  }
-
-  // Wrap a helper call: clear the error, flip busy, map MemberAuthError to a shown message.
-  // emailAlreadyExists on register → bounce the user to the login tab instead of erroring out.
-  async function run(fn) {
-    setError(null);
-    setBusy(true);
-    try {
-      await applyResult(await fn());
-    } catch (e) {
-      if (e instanceof MemberAuthError) {
-        if (e.code === "emailAlreadyExists") { setMode("login"); setError(e.message); }
-        else setError(e.message);
-      } else throw e;
-    } finally {
-      setBusy(false);
-    }
-  }
-
-  const submit = (e) => {
-    e?.preventDefault?.();
-    const { email, password, firstName, lastName } = fields;
-    if (mode === "register") {
-      const profile = (firstName || lastName) ? { firstName, lastName } : undefined;
-      return run(() => register(email, password, profile));
-    }
-    return run(() => login(email, password));
-  };
-
-  const submitCode = (e) => {
-    e?.preventDefault?.();
-    return run(() => verifyEmail(code, stateToken));
-  };
-
-  const switchMode = (next) => { setMode(next); setError(null); };
-
-  return {
-    mode, switchMode, fields, setField,
-    phase, code, setCode,
-    error, busy, submit, submitCode,
-  };
-}