@oxyhq/services 30.0.0 → 30.1.0

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

@@ -0,0 +1,324 @@
+"use strict";
+
+import { useCallback, useMemo, useState } from 'react';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { useFollowStore } from "../stores/followStore.js";
+import { useOxy } from "../context/OxyContext.js";
+import { useShallow } from 'zustand/react/shallow';
+import { queryKeys } from "./queries/queryKeys.js";
+import { patchCachedUserRelationship } from "./queries/userCacheRelationship.js";
+
+/**
+ * useFollow — Hook for follow state management.
+ *
+ * Performance fixes:
+ * 1. Uses granular Zustand selectors instead of subscribing to the entire store.
+ *    The old `useFollowStore()` caused every component using this hook to re-render
+ *    on ANY store change (any user's follow status, loading state, error, or count).
+ * 2. Callbacks depend on primitive values (userId, isFollowing) not object references,
+ *    so they remain stable across renders.
+ * 3. Store action methods are accessed via getState() in callbacks to avoid
+ *    subscribing to the action functions themselves (they never change but including
+ *    them in selectors would cause unnecessary selector recalculations).
+ */
+export const useFollow = userId => {
+  const queryClient = useQueryClient();
+  const {
+    oxyServices,
+    canUsePrivateApi
+  } = useOxy();
+  const userIds = useMemo(() => Array.isArray(userId) ? userId : userId ? [userId] : [], [userId]);
+  const isSingleUser = typeof userId === 'string';
+  // Narrowed single-user id for use in closures (callbacks/queryFn) where TS
+  // can't carry the `isSingleUser` boolean back to a `string` narrowing.
+  const singleUserId = typeof userId === 'string' ? userId : undefined;
+
+  // Granular Zustand selectors — only re-render when THIS user's data changes
+  const isFollowing = useFollowStore(useCallback(s => isSingleUser && userId ? s.followingUsers[userId] ?? false : false, [isSingleUser, userId]));
+  const isLoading = useFollowStore(useCallback(s => isSingleUser && userId ? s.loadingUsers[userId] ?? false : false, [isSingleUser, userId]));
+  const error = useFollowStore(useCallback(s => isSingleUser && userId ? s.errors[userId] ?? null : null, [isSingleUser, userId]));
+  const followerCount = useFollowStore(useCallback(s => isSingleUser && userId ? s.followerCounts[userId] ?? null : null, [isSingleUser, userId]));
+  const followingCount = useFollowStore(useCallback(s => isSingleUser && userId ? s.followingCounts[userId] ?? null : null, [isSingleUser, userId]));
+  const isLoadingCounts = useFollowStore(useCallback(s => isSingleUser && userId ? s.loadingCounts[userId] ?? false : false, [isSingleUser, userId]));
+
+  // For multi-user mode, subscribe to a FLAT snapshot of the per-user fields.
+  // `useShallow` only compares one level deep, so the selector must NOT return a
+  // nested object — a freshly allocated `{ isFollowing, isLoading, error }` per
+  // user would never shallow-compare equal, making `useSyncExternalStore`
+  // resubscribe every render and loop until React throws "Maximum update depth
+  // exceeded". Keeping the snapshot flat lets the shallow compare cache it; the
+  // nested `followData` shape is then assembled in a `useMemo` below.
+  const followFlat = useFollowStore(useShallow(s => {
+    if (isSingleUser) return {};
+    const flat = {};
+    for (const uid of userIds) {
+      flat[`${uid}:isFollowing`] = s.followingUsers[uid] ?? false;
+      flat[`${uid}:isLoading`] = s.loadingUsers[uid] ?? false;
+      flat[`${uid}:error`] = s.errors[uid] ?? null;
+    }
+    return flat;
+  }));
+  const followData = useMemo(() => {
+    const data = {};
+    if (isSingleUser) return data;
+    for (const uid of userIds) {
+      data[uid] = {
+        isFollowing: Boolean(followFlat[`${uid}:isFollowing`]),
+        isLoading: Boolean(followFlat[`${uid}:isLoading`]),
+        error: followFlat[`${uid}:error`] ?? null
+      };
+    }
+    return data;
+  }, [isSingleUser, userIds, followFlat]);
+
+  // Multi-user aggregate selectors
+  const multiUserLoadingState = useFollowStore(useShallow(s => {
+    if (isSingleUser) return {
+      isAnyLoading: false,
+      hasAnyError: false,
+      allFollowing: true,
+      allNotFollowing: true
+    };
+    return {
+      isAnyLoading: userIds.some(uid => s.loadingUsers[uid]),
+      hasAnyError: userIds.some(uid => !!s.errors[uid]),
+      allFollowing: userIds.every(uid => s.followingUsers[uid]),
+      allNotFollowing: userIds.every(uid => !s.followingUsers[uid])
+    };
+  }));
+
+  // Stable callbacks that depend on primitives, not object references.
+  // Store actions are accessed via getState() to avoid subscribing to them.
+  const toggleFollow = useCallback(async () => {
+    if (!isSingleUser || !userId) throw new Error('toggleFollow is only available for single user mode');
+    if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+    const currentlyFollowing = useFollowStore.getState().followingUsers[userId] ?? false;
+    const accepted = await useFollowStore.getState().toggleFollowUser(userId, oxyServices, currentlyFollowing);
+    if (accepted) patchCachedUserRelationship(queryClient, userId, !currentlyFollowing);
+  }, [isSingleUser, userId, canUsePrivateApi, oxyServices, queryClient]);
+  const setFollowStatus = useCallback(following => {
+    if (!isSingleUser || !userId) throw new Error('setFollowStatus is only available for single user mode');
+    useFollowStore.getState().setFollowingStatus(userId, following);
+  }, [isSingleUser, userId]);
+  const fetchStatus = useCallback(async () => {
+    if (!isSingleUser || !userId) throw new Error('fetchStatus is only available for single user mode');
+    if (!canUsePrivateApi) return;
+    useFollowStore.getState().resolveFollowStatuses([userId], oxyServices);
+  }, [isSingleUser, userId, canUsePrivateApi, oxyServices]);
+  const clearError = useCallback(() => {
+    if (!isSingleUser || !userId) throw new Error('clearError is only available for single user mode');
+    useFollowStore.getState().clearFollowError(userId);
+  }, [isSingleUser, userId]);
+  const fetchUserCounts = useCallback(async () => {
+    if (!isSingleUser || !userId) throw new Error('fetchUserCounts is only available for single user mode');
+    await useFollowStore.getState().fetchUserCounts(userId, oxyServices);
+  }, [isSingleUser, userId, oxyServices]);
+  const setFollowerCount = useCallback(count => {
+    if (!isSingleUser || !userId) throw new Error('setFollowerCount is only available for single user mode');
+    useFollowStore.getState().setFollowerCount(userId, count);
+  }, [isSingleUser, userId]);
+  const setFollowingCount = useCallback(count => {
+    if (!isSingleUser || !userId) throw new Error('setFollowingCount is only available for single user mode');
+    useFollowStore.getState().setFollowingCount(userId, count);
+  }, [isSingleUser, userId]);
+
+  // Auto-fetch counts for single-user mode via React Query instead of a manual
+  // useEffect. The Zustand store remains the canonical home for count values
+  // (it is also written by toggleFollowUser / updateCountsFromFollowAction), so
+  // components keep reading `followerCount` / `followingCount` through the
+  // granular selectors above — this query only owns the FETCH lifecycle
+  // (dedup, caching, retry/backoff). It stays disabled until the counts are
+  // actually missing, reproducing the old effect's `(followerCount === null ||
+  // followingCount === null)` gate without a render-phase side effect. The
+  // store action does the network call and writes the counts; the query simply
+  // surfaces the resolved pair as its cached data.
+  useQuery({
+    queryKey: singleUserId ? queryKeys.follow.counts(singleUserId) : queryKeys.follow.all,
+    queryFn: async () => {
+      if (!singleUserId) return null;
+      await useFollowStore.getState().fetchUserCounts(singleUserId, oxyServices);
+      const state = useFollowStore.getState();
+      return {
+        followers: state.followerCounts[singleUserId] ?? null,
+        following: state.followingCounts[singleUserId] ?? null
+      };
+    },
+    enabled: !!singleUserId && (followerCount === null || followingCount === null)
+  });
+
+  // Multi-user callbacks
+  const toggleFollowForUser = useCallback(async targetUserId => {
+    if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+    const currentState = useFollowStore.getState().followingUsers[targetUserId] ?? false;
+    const accepted = await useFollowStore.getState().toggleFollowUser(targetUserId, oxyServices, currentState);
+    if (accepted) patchCachedUserRelationship(queryClient, targetUserId, !currentState);
+  }, [canUsePrivateApi, oxyServices, queryClient]);
+  const setFollowStatusForUser = useCallback((targetUserId, following) => {
+    useFollowStore.getState().setFollowingStatus(targetUserId, following);
+  }, []);
+  const fetchStatusForUser = useCallback(async targetUserId => {
+    if (!canUsePrivateApi) return;
+    useFollowStore.getState().resolveFollowStatuses([targetUserId], oxyServices);
+  }, [canUsePrivateApi, oxyServices]);
+
+  // Resolve EVERY member's status in ONE micro-batched bulk call (never N
+  // single requests). Ids already known/seeded are skipped by the resolver.
+  const fetchAllStatuses = useCallback(async () => {
+    if (!canUsePrivateApi) return;
+    useFollowStore.getState().resolveFollowStatuses(userIds, oxyServices);
+  }, [canUsePrivateApi, userIds, oxyServices]);
+
+  // Bulk follow — follows ALL users in ONE network call (never unfollows).
+  const followAllUsers = useCallback(async () => {
+    if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+    return useFollowStore.getState().followManyUsers(userIds, oxyServices);
+  }, [canUsePrivateApi, userIds, oxyServices]);
+
+  // Bulk unfollow — unfollows ALL users in ONE network call (idempotent; never follows).
+  const unfollowAllUsers = useCallback(async () => {
+    if (!canUsePrivateApi) throw new Error('Authentication is required to unfollow users');
+    return useFollowStore.getState().unfollowManyUsers(userIds, oxyServices);
+  }, [canUsePrivateApi, userIds, oxyServices]);
+  const clearErrorForUser = useCallback(targetUserId => {
+    useFollowStore.getState().clearFollowError(targetUserId);
+  }, []);
+  const updateCountsFromFollowAction = useCallback((targetUserId, action, counts) => {
+    const currentUserId = oxyServices.getCurrentUserId() || undefined;
+    useFollowStore.getState().updateCountsFromFollowAction(targetUserId, action, counts, currentUserId);
+  }, [oxyServices]);
+  if (isSingleUser && userId) {
+    return {
+      isFollowing,
+      isLoading,
+      error,
+      toggleFollow,
+      setFollowStatus,
+      fetchStatus,
+      clearError,
+      followerCount,
+      followingCount,
+      isLoadingCounts,
+      fetchUserCounts,
+      setFollowerCount,
+      setFollowingCount
+    };
+  }
+  return {
+    followData,
+    toggleFollowForUser,
+    setFollowStatusForUser,
+    fetchStatusForUser,
+    fetchAllStatuses,
+    followAllUsers,
+    unfollowAllUsers,
+    clearErrorForUser,
+    isAnyLoading: multiUserLoadingState.isAnyLoading,
+    hasAnyError: multiUserLoadingState.hasAnyError,
+    allFollowing: multiUserLoadingState.allFollowing,
+    allNotFollowing: multiUserLoadingState.allNotFollowing
+  };
+};
+
+/**
+ * useFollowForButton — Lightweight follow hook for FollowButton in list contexts.
+ *
+ * Unlike useFollow, this hook:
+ * - Accepts oxyServices directly (no useOxy() context subscription)
+ * - Only subscribes to the specific user's follow and loading state
+ * - Returns only what FollowButton needs (no counts, no multi-user)
+ */
+export const useFollowForButton = (userId, oxyServices, initiallyFollowing) => {
+  // Seed the store synchronously on the FIRST render (before paint) when the
+  // caller provided a definite `initiallyFollowing` and the store has no entry
+  // yet. This makes the first paint show the correct label (no post-mount
+  // "Follow → Following" correction) and marks the id KNOWN so the batched
+  // resolver skips it. An OMITTED `initiallyFollowing` leaves the id UNKNOWN,
+  // so the batched resolver fetches its real status. The useState lazy
+  // initializer runs exactly once per mount; `setFollowStatuses` is
+  // seed-only-if-absent, so it never clobbers a live value.
+  useState(() => {
+    if (initiallyFollowing === undefined) return null;
+    const store = useFollowStore.getState();
+    if (!Object.prototype.hasOwnProperty.call(store.followingUsers, userId)) {
+      store.setFollowStatuses({
+        [userId]: initiallyFollowing
+      });
+    }
+    return null;
+  });
+  const isFollowing = useFollowStore(useCallback(s => s.followingUsers[userId] ?? false, [userId]));
+  // Tri-state: a present key (seeded or fetched) is a DEFINITE status; a missing
+  // key is UNKNOWN. The button renders a neutral/disabled state while unknown.
+  const isKnown = useFollowStore(useCallback(s => Object.prototype.hasOwnProperty.call(s.followingUsers, userId), [userId]));
+  const isLoading = useFollowStore(useCallback(s => s.loadingUsers[userId] ?? false, [userId]));
+  const error = useFollowStore(useCallback(s => s.errors[userId] ?? null, [userId]));
+  const toggleFollow = useCallback(async () => {
+    const currentlyFollowing = useFollowStore.getState().followingUsers[userId] ?? false;
+    return useFollowStore.getState().toggleFollowUser(userId, oxyServices, currentlyFollowing);
+  }, [userId, oxyServices]);
+
+  // Enqueue this id into the micro-batched resolver — every button that enqueues
+  // in the same tick coalesces into ONE bulk `getFollowStatuses` call. Known /
+  // seeded / in-flight ids are skipped by the resolver, so this is a no-op for
+  // them.
+  const resolveStatus = useCallback(() => {
+    useFollowStore.getState().resolveFollowStatuses([userId], oxyServices);
+  }, [userId, oxyServices]);
+  const setFollowStatus = useCallback(following => {
+    useFollowStore.getState().setFollowingStatus(userId, following);
+  }, [userId]);
+  const clearError = useCallback(() => {
+    useFollowStore.getState().clearFollowError(userId);
+  }, [userId]);
+  return {
+    isFollowing,
+    isKnown,
+    isLoading,
+    error,
+    toggleFollow,
+    resolveStatus,
+    setFollowStatus,
+    clearError
+  };
+};
+
+/**
+ * useSeedFollowStatuses — returns a stable callback that bulk-seeds follow
+ * statuses into the store (seed-only-if-absent; never clobbers a live value).
+ *
+ * Wire this at the app root to seed from `oxyServices.getViewerGraph()
+ * .followingIds` (map each followed id → `true`) so a page of `FollowButton`s
+ * paints the correct label on first render with ZERO follow-status network
+ * calls — the batched resolver then skips every seeded id.
+ */
+export const useSeedFollowStatuses = () => useCallback(statuses => {
+  useFollowStore.getState().setFollowStatuses(statuses);
+}, []);
+
+// Convenience hook for just follower counts
+export const useFollowerCounts = userId => {
+  const {
+    oxyServices
+  } = useOxy();
+  const followerCount = useFollowStore(useCallback(s => s.followerCounts[userId] ?? null, [userId]));
+  const followingCount = useFollowStore(useCallback(s => s.followingCounts[userId] ?? null, [userId]));
+  const isLoadingCounts = useFollowStore(useCallback(s => s.loadingCounts[userId] ?? false, [userId]));
+  const fetchUserCounts = useCallback(async () => {
+    await useFollowStore.getState().fetchUserCounts(userId, oxyServices);
+  }, [userId, oxyServices]);
+  const setFollowerCount = useCallback(count => {
+    useFollowStore.getState().setFollowerCount(userId, count);
+  }, [userId]);
+  const setFollowingCount = useCallback(count => {
+    useFollowStore.getState().setFollowingCount(userId, count);
+  }, [userId]);
+  return {
+    followerCount,
+    followingCount,
+    isLoadingCounts,
+    fetchUserCounts,
+    setFollowerCount,
+    setFollowingCount
+  };
+};
+//# sourceMappingURL=useFollow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useState","useQuery","useQueryClient","useFollowStore","useOxy","useShallow","queryKeys","patchCachedUserRelationship","useFollow","userId","queryClient","oxyServices","canUsePrivateApi","userIds","Array","isArray","isSingleUser","singleUserId","undefined","isFollowing","s","followingUsers","isLoading","loadingUsers","error","errors","followerCount","followerCounts","followingCount","followingCounts","isLoadingCounts","loadingCounts","followFlat","flat","uid","followData","data","Boolean","multiUserLoadingState","isAnyLoading","hasAnyError","allFollowing","allNotFollowing","some","every","toggleFollow","Error","currentlyFollowing","getState","accepted","toggleFollowUser","setFollowStatus","following","setFollowingStatus","fetchStatus","resolveFollowStatuses","clearError","clearFollowError","fetchUserCounts","setFollowerCount","count","setFollowingCount","queryKey","follow","counts","all","queryFn","state","followers","enabled","toggleFollowForUser","targetUserId","currentState","setFollowStatusForUser","fetchStatusForUser","fetchAllStatuses","followAllUsers","followManyUsers","unfollowAllUsers","unfollowManyUsers","clearErrorForUser","updateCountsFromFollowAction","action","currentUserId","getCurrentUserId","useFollowForButton","initiallyFollowing","store","Object","prototype","hasOwnProperty","call","setFollowStatuses","isKnown","resolveStatus","useSeedFollowStatuses","statuses","useFollowerCounts"],"sourceRoot":"../../../../src","sources":["ui/hooks/useFollow.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/hooks/useFollow.types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=useFollow.types.js.map

package/lib/module/ui/hooks/useFollow.types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["ui/hooks/useFollow.types.ts"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,156 @@
+"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 { isCompleteFollowStatus, 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) {
+      const store = useFollowTargetStore.getState();
+      const message = e instanceof Error ? e.message : 'Could not read follow status';
+      // Leave `isUnknown` false so the button stays interactive and can retry.
+      // A failed read is not the same as "never asked" — disabling forever would
+      // strand the user with no affordance when the network blips.
+      if (!store.statuses[targetId]) {
+        store.setStatus(targetId, UNKNOWN_FOLLOW_STATUS);
+      }
+      store.setError(targetId, message);
+    }
+  }, [targetId, canUsePrivateApi, oxyServices]);
+  useEffect(() => {
+    if (!targetId || !canUsePrivateApi) return;
+    const existing = useFollowTargetStore.getState().statuses[targetId];
+    if (existing && isCompleteFollowStatus(existing)) 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;
+    const optimistic = withApplicationMode(current, 'disabled');
+    return mutate(optimistic, async () => {
+      await oxyServices.setFollowApplicationMode(relationshipId, 'disabled');
+      return optimistic;
+    }, '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;
+    const optimistic = withApplicationMode(current, 'inherit');
+    return mutate(optimistic, async () => {
+      await oxyServices.restoreFollowInheritance(relationshipId);
+      return optimistic;
+    }, '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","isCompleteFollowStatus","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","message","Error","existing","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/hooks/useI18n.js

@@ -0,0 +1,38 @@
+"use strict";
+
+import { useMemo } from 'react';
+import { useOptionalOxy } from "../context/OxyContext.js";
+import { translate } from '@oxyhq/core';
+
+/**
+ * The locale `@oxyhq/core`'s translator falls back to. Mirrors its own
+ * `FALLBACK`, so a surface rendered without a provider reads the same strings
+ * an unrecognised locale would.
+ */
+const FALLBACK_LOCALE = 'en-US';
+
+/**
+ * Display copy for SDK surfaces.
+ *
+ * This is the ONE hook that reads the runtime optionally. The locale is display
+ * metadata, not session state — ADR 0004 lists it among the things that come off
+ * the central value entirely — and purely presentational surfaces
+ * (`OxyConsentScreen`, `OxySignInRequestSurface`) are rendered outside a
+ * provider on purpose: `packages/auth`'s production-bundle probe builds the real
+ * Vite bundle and renders the surface standalone to prove every element beneath
+ * it links. Throwing there would report a linkage failure that is not one.
+ *
+ * Anything that reads or mutates session state uses `useOxy()`, which throws.
+ */
+export function useI18n() {
+  const oxy = useOptionalOxy();
+  const currentLanguage = oxy?.currentLanguage ?? FALLBACK_LOCALE;
+  const t = useMemo(() => {
+    return (key, vars) => translate(currentLanguage, key, vars);
+  }, [currentLanguage]);
+  return {
+    t,
+    locale: currentLanguage
+  };
+}
+//# sourceMappingURL=useI18n.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useOptionalOxy","translate","FALLBACK_LOCALE","useI18n","oxy","currentLanguage","t","key","vars","locale"],"sourceRoot":"../../../../src","sources":["ui/hooks/useI18n.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,cAAc,QAAQ,0BAAuB;AACtD,SAASC,SAAS,QAAQ,aAAa;;AAEvC;AACA;AACA;AACA;AACA;AACA,MAAMC,eAAe,GAAG,OAAO;;AAE/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CAAA,EAAG;EACxB,MAAMC,GAAG,GAAGJ,cAAc,CAAC,CAAC;EAC5B,MAAMK,eAAe,GAAGD,GAAG,EAAEC,eAAe,IAAIH,eAAe;EAC/D,MAAMI,CAAC,GAAGP,OAAO,CAAC,MAAM;IACtB,OAAO,CAACQ,GAAW,EAAEC,IAAsC,KAAKP,SAAS,CAACI,eAAe,EAAEE,GAAG,EAAEC,IAAI,CAAC;EACvG,CAAC,EAAE,CAACH,eAAe,CAAC,CAAC;EACrB,OAAO;IAAEC,CAAC;IAAEG,MAAM,EAAEJ;EAAgB,CAAC;AACvC","ignoreList":[]}