Social Actions

Follow, block, and mute users on Bluesky, with typed refs and undo support.

Domain Types

FollowRef

Returned by Bluesky.follow -- pass to unfollow or undoFollow to undo.

BlockRef

Returned by Bluesky.block -- pass to unblock or undoBlock to undo.

LikeRef

Returned by Bluesky.like -- pass to unlike or undoLike to undo.

RepostRef

Returned by Bluesky.repost -- pass to unrepost or undoRepost to undo.

ListBlockRef

Returned by Bluesky.blockModList -- pass to unblockModList to undo.

UndoResult

Discriminated union returned by undo* functions indicating whether the action was reversed.

Only unlikePost and unrepostPost can return WasNotPresent (they check viewer state). The ref-based undoLike, undoRepost, undoFollow, and undoBlock always return Undone because deleteRecord is idempotent.

Functions

Following

taskResult {
    // Follow using a profile's DID
    let! followRef = Bluesky.follow agent profile

    // Or by handle string
    let! followRef2 = Bluesky.followByHandle agent "alice.bsky.social"

    // Undo
    do! Bluesky.unfollow agent followRef
}

Blocking

taskResult {
    let! blockRef = Bluesky.block agent profile
    let! blockRef2 = Bluesky.blockByHandle agent "spammer.example.com"

    // Moderation list
    let! listBlockRef = Bluesky.blockModList agent modListUri
    do! Bluesky.unblockModList agent listBlockRef
}

Muting

taskResult {
    do! Bluesky.muteUser agent profile
    do! Bluesky.muteUserByHandle agent "noisy.bsky.social"
    do! Bluesky.muteThread agent post
    do! Bluesky.muteModList agent modListUri
}

Generic Undo

taskResult {
    let! likeRef = Bluesky.like agent post
    let! followRef = Bluesky.follow agent profile

    // Generic undo works with any ref type
    let! _ = Bluesky.undo agent likeRef
    let! _ = Bluesky.undo agent followRef
    ()
}

SRTP Polymorphism

Social action functions accept multiple types via SRTP:

• follow, block, muteUser, unmuteUser accept Did, ProfileSummary, or Profile
• muteThread, unmuteThread accept TimelinePost, PostRef, or AtUri
• undo accepts LikeRef, RepostRef, FollowRef, BlockRef, or ListBlockRef

taskResult {
    let! profile = Bluesky.getProfile agent aliceHandle

    // Pass the Profile directly -- no need to extract .Did
    let! followRef = Bluesky.follow agent profile
    do! Bluesky.muteUser agent profile

    // Pass a TimelinePost directly to mute its thread
    let! page = Bluesky.getTimeline agent (Some 1L) None
    do! Bluesky.muteThread agent page.Items.Head.Post
}