@oxyhq/core 3.4.19 → 3.5.0

package/dist/types/index.d.ts

@@ -33,6 +33,7 @@ export type { ServiceTokenResponse } from './mixins/OxyServices.auth';
 export type { ServiceApp, ServiceActingAsVerification } from './mixins/OxyServices.utility';
 export type { CreateManagedAccountInput, ManagedAccountManager, ManagedAccount, } from './mixins/OxyServices.managedAccounts';
 export type { ContactDiscoveryMatch, ContactDiscoveryResponse, } from './mixins/OxyServices.contacts';
+export type { BulkFollowEntry, BulkFollowResult, } from './mixins/OxyServices.user';
 export { OxyAppDataIdentifierError } from './mixins/OxyServices.appData';
 export { getNormalizedUserId, normalizeUserIdentity, normalizeUserIdentityOrNull, } from './utils/userIdentity';
 export { getCanonicalUserHandle, getNormalizedUserHandle, } from './utils/userHandle';

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

@@ -5,6 +5,22 @@ import type { User, Notification, NotificationPreferences, UserPreferences, Sear
 import type { UserNameResponse, UserProfileUpdate } from '@oxyhq/contracts';
 import type { OxyServicesBase } from '../OxyServices.base';
 import { type PaginationParams } from '../utils/apiUtils';
+/** Per-user outcome returned by `POST /users/follow/bulk`. */
+export interface BulkFollowEntry {
+    /** The user ID that was processed. */
+    userId: string;
+    /** Whether the follow was applied (or already in place) without error. */
+    success: boolean;
+    /** Whether the caller was already following this user before the request. */
+    alreadyFollowing: boolean;
+}
+/** Response shape of `POST /users/follow/bulk`. */
+export interface BulkFollowResult {
+    /** Per-user outcomes, in request order. */
+    results: BulkFollowEntry[];
+    /** Number of users newly followed by this request. */
+    followedCount: number;
+}
 export declare function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T): {
     new (...args: any[]): {
         /**
@@ -167,6 +183,15 @@ export declare function OxyServicesUserMixin<T extends typeof OxyServicesBase>(B
             success: boolean;
             message: string;
         }>;
+        /**
+         * Follow multiple users in a single request.
+         *
+         * POSTs `/users/follow/bulk` with `{ userIds }` (server caps the batch at
+         * 200). Returns the per-user outcomes and the count of users newly
+         * followed. An empty `userIds` array resolves immediately with an empty
+         * result and performs no network call.
+         */
+        followUsers(userIds: string[]): Promise<BulkFollowResult>;
         /**
          * Unfollow a user
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/core",
-  "version": "3.4.19",
+  "version": "3.5.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/index.ts

@@ -61,6 +61,10 @@ export type {
     ContactDiscoveryMatch,
     ContactDiscoveryResponse,
 } from './mixins/OxyServices.contacts';
+export type {
+    BulkFollowEntry,
+    BulkFollowResult,
+} from './mixins/OxyServices.user';
 export { OxyAppDataIdentifierError } from './mixins/OxyServices.appData';
 
 // ---------------------------------------------------------------------------

package/src/mixins/OxyServices.user.ts

@@ -17,6 +17,24 @@ import { KeyManager } from '../crypto/keyManager';
 import { SignatureService } from '../crypto/signatureService';
 import { normalizeUserIdentity, normalizeUserIdentityOrNull } from '../utils/userIdentity';
 
+/** Per-user outcome returned by `POST /users/follow/bulk`. */
+export interface BulkFollowEntry {
+  /** The user ID that was processed. */
+  userId: string;
+  /** Whether the follow was applied (or already in place) without error. */
+  success: boolean;
+  /** Whether the caller was already following this user before the request. */
+  alreadyFollowing: boolean;
+}
+
+/** Response shape of `POST /users/follow/bulk`. */
+export interface BulkFollowResult {
+  /** Per-user outcomes, in request order. */
+  results: BulkFollowEntry[];
+  /** Number of users newly followed by this request. */
+  followedCount: number;
+}
+
 export function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T) {
   return class extends Base {
     constructor(...args: any[]) {
@@ -404,6 +422,25 @@ export function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T)
       }
     }
 
+    /**
+     * Follow multiple users in a single request.
+     *
+     * POSTs `/users/follow/bulk` with `{ userIds }` (server caps the batch at
+     * 200). Returns the per-user outcomes and the count of users newly
+     * followed. An empty `userIds` array resolves immediately with an empty
+     * result and performs no network call.
+     */
+    async followUsers(userIds: string[]): Promise<BulkFollowResult> {
+      if (userIds.length === 0) {
+        return { results: [], followedCount: 0 };
+      }
+      try {
+        return await this.makeRequest<BulkFollowResult>('POST', '/users/follow/bulk', { userIds }, { cache: false });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
     /**
      * Unfollow a user
      */