@oxyhq/core 3.13.1 → 3.14.0

package/dist/types/mixins/OxyServices.user.d.ts

@@ -295,6 +295,15 @@ export declare function OxyServicesUserMixin<T extends typeof OxyServicesBase>(B
             total: number;
             hasMore: boolean;
         }>;
+        /**
+         * Get user mutuals ("followers you know" — users the authenticated viewer
+         * follows who also follow `userId`). The viewer is derived server-side from auth.
+         */
+        getUserMutuals(userId: string, pagination?: PaginationParams): Promise<{
+            mutuals: User[];
+            total: number;
+            hasMore: boolean;
+        }>;
         /**
          * Get notifications
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/core",
-  "version": "3.13.1",
+  "version": "3.14.0",
   "description": "OxyHQ SDK Foundation — API client, authentication, cryptographic identity, and shared utilities",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/mixins/OxyServices.user.ts

@@ -740,6 +740,30 @@ export function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T)
       }
     }
 
+    /**
+     * Get user mutuals ("followers you know" — users the authenticated viewer
+     * follows who also follow `userId`). The viewer is derived server-side from auth.
+     */
+    async getUserMutuals(
+      userId: string,
+      pagination?: PaginationParams
+    ): Promise<{ mutuals: User[]; total: number; hasMore: boolean }> {
+      try {
+        const params = buildPaginationParams(pagination || {});
+        const response = await this.makeRequest<{ data: User[]; pagination: { total: number; hasMore: boolean } }>('GET', `/users/${userId}/mutuals`, params, {
+          cache: true,
+          cacheTTL: 2 * 60 * 1000, // 2 minutes cache
+        });
+        return {
+          mutuals: response.data || [],
+          total: response.pagination.total,
+          hasMore: response.pagination.hasMore,
+        };
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
     /**
      * Get notifications
      */