Fetch received pending connections

Fetch connection requests received by the current user that are still pending

Overview

Returns a function that fetches the paginated list of connection requests that other users have sent to the current authenticated user and that have not yet been accepted or declined.

Usage Example

import { useFetchReceivedPendingConnections } from "@sublay/react-js";
import { useAcceptConnection } from "@sublay/react-js";

function IncomingRequests() {
  const fetchReceivedPendingConnections = useFetchReceivedPendingConnections();
  const acceptConnection = useAcceptConnection();
  const [requests, setRequests] = useState([]);

  useEffect(() => {
    fetchReceivedPendingConnections({ page: 1 }).then((res) => {
      setRequests(res.data);
    });
  }, []);

  return (
    <ul>
      {requests.map(({ id, user }) => (
        <li key={id}>
          {user.name} wants to connect
          <button onClick={() => acceptConnection({ connectionId: id })}>Accept</button>
        </li>
      ))}
    </ul>
  );
}

Parameters

The hook returns a function. That function accepts:

page · number

Page number to fetch. Defaults to 1.

limit · number

Number of results per page. Defaults to 20.

Returns

Returns a PaginatedResponse containing pending connection entries:

data · PendingConnection[]

Array of pending connection entries.

Show PendingConnection properties

id · string

ID of the connection record.

user · User

The user who sent the request. See User data model.

type · "received"

Always "received" for this endpoint.

message · string | undefined

Optional message included with the request.

createdAt · string

ISO timestamp when the request was created.

pagination · object

Pagination metadata including page, pageSize, totalPages, totalItems, and hasMore.

Related

• useFetchSentPendingConnections — outgoing requests
• useAcceptConnection — accept a received request
• useDeclineConnection — decline a received request