@oxy.so/services 12.7.0 → 12.9.0

package/lib/typescript/module/ui/hooks/useAccountColor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAccountColor.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useAccountColor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAS1F,2EAA2E;AAC3E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/D,YAAY,GAAG,IAAI,CAGrB;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,GAAE;IACD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;CACrC,GAAG,IAAI,CAUZ"}
+{"version":3,"file":"useAccountColor.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useAccountColor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAW1F,2EAA2E;AAC3E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/D,YAAY,GAAG,IAAI,CAGrB;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,GAAE;IACD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;CACrC,GAAG,IAAI,CAUZ;AAED,KAAK,kBAAkB,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAExF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,GAAG,GAAE,MAAmB,GACvB,SAAS,YAAY,EAAE,CAYzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,EAAE,OAAO,CAAC;CACjB,CA4BA"}

package/lib/typescript/module/ui/hooks/useFollow.d.ts

@@ -1,4 +1,5 @@
-import type { OxyServices, BulkFollowResult, BulkUnfollowResult } from '@oxy.so/core';
+import { type OxyServices, type BulkFollowResult, type BulkUnfollowResult } from '@oxy.so/core';
+import type { FollowErrorCode } from '../utils/followErrors.js';
 /**
  * useFollow — Hook for follow state management.
  *
@@ -15,7 +16,7 @@ import type { OxyServices, BulkFollowResult, BulkUnfollowResult } from '@oxy.so/
 export declare const useFollow: (userId?: string | string[]) => {
     isFollowing: boolean;
     isLoading: boolean;
-    error: string | null;
+    error: FollowErrorCode | null;
     toggleFollow: () => Promise<void>;
     setFollowStatus: (following: boolean) => void;
     fetchStatus: () => Promise<void>;
@@ -42,7 +43,7 @@ export declare const useFollow: (userId?: string | string[]) => {
     followData: Record<string, {
         isFollowing: boolean;
         isLoading: boolean;
-        error: string | null;
+        error: FollowErrorCode | null;
     }>;
     toggleFollowForUser: (targetUserId: string) => Promise<void>;
     setFollowStatusForUser: (targetUserId: string, following: boolean) => void;
@@ -81,7 +82,7 @@ export declare const useFollowForButton: (userId: string, oxyServices: OxyServic
     isFollowing: boolean;
     isKnown: boolean;
     isLoading: boolean;
-    error: string | null;
+    error: FollowErrorCode | null;
     toggleFollow: () => Promise<boolean>;
     resolveStatus: () => void;
     setFollowStatus: (following: boolean) => void;

package/lib/typescript/module/ui/hooks/useFollow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFollow.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFollow.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAKtF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,GAAG,MAAM,EAAE;;;;;iCAqHpC,OAAO;;;;;;;8BA4BX,MAAM;+BASN,MAAM;;;;;;;;;;;;;;;qBAnF4B,OAAO;mBAAa,OAAO;eAAS,MAAM,GAAG,IAAI;;wCAqHtE,MAAM;2CAW6B,MAAM,aAAa,OAAO;uCAK7D,MAAM;;0BAegB,OAAO,CAAC,gBAAgB,CAAC;4BAMvB,OAAO,CAAC,kBAAkB,CAAC;sCAKrB,MAAM;;;;;;;;;;;;;;;;;;CAkD5D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,EACd,aAAa,WAAW,EACxB,qBAAqB,OAAO;;;;;wBA8Be,OAAO,CAAC,OAAO,CAAC;;iCAc7C,OAAO;;CAoBtB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,mBACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAExC,CAAC;AAGT,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM;;;;;8BAkBpC,MAAM;+BAON,MAAM;CAcjB,CAAC"}
+{"version":3,"file":"useFollow.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFollow.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAAuB,CAAC;AAK7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,GAAG,MAAM,EAAE;;;;;iCAwHpC,OAAO;;;;;;;8BA4BX,MAAM;+BASN,MAAM;;;;;;;;;;;;;;;qBApFG,OAAO;mBAAa,OAAO;eAAS,eAAe,GAAG,IAAI;;wCAsHtD,MAAM;2CAY6B,MAAM,aAAa,OAAO;uCAK7D,MAAM;;0BAegB,OAAO,CAAC,gBAAgB,CAAC;4BAOvB,OAAO,CAAC,kBAAkB,CAAC;sCAMrB,MAAM;;;;;;;;;;;;;;;;;;CAkD5D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,EACd,aAAa,WAAW,EACxB,qBAAqB,OAAO;;;;;wBA8Be,OAAO,CAAC,OAAO,CAAC;;iCAc7C,OAAO;;CAoBtB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,mBACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAExC,CAAC;AAGT,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM;;;;;8BAkBpC,MAAM;+BAON,MAAM;CAcjB,CAAC"}

package/lib/typescript/module/ui/hooks/useFollow.types.d.ts

@@ -1,8 +1,9 @@
 import type { BulkFollowResult } from '@oxy.so/core';
+import type { FollowErrorCode } from '../utils/followErrors.js';
 export type SingleFollowResult = {
     isFollowing: boolean;
     isLoading: boolean;
-    error: string | null;
+    error: FollowErrorCode | null;
     toggleFollow: () => Promise<void>;
     setFollowStatus: (following: boolean) => void;
     fetchStatus: () => Promise<void>;
@@ -18,7 +19,7 @@ export type MultiFollowResult = {
     followData: Record<string, {
         isFollowing: boolean;
         isLoading: boolean;
-        error: string | null;
+        error: FollowErrorCode | null;
     }>;
     toggleFollowForUser: (userId: string) => Promise<void>;
     setFollowStatusForUser: (userId: string, following: boolean) => void;

package/lib/typescript/module/ui/hooks/useFollow.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFollow.types.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFollow.types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,eAAe,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC/F,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IACrE,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,cAAc,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,kBAAkB,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"useFollow.types.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFollow.types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAAuB,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,eAAe,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE,CAC5E,CAAC;IACF,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IACrE,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,cAAc,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,kBAAkB,GAAG,iBAAiB,CAAC"}

package/lib/typescript/module/ui/hooks/useFollowTarget.d.ts

@@ -15,6 +15,7 @@
  * width of one request rather than being sent with a guessed id.
  */
 import type { FollowStatus } from '@oxy.so/contracts';
+import { type FollowErrorCode } from '../utils/followErrors.js';
 export interface UseFollowTargetResult {
     status: FollowStatus;
     /**
@@ -25,11 +26,12 @@ export interface UseFollowTargetResult {
     /** True until the first read settles. Distinct from "not following". */
     isUnknown: boolean;
     isPending: boolean;
-    error: string | undefined;
+    /** Why the last read or write failed — a code; `useFollowErrorMessage()` words it. */
+    error: FollowErrorCode | undefined;
     /**
      * Every mutation resolves to whether the server ACCEPTED it.
      *
-     * They never reject — a refusal becomes `error` in the store, so the button
+     * They never reject — a refusal becomes an `error` code in the store, so the button
      * can render it — which means a caller that only awaits them cannot tell a
      * write that happened from one that did not. Returning the outcome is what
      * lets a caller mirror the change somewhere else without mirroring failures

package/lib/typescript/module/ui/hooks/useFollowTarget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFollowTarget.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFollowTarget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAUtD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,wEAAwE;IACxE,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,YAAY,CAAA;CAAE,GACzC,qBAAqB,CAmKvB"}
+{"version":3,"file":"useFollowTarget.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFollowTarget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAStD,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,0BAAuB,CAAC;AAE/B,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,sFAAsF;IACtF,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,wEAAwE;IACxE,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,YAAY,CAAA;CAAE,GACzC,qBAAqB,CAkKvB"}

package/lib/typescript/module/ui/stores/followStore.d.ts

@@ -1,9 +1,11 @@
 import type { OxyServices, BulkFollowResult, BulkUnfollowResult } from '@oxy.so/core';
+import { type FollowErrorCode } from '../utils/followErrors.js';
 interface FollowState {
     followingUsers: Record<string, boolean>;
     loadingUsers: Record<string, boolean>;
     fetchingUsers: Record<string, boolean>;
-    errors: Record<string, string | null>;
+    /** Why the last read or write of a user failed, as a code — never text. */
+    errors: Record<string, FollowErrorCode | null>;
     followerCounts: Record<string, number>;
     followingCounts: Record<string, number>;
     loadingCounts: Record<string, boolean>;

package/lib/typescript/module/ui/stores/followStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"followStore.d.ts","sourceRoot":"","sources":["../../../../../src/ui/stores/followStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAEnB,MAAM,cAAc,CAAC;AAEtB,UAAU,WAAW;IAKnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAEtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;IAKnE,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC1D,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAI7B,qBAAqB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7E,gBAAgB,EAAE,CAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,oBAAoB,EAAE,OAAO,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5F,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEhG,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,4BAA4B,EAAE,CAC5B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,EAC7B,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAChD,aAAa,CAAC,EAAE,MAAM,KACnB,IAAI,CAAC;IACV,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AA8BD,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,QAAO,IAMxC,CAAC;AAEF,eAAO,MAAM,cAAc,0EA0YxB,CAAC"}
+{"version":3,"file":"followStore.d.ts","sourceRoot":"","sources":["../../../../../src/ui/stores/followStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAEnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,0BAAuB,CAAC;AAEhF,UAAU,WAAW;IAKnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC;IAE/C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;IAKnE,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC1D,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAI7B,qBAAqB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7E,gBAAgB,EAAE,CAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,oBAAoB,EAAE,OAAO,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5F,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEhG,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,4BAA4B,EAAE,CAC5B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,EAC7B,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAChD,aAAa,CAAC,EAAE,MAAM,KACnB,IAAI,CAAC;IACV,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AA8BD,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,QAAO,IAMxC,CAAC;AAEF,eAAO,MAAM,cAAc,0EAsYxB,CAAC"}

package/lib/typescript/module/ui/stores/followTargetStore.d.ts

@@ -22,13 +22,15 @@
  * why a follow the user can see in their list does nothing in this app.
  */
 import type { FollowApplicationMode, FollowRecord, FollowStatus } from '@oxy.so/contracts';
+import type { FollowErrorCode } from '../utils/followErrors.js';
 /** The status of one target, or `undefined` when it has never been read. */
 type StatusMap = Record<string, FollowStatus | undefined>;
 interface FollowTargetState {
     statuses: StatusMap;
     /** In-flight writes, per target. Reads do not set this — only mutations do. */
     pending: Record<string, boolean>;
-    errors: Record<string, string | undefined>;
+    /** Why the last read or write of a target failed, as a code — never text. */
+    errors: Record<string, FollowErrorCode | undefined>;
     setStatus: (targetId: string, status: FollowStatus) => void;
     /**
      * Seed many statuses at once — from a follow list, a feed payload, anything
@@ -37,7 +39,7 @@ interface FollowTargetState {
      */
     seed: (entries: Record<string, FollowStatus>) => void;
     setPending: (targetId: string, pending: boolean) => void;
-    setError: (targetId: string, error: string | undefined) => void;
+    setError: (targetId: string, error: FollowErrorCode | undefined) => void;
     /** Drop everything. Called on identity change — see the note below. */
     reset: () => void;
 }

package/lib/typescript/module/ui/stores/followTargetStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"followTargetStore.d.ts","sourceRoot":"","sources":["../../../../../src/ui/stores/followTargetStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE3F,4EAA4E;AAC5E,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC,CAAC;AAE1D,UAAU,iBAAiB;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAE3C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5D;;;;OAIG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI,CAAC;IACtD,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAChE,uEAAuE;IACvE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF,eAAO,MAAM,oBAAoB,gFAoB9B,CAAC;AAEJ;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAGpE;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAQvE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAM9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,qBAAqB,GAC1B,YAAY,CAad"}
+{"version":3,"file":"followTargetStore.d.ts","sourceRoot":"","sources":["../../../../../src/ui/stores/followTargetStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAAuB,CAAC;AAE7D,4EAA4E;AAC5E,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC,CAAC;AAE1D,UAAU,iBAAiB;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;IAEpD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5D;;;;OAIG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI,CAAC;IACtD,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,SAAS,KAAK,IAAI,CAAC;IACzE,uEAAuE;IACvE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF,eAAO,MAAM,oBAAoB,gFAoB9B,CAAC;AAEJ;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAGpE;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAQvE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAM9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,qBAAqB,GAC1B,YAAY,CAad"}

package/lib/typescript/module/ui/utils/followErrors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * What a failed follow read or write leaves behind: a stable CODE, never text.
+ *
+ * The follow stores and hooks have no translator and must not pretend to — an
+ * English sentence written into a store reaches every locale's toast verbatim,
+ * and so does a server's `message`. They keep one of these codes instead, and
+ * the UI turns it into words in the user's language (`describeFollowError` in
+ * `components/followLabels.ts`).
+ *
+ * A code says either what the caller was doing (`read_failed`, `update_failed`,
+ * `mode_failed`) or — when the failure says more than that — why it failed,
+ * taken from the API's machine code and HTTP status rather than its message.
+ */
+export type FollowErrorCode = 
+/** The status could not be read. */
+'read_failed'
+/** A follow or unfollow was refused. */
+ | 'update_failed'
+/** Switching a follow off or back on in this application was refused. */
+ | 'mode_failed'
+/** No response arrived: the device is offline, or the request timed out. */
+ | 'offline'
+/** The session is gone; signing in again is the only fix. */
+ | 'signed_out'
+/** This application lacks the permission the write needs. */
+ | 'forbidden'
+/** The target or the relationship no longer exists. */
+ | 'not_found'
+/** Too many writes in a short window. */
+ | 'rate_limited';
+/** The codes that name the caller's action rather than a cause. */
+export type FollowActionErrorCode = 'read_failed' | 'update_failed' | 'mode_failed';
+/**
+ * The code for whatever a follow request rejected with.
+ *
+ * Read structurally — every `OxyServices` call rejects with an `OxyApiError`
+ * (or an `OxyAuthenticationError`), and both carry `status` and `code` — so a
+ * second copy of `@oxy.so/core` in an app cannot defeat an `instanceof`.
+ * Anything the cause does not explain falls back to the caller's `action`.
+ */
+export declare function toFollowErrorCode(error: unknown, action: FollowActionErrorCode): FollowErrorCode;
+//# sourceMappingURL=followErrors.d.ts.map

package/lib/typescript/module/ui/utils/followErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followErrors.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/followErrors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe;AACzB,oCAAoC;AAClC,aAAa;AACf,wCAAwC;GACtC,eAAe;AACjB,yEAAyE;GACvE,aAAa;AACf,4EAA4E;GAC1E,SAAS;AACX,6DAA6D;GAC3D,YAAY;AACd,6DAA6D;GAC3D,WAAW;AACb,uDAAuD;GACrD,WAAW;AACb,yCAAyC;GACvC,cAAc,CAAC;AAEnB,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,eAAe,GAAG,aAAa,CAAC;AAIpF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAWhG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/services",
-  "version": "12.7.0",
+  "version": "12.9.0",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -151,7 +151,7 @@
     "prepublishOnly": "node ../../scripts/assert-bun-publish.mjs && bun run typescript && bun run test && bun run build"
   },
   "dependencies": {
-    "@oxy.so/contracts": "^5.4.0",
+    "@oxy.so/contracts": "^5.6.0",
     "color": "^5.0.3",
     "@peable.to/sdk": "0.4.1"
   },
@@ -160,7 +160,7 @@
     "@commitlint/config-conventional": "^21.2.0",
     "@expo/app-integrity": "~58.0.2",
     "@expo/vector-icons": "^15.0.3",
-    "@oxy.so/core": "6.9.3",
+    "@oxy.so/core": "6.11.1",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^12.0.1",
     "@react-native/babel-preset": "^0.88.0",
@@ -210,12 +210,12 @@
     "expo-video": "~58.0.11"
   },
   "//@oxy.so/bloom": "Bloom 11.1.0 adds the shared grouped sections, usage card, subscription plans, frame appearance and overlay navigation APIs used by this SDK. First-party Bloom peers remain open above this tested minimum.",
-  "//@oxy.so/core": "Core 6.4.0 supplies the `follow.*` strings the follow buttons read for every verb and language; 6.1.0 the `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove` the sign-in & security panels call. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
+  "//@oxy.so/core": "Core 6.11.0 supplies the `follow.errors.*` strings the follow error codes are worded with; 6.4.0 the `follow.*` strings the follow buttons read for every verb and language; 6.1.0 the `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove` the sign-in & security panels call. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
   "peerDependencies": {
     "@expo/app-integrity": ">=56.0.0 <59.0.0",
     "@expo/vector-icons": "^15.0.3",
     "@oxy.so/bloom": ">=11.1.0",
-    "@oxy.so/core": "^6.4.0",
+    "@oxy.so/core": "^6.11.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": ">=11.4.1 <13.0.0",
     "@tanstack/query-async-storage-persister": "^5.101",

package/src/index.ts

@@ -346,6 +346,8 @@ export {
 export type { FollowDuration, FollowMenuItem } from './ui/components/followRules';
 export type { FollowTargetButtonProps } from './ui/components/FollowTargetButton';
 export type { FollowVerb, FollowLabels } from './ui/components/followLabels';
+export { useFollowErrorMessage } from './ui/components/followLabels';
+export type { FollowErrorCode } from './ui/utils/followErrors';
 export { useFollowTarget } from './ui/hooks/useFollowTarget';
 export type { UseFollowTargetResult } from './ui/hooks/useFollowTarget';
 export {

package/src/ui/client.ts

@@ -31,6 +31,8 @@ export type {
 export { FollowTargetButton } from './components/FollowTargetButton';
 export type { FollowTargetButtonProps } from './components/FollowTargetButton';
 export type { FollowVerb, FollowLabels } from './components/followLabels';
+export { useFollowErrorMessage } from './components/followLabels';
+export type { FollowErrorCode } from './utils/followErrors';
 export { default as ProfileButton } from './components/ProfileButton';
 export type { ProfileButtonProps } from './components/ProfileButton';
 export { default as PeableButton } from './components/PeableButton';
@@ -45,7 +47,12 @@ export { useOxy, useOptionalOxy, OxyProviderMissingError } from './context/OxyCo
 
 // Hooks
 export { useAuth } from './hooks/useAuth';
-export { useAccountColor, resolveAccountColor } from './hooks/useAccountColor';
+export {
+  useAccountColor,
+  useAccountColorSave,
+  resolveAccountColor,
+  entitledAccountColors,
+} from './hooks/useAccountColor';
 // This app's Oxy-signed assertion of which app it is (ADR 0045), for an SDK
 // that attaches it to its own requests without pulling in the account screens.
 export {

package/src/ui/components/FollowButton.tsx

@@ -9,8 +9,14 @@ import { useFollowStore } from '../stores/followStore';
 import type { OxyServices, BulkFollowResult, BulkUnfollowResult } from '@oxy.so/core';
 import { useShallow } from 'zustand/react/shallow';
 import { useI18n } from '../hooks/useI18n';
+import { toFollowErrorCode } from '../utils/followErrors';
 import { describeFollowAllButton, describeFollowButton } from './followButtonAccessibility';
-import { type FollowLabels, type FollowVerb, useFollowLabels } from './followLabels';
+import {
+  describeFollowError,
+  type FollowLabels,
+  type FollowVerb,
+  useFollowLabels,
+} from './followLabels';
 
 /** Props shared by both single- and multi-user follow modes. */
 interface FollowButtonBaseProps {
@@ -101,13 +107,10 @@ const FollowButtonInner = memo(function FollowButtonInner({
       // Ignore presses while a mutation is in flight or the status is still unknown.
       if (disabled || isLoading || !isKnown) return;
 
-      try {
-        const accepted = await toggleFollow();
-        if (accepted) onFollowChange?.(!isFollowing);
-      } catch (err: unknown) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        toast.error(error.message || t('follow.errors.update'));
-      }
+      // `toggleFollow` never rejects: a refusal is rolled back and its code
+      // recorded in the store, which is what the toast words.
+      if (await toggleFollow()) onFollowChange?.(!isFollowing);
+      else toast.error(describeFollowError(useFollowStore.getState().errors[userId], t));
     },
     [
       disabled,
@@ -117,6 +120,7 @@ const FollowButtonInner = memo(function FollowButtonInner({
       onFollowChange,
       isFollowing,
       preventParentActions,
+      userId,
       t,
     ],
   );
@@ -234,8 +238,7 @@ const FollowButtonMultiInner = memo(function FollowButtonMultiInner({
           onFollowChange?.(false);
           onBulkUnfollow?.(result);
         } catch (err: unknown) {
-          const error = err instanceof Error ? err : new Error(String(err));
-          toast.error(error.message || t('follow.errors.update'));
+          toast.error(describeFollowError(toFollowErrorCode(err, 'update_failed'), t));
         } finally {
           setIsSubmitting(false);
         }
@@ -261,8 +264,7 @@ const FollowButtonMultiInner = memo(function FollowButtonMultiInner({
         }
         onBulkFollow?.(result);
       } catch (err: unknown) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        toast.error(error.message || t('follow.errors.update'));
+        toast.error(describeFollowError(toFollowErrorCode(err, 'update_failed'), t));
       } finally {
         setIsSubmitting(false);
       }

package/src/ui/components/FollowTargetButton.tsx

@@ -60,7 +60,12 @@ import {
   type FollowDuration,
   type FollowMenuItem,
 } from './followRules';
-import { type FollowLabels, type FollowVerb, useFollowLabels } from './followLabels';
+import {
+  describeFollowError,
+  type FollowLabels,
+  type FollowVerb,
+  useFollowLabels,
+} from './followLabels';
 import { useI18n } from '../hooks/useI18n';
 
 const HOUR = 60 * 60;
@@ -149,8 +154,7 @@ export const FollowTargetButton = memo(function FollowTargetButton({
   );
 
   const reportMutationFailure = useCallback(() => {
-    const message = useFollowTargetStore.getState().errors[targetId] ?? t('follow.errors.update');
-    toast.error(message);
+    toast.error(describeFollowError(useFollowTargetStore.getState().errors[targetId], t));
   }, [targetId, t]);
 
   const label = useMemo(() => {

package/src/ui/components/followLabels.ts

@@ -8,8 +8,9 @@
  * drawn.
  */
 
-import { useMemo } from 'react';
-import { useI18n } from '../hooks/useI18n';
+import { useCallback, useMemo } from 'react';
+import { type Translate, useI18n } from '../hooks/useI18n';
+import type { FollowErrorCode } from '../utils/followErrors';
 
 /**
  * The small vocabulary of verbs the ecosystem actually uses. An application
@@ -46,3 +47,36 @@ export function useFollowLabels(
     [t, verb, overrides],
   );
 }
+
+/** The `follow.errors.*` string for each code — the one place a code becomes words. */
+const FOLLOW_ERROR_KEYS: Record<FollowErrorCode, string> = {
+  read_failed: 'follow.errors.read',
+  update_failed: 'follow.errors.update',
+  mode_failed: 'follow.errors.mode',
+  offline: 'follow.errors.offline',
+  signed_out: 'follow.errors.signedOut',
+  forbidden: 'follow.errors.forbidden',
+  not_found: 'follow.errors.notFound',
+  rate_limited: 'follow.errors.rateLimited',
+};
+
+/**
+ * What a follow error says, in the current language. Every component that
+ * shows a follow failure reads it here; a missing code (a failure the store
+ * did not record) reads as the generic "could not update".
+ */
+export function describeFollowError(
+  code: FollowErrorCode | null | undefined,
+  t: Translate,
+): string {
+  return t(FOLLOW_ERROR_KEYS[code ?? 'update_failed']);
+}
+
+/**
+ * `describeFollowError` bound to the current language, for an application that
+ * renders `useFollowTarget().error` (or `useFollow().error`) itself.
+ */
+export function useFollowErrorMessage(): (code: FollowErrorCode | null | undefined) => string {
+  const { t } = useI18n();
+  return useCallback((code) => describeFollowError(code, t), [t]);
+}

package/src/ui/hooks/useAccountColor.ts

@@ -16,10 +16,12 @@
  * default instead of a colour the viewer is not entitled to.
  */
 
-import { useEffect } from 'react';
+import { useCallback, useEffect, useMemo } from 'react';
 import type { User } from '@oxy.so/core';
 import { APP_COLOR_PRESETS, useBloomTheme, type AppColorName } from '@oxy.so/bloom/theme';
+import { USER_PROFILE_COLORS, USER_PROFILE_COLOR_PRESETS } from '@oxy.so/contracts/client';
 import { useAuth } from './useAuth';
+import { useUpdateProfile } from './mutations/useAccountMutations';
 
 function isAppColorName(value: unknown): value is AppColorName {
   return (
@@ -50,3 +52,71 @@ export function useAccountColor({
     setColorPreset(accountColor);
   }, [isAuthenticated, accountColor, allowed, colorPreset, setColorPreset]);
 }
+
+type EntitlementSubject = Pick<User, 'username' | 'personalization'> | null | undefined;
+
+/**
+ * The presets this account may choose, from the contract's own gate table: a
+ * free preset, the one named after the account's handle (`oxy`, `faircoin`), and
+ * `mono` while the account holds the benefit that grants it. The API enforces
+ * the same rule when it stores the value; this only keeps a picker from offering
+ * what it would refuse.
+ */
+export function entitledAccountColors(
+  user: EntitlementSubject,
+  now: number = Date.now(),
+): readonly AppColorName[] {
+  const handle = user?.username?.trim().toLowerCase();
+  const grant = user?.personalization?.mentionMono;
+  const expires = grant?.expiresAt === null ? Infinity : Date.parse(grant?.expiresAt ?? '');
+  const hasMono = grant?.allowed === true && expires > now;
+  const supported = new Set<string>(USER_PROFILE_COLOR_PRESETS);
+  return USER_PROFILE_COLORS.filter(({ name, gate }) => {
+    if (!supported.has(name) || !isAppColorName(name)) return false;
+    if (gate === null) return true;
+    if (gate === 'handle') return name === handle;
+    return name === 'mono' && hasMono;
+  }).map(({ name }) => name as AppColorName);
+}
+
+/**
+ * Choose the account's colour: one `updateMe` writes `color` and the portable
+ * `themePreference.colorPreset` together (the mode already on the account is
+ * kept), the Bloom theme follows at once, and the session user is updated
+ * optimistically so `useAccountColor` agrees with it. `colors` is what the
+ * picker should list.
+ */
+export function useAccountColorSave(): {
+  colors: readonly AppColorName[];
+  value: AppColorName;
+  saveColor: (name: AppColorName) => Promise<void>;
+  saving: boolean;
+} {
+  const { user } = useAuth();
+  const { mode, colorPreset, setColorPreset } = useBloomTheme();
+  const { mutateAsync, isPending } = useUpdateProfile();
+  const colors = useMemo(() => entitledAccountColors(user), [user]);
+  const saveColor = useCallback(
+    async (name: AppColorName) => {
+      if (!colors.includes(name)) throw new Error('Color is not available for this account');
+      const previous = colorPreset;
+      setColorPreset(name);
+      try {
+        await mutateAsync({
+          color: name,
+          themePreference: {
+            mode:
+              user?.themePreference?.mode ??
+              (mode === 'light' || mode === 'dark' ? mode : 'system'),
+            colorPreset: name,
+          },
+        });
+      } catch (error) {
+        setColorPreset(previous);
+        throw error;
+      }
+    },
+    [colors, colorPreset, setColorPreset, mutateAsync, user, mode],
+  );
+  return { colors, value: colorPreset, saveColor, saving: isPending };
+}

package/src/ui/hooks/useFollow.ts

@@ -2,7 +2,13 @@ import { useCallback, useMemo, useState } from 'react';
 import { useQuery, useQueryClient } from '@tanstack/react-query';
 import { useFollowStore } from '../stores/followStore';
 import { useOxy } from '../context/oxyRuntimeContext';
-import type { OxyServices, BulkFollowResult, BulkUnfollowResult } from '@oxy.so/core';
+import {
+  OxyAuthenticationError,
+  type OxyServices,
+  type BulkFollowResult,
+  type BulkUnfollowResult,
+} from '@oxy.so/core';
+import type { FollowErrorCode } from '../utils/followErrors';
 import { useShallow } from 'zustand/react/shallow';
 import { queryKeys } from './queries/queryKeys';
 import { patchCachedUserRelationship } from './queries/userCacheRelationship';
@@ -79,8 +85,8 @@ export const useFollow = (userId?: string | string[]) => {
   // nested `followData` shape is then assembled in a `useMemo` below.
   const followFlat = useFollowStore(
     useShallow((s) => {
-      if (isSingleUser) return {} as Record<string, boolean | string | null>;
-      const flat: Record<string, boolean | string | null> = {};
+      if (isSingleUser) return {} as Record<string, boolean | FollowErrorCode | null>;
+      const flat: Record<string, boolean | FollowErrorCode | null> = {};
       for (const uid of userIds) {
         flat[`${uid}:isFollowing`] = s.followingUsers[uid] ?? false;
         flat[`${uid}:isLoading`] = s.loadingUsers[uid] ?? false;
@@ -91,14 +97,16 @@ export const useFollow = (userId?: string | string[]) => {
   );
 
   const followData = useMemo(() => {
-    const data: Record<string, { isFollowing: boolean; isLoading: boolean; error: string | null }> =
-      {};
+    const data: Record<
+      string,
+      { isFollowing: boolean; isLoading: boolean; error: FollowErrorCode | null }
+    > = {};
     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`] as string | null) ?? null,
+        error: (followFlat[`${uid}:error`] as FollowErrorCode | null) ?? null,
       };
     }
     return data;
@@ -128,7 +136,8 @@ export const useFollow = (userId?: string | string[]) => {
   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');
+    if (!canUsePrivateApi)
+      throw new OxyAuthenticationError('Authentication is required to follow users');
     const currentlyFollowing = useFollowStore.getState().followingUsers[userId] ?? false;
     const accepted = await useFollowStore
       .getState()
@@ -209,7 +218,8 @@ export const useFollow = (userId?: string | string[]) => {
   // Multi-user callbacks
   const toggleFollowForUser = useCallback(
     async (targetUserId: string) => {
-      if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+      if (!canUsePrivateApi)
+        throw new OxyAuthenticationError('Authentication is required to follow users');
       const currentState = useFollowStore.getState().followingUsers[targetUserId] ?? false;
       const accepted = await useFollowStore
         .getState()
@@ -240,13 +250,15 @@ export const useFollow = (userId?: string | string[]) => {
 
   // Bulk follow — follows ALL users in ONE network call (never unfollows).
   const followAllUsers = useCallback(async (): Promise<BulkFollowResult> => {
-    if (!canUsePrivateApi) throw new Error('Authentication is required to follow users');
+    if (!canUsePrivateApi)
+      throw new OxyAuthenticationError('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 (): Promise<BulkUnfollowResult> => {
-    if (!canUsePrivateApi) throw new Error('Authentication is required to unfollow users');
+    if (!canUsePrivateApi)
+      throw new OxyAuthenticationError('Authentication is required to unfollow users');
     return useFollowStore.getState().unfollowManyUsers(userIds, oxyServices);
   }, [canUsePrivateApi, userIds, oxyServices]);
 

package/src/ui/hooks/useFollow.types.ts

@@ -2,11 +2,12 @@
 // Expand this as needed to better reflect the real return type.
 
 import type { BulkFollowResult } from '@oxy.so/core';
+import type { FollowErrorCode } from '../utils/followErrors';
 
 export type SingleFollowResult = {
   isFollowing: boolean;
   isLoading: boolean;
-  error: string | null;
+  error: FollowErrorCode | null;
   toggleFollow: () => Promise<void>;
   setFollowStatus: (following: boolean) => void;
   fetchStatus: () => Promise<void>;
@@ -20,7 +21,10 @@ export type SingleFollowResult = {
 };
 
 export type MultiFollowResult = {
-  followData: Record<string, { isFollowing: boolean; isLoading: boolean; error: string | null }>;
+  followData: Record<
+    string,
+    { isFollowing: boolean; isLoading: boolean; error: FollowErrorCode | null }
+  >;
   toggleFollowForUser: (userId: string) => Promise<void>;
   setFollowStatusForUser: (userId: string, following: boolean) => void;
   fetchStatusForUser: (userId: string) => Promise<void>;