@tribe-nest/forge 3.59.0 → 3.60.0

package/src/ui/headless/membership/MembershipGate.tsx

@@ -1,44 +0,0 @@
-import type { ReactNode } from "react";
-import { usePublicAuth } from "../../../contexts/PublicAuthContext";
-import { getMembershipAccess } from "../../../utils/membershipAccess";
-
-export interface MembershipGateState {
-  hasAccess: boolean;
-  isAuthenticated: boolean;
-}
-
-export interface MembershipGateProps {
-  /**
-   * Tier ids that unlock the content. Omitted/empty → any active membership
-   * unlocks. (For per-item gates where the server already returns `hasAccess`,
-   * pass it via `access`.)
-   */
-  tiers?: string[];
-  /** Override the access decision (e.g. server-provided `post.hasAccess`). */
-  access?: boolean;
-  children: ReactNode;
-  /** Rendered when locked — static node or a render-fn given the gate state. */
-  fallback?: ReactNode | ((state: MembershipGateState) => ReactNode);
-}
-
-/**
- * Headless access gate. Renders children when the member has access, otherwise
- * the fallback. Behavior (who has access) is fixed by the server/membership;
- * the locked UI is entirely yours.
- */
-export function MembershipGate({ tiers, access, children, fallback }: MembershipGateProps) {
-  const { user, isAuthenticated } = usePublicAuth();
-  const membership = user?.membership;
-  // The SERVER's access decision, not a `status === "active"` compare. That
-  // compare locked out members in `past_due`/`grace` — states the backend
-  // deliberately keeps access through — so a card that bounced cost them the
-  // content they were still paying for.
-  const membershipGrantsAccess = getMembershipAccess(membership).hasAccess;
-  const tierAllows = !tiers?.length || (membership ? tiers.includes(membership.membershipTierId) : false);
-
-  const hasAccess = access ?? (membershipGrantsAccess && tierAllows);
-
-  if (hasAccess) return <>{children}</>;
-  if (typeof fallback === "function") return <>{fallback({ hasAccess, isAuthenticated })}</>;
-  return <>{fallback ?? null}</>;
-}

package/src/ui/styled/_tests/AccountDashboardCommunity.spec.tsx

@@ -1,149 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { renderToStaticMarkup } from "react-dom/server";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
-import { ForgeClientProvider } from "../../../provider/ForgeProvider";
-import { PublicAuthContext } from "../../../contexts/PublicAuthContext";
-import { ForgeThemeProvider } from "../../theme/ForgeThemeProvider";
-import { communityKeys, type CommunitySpace } from "../../../data/queries/useCommunity";
-import { AccountDashboard } from "../AccountDashboard";
-
-/**
- * The account page's way into the member area.
- *
- * Before this, a signed-in member landed on the membership card and the only
- * doors on it led back to billing: change the plan, cancel it, fix the card.
- * The member area they were paying for was reachable only by typing the URL.
- *
- * The first version gated the link on `/public/community/spaces` returning a
- * space the caller could open, which hid it from precisely the fans who had not
- * joined yet. Being signed in is now the whole gate: the member home shows the
- * locked posts and the way to buy access, so it is never a dead end.
- *
- * Rendered through `react-dom/server`: no DOM, no effects, so the spaces query
- * is SEEDED into the react-query cache rather than mocked, which keeps the real
- * data path in place for the rest of the card.
- */
-
-const PROFILE_ID = "profile-1";
-
-const space = (overrides: Partial<CommunitySpace> = {}): CommunitySpace => ({
-  id: "space-1",
-  profileId: PROFILE_ID,
-  name: "Backstage",
-  slug: "backstage",
-  description: null,
-  type: "feed",
-  courseId: null,
-  order: 0,
-  archivedAt: null,
-  createdAt: "2026-01-01T00:00:00.000Z",
-  tiers: [],
-  ...overrides,
-});
-
-/** A signed-in member holding a paid tier that renews. */
-const member = {
-  id: "account-1",
-  email: "fan@example.com",
-  firstName: "Fan",
-  lastName: "Person",
-  kind: "fan",
-  status: "active",
-  createdAt: "2026-01-01T00:00:00.000Z",
-  updatedAt: "2026-01-01T00:00:00.000Z",
-  membership: {
-    id: "membership-1",
-    membershipTierId: "tier-1",
-    endDate: "2026-12-01T00:00:00.000Z",
-    status: "active",
-    startDate: "2026-01-01T00:00:00.000Z",
-    subscriptionAmount: 10,
-    subscriptionCurrency: "USD",
-    billingCycle: "month",
-    membershipTier: { id: "tier-1", name: "Inner Circle", benefits: [] },
-  },
-};
-
-/** The same signed-in fan, with no membership of any kind. */
-const nonMember = { ...member, membership: undefined };
-
-/**
- * The membership tab as a Forge code website draws it.
- *
- * `spaces === null` stands for the query never having answered, which is the
- * state every first paint sits in.
- */
-function render(opts: {
-  spaces: CommunitySpace[] | null;
-  user?: typeof member | typeof nonMember | null;
-  onNavigateCommunity?: () => void;
-}): string {
-  const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false } } });
-  if (opts.spaces) queryClient.setQueryData(communityKeys.spaces(PROFILE_ID), opts.spaces);
-  const user = opts.user === undefined ? member : opts.user;
-
-  return renderToStaticMarkup(
-    <QueryClientProvider client={queryClient}>
-      <ForgeClientProvider apiUrl="http://api.test" profileId={PROFILE_ID}>
-        <PublicAuthContext.Provider
-          value={{ user, currencies: null, userSelectedCurrency: "USD", logout: () => {} } as never}
-        >
-          <ForgeThemeProvider
-            theme={{ colors: { text: "#111111", background: "#ffffff", primary: "#6d28d9" }, cornerRadius: 8 }}
-          >
-            <AccountDashboard
-              tab="membership"
-              onNavigateMembership={() => {}}
-              onNavigateCommunity={opts.onNavigateCommunity}
-            />
-          </ForgeThemeProvider>
-        </PublicAuthContext.Provider>
-      </ForgeClientProvider>
-    </QueryClientProvider>,
-  );
-}
-
-describe("AccountDashboard: the way into the member area", () => {
-  it("REGRESSION: offers the member area to a member who has a space to open", () => {
-    // The original gap this closes. Without it the membership card's only exits
-    // are Change and Cancel, and the member area is unreachable from here.
-    const html = render({ spaces: [space()], onNavigateCommunity: () => {} });
-
-    expect(html).toContain("Member Area");
-  });
-
-  it("REGRESSION: offers the member area to a signed-in fan with NO membership", () => {
-    // The second gap. The link used to require an openable space, so a fan who
-    // had not joined saw no way in, which is the fan the member home is most
-    // useful to: that page shows the locked posts and the offer to join.
-    const html = render({ spaces: [], user: nonMember, onNavigateCommunity: () => {} });
-
-    expect(html).toContain("Member Area");
-    // Still the non-member card and not some other state.
-    expect(html).toContain("You don&#x27;t have an active membership.");
-  });
-
-  it("REGRESSION: offers it before the spaces query has answered", () => {
-    // First paint has no cached answer. The link no longer waits on that read,
-    // so it does not appear a beat late.
-    const html = render({ spaces: null, onNavigateCommunity: () => {} });
-
-    expect(html).toContain("Member Area");
-  });
-
-  it("draws nothing when the host site has no member-area route to send anyone to", () => {
-    // `onNavigateCommunity` is optional. A site that leaves it out gets no
-    // button rather than a dead one.
-    const html = render({ spaces: [space()] });
-
-    expect(html).not.toContain("Member Area");
-  });
-
-  it("draws nothing for a visitor who is not signed in", () => {
-    // The member area is behind a login. Offering it to a signed-out visitor
-    // sends them at a guard, not at the content.
-    const html = render({ spaces: [space()], user: null, onNavigateCommunity: () => {} });
-
-    expect(html).not.toContain("Member Area");
-  });
-});

package/src/ui/styled/_tests/AccountDashboardTrial.spec.tsx

@@ -1,105 +0,0 @@
-// @vitest-environment jsdom
-import { describe, it, expect, afterEach } from "vitest";
-import { render, screen, fireEvent, cleanup } from "@testing-library/react";
-import axios, { type AxiosAdapter, type InternalAxiosRequestConfig } from "axios";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
-import { ForgeClientProvider } from "../../../provider/ForgeProvider";
-import { PublicAuthContext } from "../../../contexts/PublicAuthContext";
-import { ForgeThemeProvider } from "../../theme/ForgeThemeProvider";
-import { AccountDashboard } from "../AccountDashboard";
-
-/**
- * The account page during a free trial: the date the trial ends and what is
- * charged after it replace "Renews on", and cancelling says access lasts to the
- * trial end with nothing charged.
- */
-
-const DAY = 24 * 60 * 60 * 1000;
-const inDays = (n: number) => new Date(Date.now() + n * DAY).toISOString();
-const fmt = (iso: string) =>
-  new Date(iso).toLocaleDateString("en-US", { year: "numeric", month: "short", day: "numeric" });
-
-const memberWith = (membership: Record<string, unknown>) => ({
-  id: "account-1",
-  email: "fan@example.com",
-  firstName: "Fan",
-  lastName: "Person",
-  kind: "fan",
-  status: "active",
-  createdAt: "2026-01-01T00:00:00.000Z",
-  updatedAt: "2026-01-01T00:00:00.000Z",
-  membership: {
-    id: "membership-1",
-    membershipTierId: "tier-1",
-    status: "active",
-    startDate: "2026-09-17T00:00:00.000Z",
-    subscriptionAmount: 10,
-    subscriptionCurrency: "USD",
-    billingCycle: "month",
-    membershipTier: { id: "tier-1", name: "Inner Circle", benefits: [] },
-    ...membership,
-  },
-});
-
-let realAdapter: AxiosAdapter | undefined;
-
-function mount(user: unknown) {
-  // Every request answers empty, so the tab's side queries never reach a network.
-  realAdapter = axios.defaults.adapter as AxiosAdapter | undefined;
-  axios.defaults.adapter = (async (config: InternalAxiosRequestConfig) =>
-    ({ data: [], status: 200, statusText: "OK", headers: {}, config }) as never) as AxiosAdapter;
-  const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false } } });
-  return render(
-    <QueryClientProvider client={queryClient}>
-      <ForgeClientProvider apiUrl="http://api.test" profileId="profile-1">
-        <PublicAuthContext.Provider
-          value={{ user, currencies: null, userSelectedCurrency: "USD", logout: () => {} } as never}
-        >
-          <ForgeThemeProvider theme={{ colors: { text: "#111111", background: "#ffffff", primary: "#6d28d9" }, cornerRadius: 8 }}>
-            <AccountDashboard tab="membership" onNavigateMembership={() => {}} />
-          </ForgeThemeProvider>
-        </PublicAuthContext.Provider>
-      </ForgeClientProvider>
-    </QueryClientProvider>,
-  );
-}
-
-afterEach(() => {
-  cleanup();
-  if (realAdapter) axios.defaults.adapter = realAdapter;
-});
-
-describe("AccountDashboard: a membership in its free trial", () => {
-  it("shows the trial end and what is charged after it, instead of Renews on", () => {
-    const ends = inDays(10);
-    mount(memberWith({ trialEndsAt: ends, endDate: ends }));
-
-    const state = screen.getByTestId("membership-trial-state");
-    expect(state.textContent).toContain(`Free trial until ${fmt(ends)}`);
-    expect(state.textContent).toMatch(new RegExp(`Then .*10.* per month from ${fmt(ends)}\\.`));
-    expect(document.body.textContent).not.toContain("Renews on");
-  });
-
-  it("says access lasts to the trial end with nothing charged when cancelling", () => {
-    const ends = inDays(10);
-    mount(memberWith({ trialEndsAt: ends, endDate: ends }));
-
-    fireEvent.click(screen.getByRole("button", { name: "Cancel" }));
-    const dialog = screen.getByRole("alertdialog");
-    expect(dialog.textContent).toContain(
-      `Your free trial will not turn into a paid membership. You keep your benefits until ${fmt(ends)}, and nothing is charged.`,
-    );
-  });
-
-  it("says nothing will be charged once a trial is cancelled", () => {
-    const ends = inDays(10);
-    mount(memberWith({ trialEndsAt: ends, endDate: ends, cancelAtPeriodEnd: true }));
-    expect(screen.getByTestId("membership-trial-state").textContent).toContain("Cancelled. Nothing will be charged.");
-  });
-
-  it("shows no trial line once the trial has ended", () => {
-    mount(memberWith({ trialEndsAt: inDays(-5), endDate: inDays(25) }));
-    expect(screen.queryByTestId("membership-trial-state")).toBeNull();
-    expect(document.body.textContent).toContain("Renews on");
-  });
-});