pb.profiles

Call pb.profiles(username) with a Packbase username to get a lazy ProfileHandle. This action does not make a network request. Await the handle to fetch the profile. Alternatively, call an action such as .follow() directly. The action does not fetch the profile first.

Fetch a profile

const profile = await pb.profiles('rek')

console.log(profile.display_name)
console.log(profile.about?.bio)

The result is a Profile. Some properties are optional because public and authenticated requests can receive different data.

Follow and unfollow

Following and unfollowing are separate server operations:

await pb.profiles('rek').follow()   // POST /user/:username/follow
await pb.profiles('rek').unfollow() // DELETE /user/:username/follow

Both methods finish without response data (Promise<void>). If you follow an account that you already follow, the server returns status 400. The server returns the same status if you unfollow an account that you do not follow.

Profile version history

history() returns saved versions of the profile. The versions include changes to its name, bio, and related fields. The method does not return the user's howls.

const versions = await pb.profiles('rek').history({
  from: new Date('2026-01-01T00:00:00Z'),
  axis: 'transaction',
  order: 'desc',
  limit: 50,
})

console.log(versions[0]?.operation)
console.log(versions[0]?.display_name)

from and to limit the date range. axis applies these dates to transaction time or decision time. order selects ascending or descending order. limit must be from 1 through 500. For an audit history, use axis: 'transaction'.

Report a user

const ticket = await pb.profiles('rek').report(
  ReportReason.Spam,
  'Repeated unsolicited posts.',
)

console.log(ticket.id, ticket.status)

This sends POST /user/:username/report and returns a ReportResult.