---
title: "openvibe-sdk/friends · OpenVibe.Services"
canonical: "https://openvibe.services/docs/sdk/friends"
updated: null
---

# openvibe-sdk/friends · OpenVibe.Services

HTML: [openvibe-sdk/friends · OpenVibe.Services](https://openvibe.services/docs/sdk/friends)

# `openvibe-sdk/friends`

Generated at 2026-11-17 06:52:56 UTC from [`openvibe-contracts v0.443.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.443.0) and [`openvibe-sdk v0.177.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.177.0).

From `types/friends.d.ts` (both). Declarations are shown verbatim.

## interface FriendPerson

One person in the circle (network.friend-circle@1).

~~~~
export interface FriendPerson {
    subject: string;
    username: string | null;
    display_name: string | null;
    avatar_url?: string | null;
    /** Seen on an OpenVibe site in the last few minutes (Network's presence). */
    online: boolean;
    /** Where they are, when online and they share it. */
    site?: string | null;
    /** When this side of the friendship last changed. */
    since?: string | null;
}
~~~~

## type FriendState

The pair as the card shows it: none, pending (I added them), requested (they added me), friends.

~~~~
export type FriendState = 'none' | 'pending' | 'requested' | 'friends';
~~~~

## interface FriendEntry

~~~~
export interface FriendEntry {
    subject: string;
    username: string | null;
    display_name: string | null;
    active: boolean;
    /** This side's revision; it grows with every change of the pair. */
    revision: number;
    state: FriendState;
    added_at?: string;
}
~~~~

## interface FriendCircle

The person's whole circle in one read (network.friend-circle@1).

~~~~
export interface FriendCircle {
    subject: string;
    /** Whom the person added (mutual and asked), for older readers. */
    friends: Array<{ subject: string }>;
    /** Friends: both added each other. */
    mutual: FriendPerson[];
    /** They added the person, the person did not add them. */
    requests: FriendPerson[];
    /** The person added them, they did not add the person. */
    asked: FriendPerson[];
}
~~~~

## interface FriendSubjects

A person's mutual friends as subjects only (network.friend-subjects@1).

~~~~
export interface FriendSubjects {
    subject: string;
    friends: string[];
}
~~~~

## interface FriendsClient

~~~~
export interface FriendsClient {
    /** The person's circle: network.friend-circle@1. */
    list(): Promise<FriendCircle>;
    /** Add someone (a usr_ subject or a username). */
    add(subjectOrUsername: string): Promise<{ changed: boolean; friend: FriendEntry }>;
    /** Accept a request: add them back. */
    accept(subjectOrUsername: string): Promise<{ changed: boolean; friend: FriendEntry }>;
    /** Remove them again. */
    remove(subjectOrUsername: string): Promise<{ changed: boolean; friend: FriendEntry }>;
    /** A service reads a person's mutual friends as subjects only (needs network.friends.read). */
    subjects(subject: string): Promise<FriendSubjects>;
}
~~~~

## function createFriendsClient

~~~~
export declare function createFriendsClient(client: OpenVibeClient, opts?: { baseUrl?: string }): FriendsClient;
~~~~
