@brightchain/brightchain-api-lib 0.23.21 → 0.24.0

package/src/lib/services/brighthub/userProfileService.d.ts

@@ -0,0 +1,203 @@
+import { ApproveFollowersMode, IBaseFollowRequest, IBasePrivacySettings, IBaseUserProfile, IFollowRequestOptions, IFollowResult, IPaginatedResult, IPaginationOptions, IUpdateProfileOptions, IUserProfileService } from '@brightchain/brighthub-lib';
+/**
+ * Find query interface for chaining
+ */
+interface FindQuery<T> {
+    sort?(field: Record<string, 1 | -1>): FindQuery<T>;
+    skip?(count: number): FindQuery<T>;
+    limit?(count: number): FindQuery<T>;
+    exec(): Promise<T[]>;
+}
+/**
+ * Collection interface for database operations
+ */
+interface Collection<T> {
+    create(record: T): Promise<T>;
+    findOne(filter: Partial<T>): {
+        exec(): Promise<T | null>;
+    };
+    find(filter: Partial<T>): FindQuery<T>;
+    updateOne(filter: Partial<T>, update: Partial<T>): {
+        exec(): Promise<{
+            modifiedCount: number;
+        }>;
+    };
+    deleteOne(filter: Partial<T>): {
+        exec(): Promise<{
+            deletedCount: number;
+        }>;
+    };
+    countDocuments?(filter: Partial<T>): {
+        exec(): Promise<number>;
+    };
+}
+/**
+ * Application interface for accessing database collections
+ */
+interface IApplicationWithCollections {
+    getModel<T>(name: string): Collection<T>;
+}
+/**
+ * User_Profile_Service implementation
+ * Handles user profiles, following, blocking, and muting
+ * @see Requirements: 4.1-4.11, 8.1-8.6, 18.1-18.6, 31.1-31.7
+ */
+export declare class UserProfileService implements IUserProfileService {
+    private readonly userProfilesCollection;
+    private readonly followsCollection;
+    private readonly followRequestsCollection;
+    private readonly blocksCollection;
+    private readonly mutesCollection;
+    constructor(application: IApplicationWithCollections);
+    /**
+     * Convert a database record to the API response format
+     */
+    private recordToProfile;
+    /**
+     * Convert a follow request record to the API response format
+     */
+    private recordToFollowRequest;
+    /**
+     * Get effective pagination limit
+     */
+    private getLimit;
+    /**
+     * Check if a user requires follow approval for a given requester
+     */
+    private requiresApproval;
+    /**
+     * Follow a user
+     * @see Requirements: 4.1, 4.3
+     */
+    follow(followerId: string, followedId: string, options?: IFollowRequestOptions): Promise<IFollowResult>;
+    /**
+     * Create a follow relationship and update counts
+     */
+    private createFollowRelationship;
+    /**
+     * Unfollow a user
+     * @see Requirements: 4.2
+     */
+    unfollow(followerId: string, followedId: string): Promise<void>;
+    /**
+     * Check if a user is following another user
+     */
+    isFollowing(followerId: string, followedId: string): Promise<boolean>;
+    /**
+     * Get a user's followers
+     * @see Requirements: 4.4, 4.6
+     */
+    getFollowers(userId: string, options?: IPaginationOptions): Promise<IPaginatedResult<IBaseUserProfile<string>>>;
+    /**
+     * Get users that a user is following
+     * @see Requirements: 4.5, 4.6
+     */
+    getFollowing(userId: string, options?: IPaginationOptions): Promise<IPaginatedResult<IBaseUserProfile<string>>>;
+    /**
+     * Get pending follow requests for a user
+     * @see Requirements: 4.7, 4.8
+     */
+    getFollowRequests(userId: string, options?: IPaginationOptions): Promise<IPaginatedResult<IBaseFollowRequest<string>>>;
+    /**
+     * Approve a follow request
+     * @see Requirements: 4.9
+     */
+    approveFollowRequest(userId: string, requestId: string): Promise<void>;
+    /**
+     * Reject a follow request
+     * @see Requirements: 4.10
+     */
+    rejectFollowRequest(userId: string, requestId: string): Promise<void>;
+    /**
+     * Set the approve followers mode for a user
+     * @see Requirements: 4.11
+     */
+    setApproveFollowersMode(userId: string, mode: ApproveFollowersMode): Promise<void>;
+    /**
+     * Get a user's profile
+     * @see Requirements: 8.6
+     */
+    getProfile(userId: string, requesterId?: string): Promise<IBaseUserProfile<string>>;
+    /**
+     * Update a user's display name
+     * @see Requirements: 8.1
+     */
+    updateDisplayName(userId: string, displayName: string): Promise<void>;
+    /**
+     * Update a user's bio
+     * @see Requirements: 8.2
+     */
+    updateBio(userId: string, bio: string): Promise<void>;
+    /**
+     * Validate image MIME type
+     */
+    private validateImageFormat;
+    /**
+     * Update a user's profile picture
+     * @see Requirements: 8.3
+     */
+    updateProfilePicture(userId: string, url: string, mimeType: string): Promise<void>;
+    /**
+     * Update a user's header image
+     * @see Requirements: 8.4
+     */
+    updateHeaderImage(userId: string, url: string, mimeType: string): Promise<void>;
+    /**
+     * Update multiple profile fields at once
+     * @see Requirements: 8.1-8.5
+     */
+    updateProfile(userId: string, updates: IUpdateProfileOptions): Promise<IBaseUserProfile<string>>;
+    /**
+     * Block a user
+     * @see Requirements: 18.1, 18.2
+     */
+    blockUser(blockerId: string, blockedId: string): Promise<void>;
+    /**
+     * Unblock a user
+     * @see Requirements: 18.6
+     */
+    unblockUser(blockerId: string, blockedId: string): Promise<void>;
+    /**
+     * Check if a user has blocked another user
+     */
+    isBlocked(blockerId: string, blockedId: string): Promise<boolean>;
+    /**
+     * Get list of blocked users
+     * @see Requirements: 18.5
+     */
+    getBlockedUsers(userId: string, options?: IPaginationOptions): Promise<IPaginatedResult<IBaseUserProfile<string>>>;
+    /**
+     * Mute a user
+     * @see Requirements: 18.3
+     */
+    muteUser(muterId: string, mutedId: string): Promise<void>;
+    /**
+     * Unmute a user
+     * @see Requirements: 18.4
+     */
+    unmuteUser(muterId: string, mutedId: string): Promise<void>;
+    /**
+     * Check if a user has muted another user
+     */
+    isMuted(muterId: string, mutedId: string): Promise<boolean>;
+    /**
+     * Get list of muted users
+     * @see Requirements: 18.5
+     */
+    getMutedUsers(userId: string, options?: IPaginationOptions): Promise<IPaginatedResult<IBaseUserProfile<string>>>;
+    /**
+     * Get a user's privacy settings
+     */
+    getPrivacySettings(userId: string): Promise<IBasePrivacySettings>;
+    /**
+     * Update a user's privacy settings
+     * @see Requirements: 31.1-31.7
+     */
+    updatePrivacySettings(userId: string, settings: Partial<IBasePrivacySettings>): Promise<IBasePrivacySettings>;
+}
+/**
+ * Create a new UserProfileService instance
+ */
+export declare function createUserProfileService(application: IApplicationWithCollections): UserProfileService;
+export {};
+//# sourceMappingURL=userProfileService.d.ts.map

package/src/lib/services/brighthub/userProfileService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userProfileService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/services/brighthub/userProfileService.ts"],"names":[],"mappings":"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"}