@oxyhq/services 27.0.0 → 27.1.1

package/lib/module/ui/components/FollowTargetButton.js

@@ -0,0 +1,317 @@
+"use strict";
+
+/**
+ * `FollowTargetButton` — one button for everything an Oxy user can follow.
+ *
+ * Follows a TARGET of any registered kind: a person, a topic, a channel, a
+ * store, an artist. Nothing in this file branches on what the target is, which
+ * is the property that lets an application this package has never heard of use
+ * it without a release.
+ *
+ * ## Two controls, not one
+ *
+ * The main press does the obvious thing. The chevron beside it opens the
+ * choices that a single press cannot express — follow for a while, stop showing
+ * this here without giving it up everywhere — and those belong behind a
+ * disclosure precisely because they are not what most people want most of the
+ * time. Bloom's `Menu` renders as a bottom sheet on native and a dropdown on
+ * web, so this is one component and not a platform fork.
+ *
+ * ## Verbs
+ *
+ * "Follow" is wrong for half the things in the ecosystem: you subscribe to a
+ * channel, you join a community, you watch a listing. The verb is a prop with a
+ * small vocabulary of defaults and a full override, rather than a lookup keyed
+ * on kind — a kind→verb table in this package would need a release every time
+ * an application invents a kind, which is exactly the coupling #809 removes.
+ *
+ * ## Relationship to the legacy `FollowButton`
+ *
+ * `FollowButton` follows a USER through the Mongo-backed social graph and
+ * remains the correct component for that until the user graph is migrated onto
+ * `/v2/follows`. When it is, that component is deleted and this one takes the
+ * name — not aliased, not deprecated in place.
+ */
+
+import { memo, useCallback, useMemo } from 'react';
+import { View } from 'react-native';
+import { Button } from '@oxyhq/bloom/button';
+import { ChevronBottom_Stroke2_Corner0_Rounded as ChevronDown } from '@oxyhq/bloom/icons';
+import { Menu, MenuContent, MenuItem, MenuItemText, MenuTrigger } from '@oxyhq/bloom/menu';
+import { toast } from '@oxyhq/bloom/toast';
+import { useFollowTarget } from "../hooks/useFollowTarget.js";
+
+/**
+ * The small vocabulary of verbs the ecosystem actually uses. An application
+ * whose verb is not here passes `labels` instead — the escape hatch exists so
+ * this union never has to grow to accommodate one product's wording.
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const VERB_LABELS = {
+  follow: {
+    idle: 'Follow',
+    active: 'Following',
+    pending: 'Requested',
+    disabled: 'Off here'
+  },
+  subscribe: {
+    idle: 'Subscribe',
+    active: 'Subscribed',
+    pending: 'Requested',
+    disabled: 'Off here'
+  },
+  join: {
+    idle: 'Join',
+    active: 'Joined',
+    pending: 'Requested',
+    disabled: 'Off here'
+  },
+  watch: {
+    idle: 'Watch',
+    active: 'Watching',
+    pending: 'Requested',
+    disabled: 'Off here'
+  }
+};
+
+/** A timed-follow choice offered in the menu. */
+
+const HOUR = 60 * 60;
+
+/**
+ * Defaults chosen for the cases a timed follow is actually for: a live event
+ * tonight, a story running this week. Not a general-purpose duration picker —
+ * an application that needs one passes its own.
+ */
+const DEFAULT_DURATIONS = [{
+  label: '24 hours',
+  seconds: 24 * HOUR
+}, {
+  label: '72 hours',
+  seconds: 72 * HOUR
+}, {
+  label: 'A week',
+  seconds: 7 * 24 * HOUR
+}];
+
+/** One line in the disclosure menu. */
+
+/**
+ * Which choices exist, given the state.
+ *
+ * Pure and exported because this is the product decision, not a rendering
+ * detail: a timed follow is only offered before following, turning it off here
+ * is only offered while following, and NEITHER is offered before the server has
+ * answered — every one of them addresses a relationship that does not exist
+ * yet, so offering them mid-write would mean sending a guessed id.
+ */
+/**
+ * What the main button should do for the current state.
+ *
+ * Exported because the product rule is not obvious from the label alone: a
+ * follow switched off here still reads as "following" globally, so the primary
+ * press must re-enable here — not unfollow everywhere.
+ */
+export function resolveFollowPrimaryAction(input) {
+  if (!input.isFollowing) return 'follow';
+  if (input.applicationMode === 'disabled') return 'enable-here';
+  return 'unfollow';
+}
+export function buildFollowMenuItems(input) {
+  const items = [];
+  if (!input.following) {
+    if (input.durations === false) return items;
+    for (const d of input.durations) {
+      items.push({
+        key: `for-${d.seconds}`,
+        label: `${input.idleVerb} for ${d.label.toLowerCase()}`,
+        action: {
+          type: 'follow-timed',
+          seconds: d.seconds,
+          durationLabel: d.label
+        }
+      });
+    }
+    return items;
+  }
+  if (!input.hasRelationship || input.isPending) return items;
+  items.push(input.applicationMode === 'disabled' ? {
+    key: 'enable-here',
+    label: `Show in ${input.applicationName}`,
+    action: {
+      type: 'enable-here'
+    }
+  } : {
+    key: 'disable-here',
+    label: `Don’t show in ${input.applicationName}`,
+    action: {
+      type: 'disable-here'
+    }
+  });
+  items.push({
+    // Named for what it does. "Unfollow" beside "don't show here" would read as
+    // the same action twice, and the user would pick the wrong one.
+    key: 'unfollow-everywhere',
+    label: 'Unfollow everywhere',
+    action: {
+      type: 'unfollow'
+    }
+  });
+  return items;
+}
+export const FollowTargetButton = /*#__PURE__*/memo(function FollowTargetButton({
+  targetId,
+  verb = 'follow',
+  labels,
+  size = 'medium',
+  style,
+  disabled = false,
+  showOptions = true,
+  durations = DEFAULT_DURATIONS,
+  applicationName,
+  onChange
+}) {
+  const {
+    status,
+    isFollowing,
+    isUnknown,
+    isPending,
+    follow,
+    unfollow,
+    disableHere,
+    enableHere
+  } = useFollowTarget(targetId);
+  const text = useMemo(() => ({
+    ...VERB_LABELS[verb],
+    ...labels
+  }), [verb, labels]);
+  const label = useMemo(() => {
+    if (status.globalState === 'requested') return text.pending;
+    if (!isFollowing) return text.idle;
+    // Followed globally but switched off here. `effectiveState` reports
+    // `not_following` for this, correctly — the question it answers is "does
+    // this act here" — so the label has to be derived from the other two.
+    return status.applicationMode === 'disabled' ? text.disabled : text.active;
+  }, [isFollowing, status.globalState, status.applicationMode, text]);
+
+  // `onChange` fires ONLY when the server accepted the write.
+  //
+  // The mutations never reject — a refusal becomes error state so the button
+  // can render it — so an unconditional `onChange` after `await` reports
+  // INTENT rather than outcome. A caller mirroring the follow somewhere else
+  // (a local shelf, a ranking signal) would then mirror failures too, and the
+  // button beside it would show the server's truth while the mirror showed a
+  // press that did not happen. Same shape of trap as reading `effectiveState`
+  // as "does the user follow this".
+  const handlePrimary = useCallback(async () => {
+    switch (resolveFollowPrimaryAction({
+      isFollowing,
+      applicationMode: status.applicationMode
+    })) {
+      case 'enable-here':
+        if (await enableHere()) onChange?.(true);
+        return;
+      case 'unfollow':
+        if (await unfollow()) onChange?.(false);
+        return;
+      case 'follow':
+        if (await follow()) onChange?.(true);
+    }
+  }, [isFollowing, status.applicationMode, follow, unfollow, enableHere, onChange]);
+  const handleTimed = useCallback(async (seconds, durationLabel) => {
+    if (!(await follow({
+      expiresIn: seconds
+    }))) return;
+    onChange?.(true);
+    // The confirmation is the point: a follow that ends on its own is a
+    // promise, and a user who does not see it made will not believe it.
+    // Which is also why it must not appear when the promise was not made.
+    toast.success(`Following for ${durationLabel.toLowerCase()}`);
+  }, [follow, onChange]);
+  const menuItems = useMemo(() => buildFollowMenuItems({
+    following: isFollowing,
+    applicationMode: status.applicationMode,
+    hasRelationship: Boolean(status.relationshipId),
+    isPending,
+    durations,
+    idleVerb: text.idle,
+    applicationName: applicationName ?? 'this app'
+  }), [isFollowing, status.applicationMode, status.relationshipId, isPending, durations, text.idle, applicationName]);
+  const runItem = useCallback(item => {
+    switch (item.action.type) {
+      case 'follow-timed':
+        void handleTimed(item.action.seconds, item.action.durationLabel);
+        return;
+      case 'enable-here':
+        void enableHere();
+        return;
+      case 'disable-here':
+        void disableHere();
+        return;
+      case 'unfollow':
+        void unfollow().then(ok => {
+          if (ok) onChange?.(false);
+        });
+    }
+  }, [handleTimed, enableHere, disableHere, unfollow, onChange]);
+  const primary = /*#__PURE__*/_jsx(Button, {
+    variant: isFollowing ? 'secondary' : 'primary',
+    size: size
+    // Unknown is not "not following": the button stays inert until the first
+    // read settles rather than inviting a follow that may already exist.
+    ,
+    disabled: disabled || isUnknown,
+    loading: isPending,
+    onPress: () => void handlePrimary(),
+    accessibilityLabel: label,
+    children: label
+  });
+  if (!showOptions || menuItems.length === 0) {
+    return /*#__PURE__*/_jsx(View, {
+      style: style,
+      children: primary
+    });
+  }
+  return /*#__PURE__*/_jsxs(View, {
+    style: [{
+      flexDirection: 'row',
+      alignItems: 'center',
+      gap: 4
+    }, style],
+    children: [primary, /*#__PURE__*/_jsxs(Menu, {
+      children: [/*#__PURE__*/_jsx(MenuTrigger, {
+        label: `${label} options`,
+        hint: "Opens follow options",
+        children: ({
+          props
+        }) =>
+        /*#__PURE__*/
+        // The trigger's props are mapped rather than spread: `MenuTrigger`
+        // hands back a DOM-ish bag (focus handlers, an accessibility role)
+        // and `Button` accepts a different set, so a spread would pass
+        // props it silently drops.
+        _jsx(Button, {
+          variant: "secondary",
+          size: size === 'large' ? 'large' : 'small',
+          icon: /*#__PURE__*/_jsx(ChevronDown, {
+            width: 16
+          }),
+          disabled: disabled || isUnknown,
+          onPress: props.onPress,
+          accessibilityLabel: props.accessibilityLabel,
+          accessibilityHint: props.accessibilityHint
+        })
+      }), /*#__PURE__*/_jsx(MenuContent, {
+        showCancel: true,
+        children: menuItems.map(item => /*#__PURE__*/_jsx(MenuItem, {
+          label: item.label,
+          onPress: () => runItem(item),
+          children: /*#__PURE__*/_jsx(MenuItemText, {
+            children: item.label
+          })
+        }, item.key))
+      })]
+    })]
+  });
+});
+//# sourceMappingURL=FollowTargetButton.js.map

package/lib/module/ui/components/FollowTargetButton.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["memo","useCallback","useMemo","View","Button","ChevronBottom_Stroke2_Corner0_Rounded","ChevronDown","Menu","MenuContent","MenuItem","MenuItemText","MenuTrigger","toast","useFollowTarget","jsx","_jsx","jsxs","_jsxs","VERB_LABELS","follow","idle","active","pending","disabled","subscribe","join","watch","HOUR","DEFAULT_DURATIONS","label","seconds","resolveFollowPrimaryAction","input","isFollowing","applicationMode","buildFollowMenuItems","items","following","durations","d","push","key","idleVerb","toLowerCase","action","type","durationLabel","hasRelationship","isPending","applicationName","FollowTargetButton","targetId","verb","labels","size","style","showOptions","onChange","status","isUnknown","unfollow","disableHere","enableHere","text","globalState","handlePrimary","handleTimed","expiresIn","success","menuItems","Boolean","relationshipId","runItem","item","then","ok","primary","variant","loading","onPress","accessibilityLabel","children","length","flexDirection","alignItems","gap","hint","props","icon","width","accessibilityHint","showCancel","map"],"sourceRoot":"../../../../src","sources":["ui/components/FollowTargetButton.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/hooks/useFollowTarget.js

@@ -0,0 +1,143 @@
+"use strict";
+
+/**
+ * `useFollowTarget` — the one hook every application uses to follow anything.
+ *
+ * Wraps the `/v2/follows` SDK methods with the store above, an optimistic
+ * update, and a rollback. Nothing in here knows what kind of thing it is
+ * following, which is the property that lets an application the SDK has never
+ * heard of use it without a release of this package.
+ *
+ * ## Optimism, and its one limit
+ *
+ * A follow flips the button immediately and rolls back if the server refuses,
+ * because the round trip is long enough to feel like a bug otherwise. But an
+ * optimistic follow has no relationship id until the server answers, and every
+ * other operation addresses the relationship — so those stay disabled for the
+ * width of one request rather than being sent with a guessed id.
+ */
+
+import { useCallback, useEffect } from 'react';
+import { useOxy } from "../context/OxyContext.js";
+import { isFollowedGlobally, UNKNOWN_FOLLOW_STATUS, useFollowTargetStore, withApplicationMode } from "../stores/followTargetStore.js";
+export function useFollowTarget(targetId, options) {
+  const {
+    oxyServices,
+    canUsePrivateApi
+  } = useOxy();
+  const status = useFollowTargetStore(useCallback(s => targetId ? s.statuses[targetId] : undefined, [targetId]));
+  const isPending = useFollowTargetStore(useCallback(s => targetId ? s.pending[targetId] ?? false : false, [targetId]));
+  const error = useFollowTargetStore(useCallback(s => targetId ? s.errors[targetId] : undefined, [targetId]));
+  const initialStatus = options?.initialStatus;
+
+  // A caller that already knows the status — a follow list, a feed payload —
+  // seeds it rather than making this hook re-ask once per rendered row.
+  useEffect(() => {
+    if (!targetId || !initialStatus) return;
+    const store = useFollowTargetStore.getState();
+    if (!store.statuses[targetId]) store.setStatus(targetId, initialStatus);
+  }, [targetId, initialStatus]);
+  const refresh = useCallback(async () => {
+    // Gated on `canUsePrivateApi`, not on `isAuthenticated`: during the session
+    // cold boot the second is true well before the first, and a read sent in
+    // that window 401s and would leave the button stuck reporting an error the
+    // user cannot act on.
+    if (!targetId || !canUsePrivateApi) return;
+    try {
+      const next = await oxyServices.getFollowTargetStatus(targetId);
+      useFollowTargetStore.getState().setStatus(targetId, next);
+      useFollowTargetStore.getState().setError(targetId, undefined);
+    } catch (e) {
+      useFollowTargetStore.getState().setError(targetId, e instanceof Error ? e.message : 'Could not read follow status');
+    }
+  }, [targetId, canUsePrivateApi, oxyServices]);
+  useEffect(() => {
+    if (!targetId || !canUsePrivateApi) return;
+    if (useFollowTargetStore.getState().statuses[targetId]) return;
+    void refresh();
+  }, [targetId, canUsePrivateApi, refresh]);
+
+  /**
+   * Run a mutation optimistically: show `optimistic` at once, keep the previous
+   * value, and put it back if the server refuses. Every mutation below goes
+   * through this so the rollback cannot be forgotten in one of them.
+   */
+  const mutate = useCallback(async (optimistic, run, failureMessage) => {
+    if (!targetId) return false;
+    const store = useFollowTargetStore.getState();
+    const previous = store.statuses[targetId];
+    store.setStatus(targetId, optimistic);
+    store.setPending(targetId, true);
+    store.setError(targetId, undefined);
+    try {
+      const settled = await run();
+      if (settled) useFollowTargetStore.getState().setStatus(targetId, settled);
+      return true;
+    } catch (e) {
+      const s = useFollowTargetStore.getState();
+      // Back to what was true, not to a guess. Clearing the entry instead
+      // would make the next render ask again and flash the wrong state.
+      if (previous) s.setStatus(targetId, previous);
+      s.setError(targetId, e instanceof Error ? e.message : failureMessage);
+      return false;
+    } finally {
+      useFollowTargetStore.getState().setPending(targetId, false);
+    }
+  }, [targetId]);
+  const current = status ?? UNKNOWN_FOLLOW_STATUS;
+  const follow = useCallback(async opts => {
+    if (!targetId) return false;
+    return mutate({
+      ...withApplicationMode({
+        ...current,
+        globalState: 'active'
+      }, current.applicationMode),
+      ...(opts?.expiresIn ? {
+        expiresAt: new Date(Date.now() + opts.expiresIn * 1000).toISOString()
+      } : {})
+    },
+    // The server returns the whole resulting status, so store it rather
+    // than reconstructing one: `effectiveState`'s derivation lives there,
+    // and a client recomputing it is a second implementation of one rule.
+    async () => (await oxyServices.followTarget(targetId, opts)).status, 'Could not follow');
+  }, [targetId, current, mutate, oxyServices]);
+  const unfollow = useCallback(async () => {
+    const relationshipId = current.relationshipId;
+    if (!targetId || !relationshipId) return false;
+    return mutate({
+      ...UNKNOWN_FOLLOW_STATUS
+    }, async () => {
+      await oxyServices.unfollowTarget(relationshipId);
+      return {
+        ...UNKNOWN_FOLLOW_STATUS
+      };
+    }, 'Could not unfollow');
+  }, [targetId, current.relationshipId, mutate, oxyServices]);
+  const disableHere = useCallback(async () => {
+    const relationshipId = current.relationshipId;
+    if (!targetId || !relationshipId) return false;
+    return mutate(withApplicationMode(current, 'disabled'), async () => {
+      await oxyServices.setFollowApplicationMode(relationshipId, 'disabled');
+    }, 'Could not change this app’s setting for this follow');
+  }, [targetId, current, mutate, oxyServices]);
+  const enableHere = useCallback(async () => {
+    const relationshipId = current.relationshipId;
+    if (!targetId || !relationshipId) return false;
+    return mutate(withApplicationMode(current, 'inherit'), async () => {
+      await oxyServices.restoreFollowInheritance(relationshipId);
+    }, 'Could not change this app’s setting for this follow');
+  }, [targetId, current, mutate, oxyServices]);
+  return {
+    status: current,
+    isFollowing: isFollowedGlobally(current),
+    isUnknown: status === undefined,
+    isPending,
+    error,
+    follow,
+    unfollow,
+    disableHere,
+    enableHere,
+    refresh
+  };
+}
+//# sourceMappingURL=useFollowTarget.js.map

package/lib/module/ui/hooks/useFollowTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useOxy","isFollowedGlobally","UNKNOWN_FOLLOW_STATUS","useFollowTargetStore","withApplicationMode","useFollowTarget","targetId","options","oxyServices","canUsePrivateApi","status","s","statuses","undefined","isPending","pending","error","errors","initialStatus","store","getState","setStatus","refresh","next","getFollowTargetStatus","setError","e","Error","message","mutate","optimistic","run","failureMessage","previous","setPending","settled","current","follow","opts","globalState","applicationMode","expiresIn","expiresAt","Date","now","toISOString","followTarget","unfollow","relationshipId","unfollowTarget","disableHere","setFollowApplicationMode","enableHere","restoreFollowInheritance","isFollowing","isUnknown"],"sourceRoot":"../../../../src","sources":["ui/hooks/useFollowTarget.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/screens/AccountMembersScreen.js

@@ -11,6 +11,7 @@ import { Text } from '@oxyhq/bloom/typography';
 import { Button } from '@oxyhq/bloom/button';
 import { TextField, TextFieldInput } from '@oxyhq/bloom/text-field';
 import { Divider } from '@oxyhq/bloom/divider';
+import { getNormalizedUserHandle } from '@oxyhq/core';
 import { useOxy } from "../context/OxyContext.js";
 import { useI18n } from "../hooks/useI18n.js";
 import { useSurfaceHeader } from "../hooks/useSurfaceHeader.js";
@@ -74,10 +75,36 @@ const AccountMembersScreen = ({
     enabled: canUsePrivateApi && id.length > 0 && canRead
   });
   const members = useMemo(() => membersQuery.data ?? [], [membersQuery.data]);
-  const ownerCount = useMemo(() => members.filter(m => m.role === 'owner').length, [members]);
+  const memberUserIds = useMemo(() => [...new Set(members.map(member => member.memberUserId).filter(id => id.length > 0))], [members]);
+  const memberProfilesQuery = useQuery({
+    queryKey: ['users', 'by-ids', memberUserIds],
+    queryFn: () => oxyServices.getUsersByIds(memberUserIds),
+    enabled: canUsePrivateApi && memberUserIds.length > 0
+  });
+  const memberLabelByUserId = useMemo(() => {
+    const labels = new Map();
+    for (const profile of memberProfilesQuery.data ?? []) {
+      // `getNormalizedUserHandle` answers null for an actor with no resolvable
+      // handle. Leaving that entry out is what lets `memberDisplayLabel`'s own
+      // fallback run, rather than storing a null the map is not typed to hold.
+      const handle = getNormalizedUserHandle(profile);
+      if (handle) labels.set(profile.id, handle);
+    }
+    return labels;
+  }, [memberProfilesQuery.data]);
+  const memberDisplayLabel = useCallback(memberUserId => memberLabelByUserId.get(memberUserId) ?? memberUserId, [memberLabelByUserId]);
+  // DIRECT owners only. The list also carries members whose row lives on an
+  // ancestor, and the last-owner rule this count feeds is about the rows on THIS
+  // account — the server's guard counts those. Including an inherited owner
+  // would make a child that has no owner of its own look like it has exactly
+  // one, and silently disable removing anybody.
+  const ownerCount = useMemo(() => members.filter(m => m.role === 'owner' && (m.source ?? 'direct') === 'direct').length, [members]);
   const invalidateMembers = useCallback(() => {
+    // Inherited rows on descendant rosters derive from ancestor membership
+    // tables — mirror the SDK's per-account prefix sweep so every cached member
+    // list refetches, not only the account that was mutated.
     queryClient.invalidateQueries({
-      queryKey: ['accounts', 'members', id]
+      queryKey: ['accounts', 'members']
     });
     queryClient.invalidateQueries({
       queryKey: ['accounts', 'detail', id]
@@ -282,9 +309,16 @@ const AccountMembersScreen = ({
         children: members.map((member, index) => {
           const isOwner = member.role === 'owner';
           const isLastOwner = isOwner && ownerCount <= 1;
-          const canEditThisRole = canUpdate && !isOwner;
-          const canRemoveThisMember = canRemove && !isLastOwner && (!isOwner || canTransfer);
-          const canTransferToThis = canTransfer && !isOwner && member.status === 'active';
+          // An INHERITED entry's row lives on an ancestor account, and
+          // every member mutation is scoped to rows on the account in
+          // the path — so offering to edit, remove or promote one would
+          // be offering a request the server answers 404. The row is
+          // changed where it lives, on that ancestor's own member
+          // screen.
+          const isEditableHere = (member.source ?? 'direct') === 'direct';
+          const canEditThisRole = canUpdate && isEditableHere && !isOwner;
+          const canRemoveThisMember = canRemove && isEditableHere && !isLastOwner && (!isOwner || canTransfer);
+          const canTransferToThis = canTransfer && isEditableHere && !isOwner && member.status === 'active';
           return /*#__PURE__*/_jsxs(View, {
             children: [index > 0 ? /*#__PURE__*/_jsx(Divider, {
               color: colors.border,
@@ -296,7 +330,7 @@ const AccountMembersScreen = ({
                 children: [/*#__PURE__*/_jsx(Text, {
                   className: "text-body font-bodyBold text-text flex-1",
                   numberOfLines: 1,
-                  children: member.memberUserId
+                  children: memberDisplayLabel(member.memberUserId)
                 }), isOwner ? /*#__PURE__*/_jsx(View, {
                   className: "px-space-8 py-space-4 rounded-radius-full",
                   style: {
@@ -309,6 +343,15 @@ const AccountMembersScreen = ({
                     },
                     children: roleLabel('owner')
                   })
+                }) : null, !isEditableHere ? /*#__PURE__*/_jsx(View, {
+                  className: "px-space-8 py-space-4 rounded-radius-full",
+                  style: {
+                    backgroundColor: colors.card
+                  },
+                  children: /*#__PURE__*/_jsx(Text, {
+                    className: "text-caption font-caption text-text-secondary",
+                    children: t('accounts.members.inherited') || 'Inherited'
+                  })
                 }) : null, member.status !== 'active' ? /*#__PURE__*/_jsx(View, {
                   className: "px-space-8 py-space-4 rounded-radius-full",
                   style: {