SDK
Packages
Label

Label SDK

The label SDK allows to add labels to specific anchors, like Assets or Projects. This could also be referred to as tagging. A tagged anchor can be found by searching for the label.

Installation

To install this package, you need to have access to the private @sdk npm scope.

To integrate the SDK Label package into your project, use the following command with your preferred package manager:

npm install @sdk/label

Label Service

A service has to be set up to use the label SDK. The service is responsible for managing the labels and their relations to anchors.

import myConnectClient from './myConnectClient';
import { LabelService, LabelMapper } from '@sdk/label';
 
const labelService = new LabelService(myConnectClient, new LabelMapper());

The example above shows how to set up a label service. It assumes that myConnectClient is a instance of the Connect client from the @sdk/connect package.

React Integration

In order to have access to the label service in your React components, you can use the LabelServiceProvider:

💡

The LabelServiceProvider has a dependency on the ConnectProvider from the @sdk/connect package.

import { LabelServiceProvider } from '@sdk/label';
 
export default function App() {
  return <LabelServiceProvider>{children}</LabelServiceProvider>;
}

After wrapping your application with the LabelServiceProvider, you have access to a set of hooks to interact with labels:

  • useLabels: Fetches all labels for a given anchor.
  • useLabelFilter: To search for existing labels that can attached to an anchor.
  • useLabelService: Provides access to the label service and therefore the ability to create, update and delete labels.