Skip to main content
Version: 0.2.x

Class: ComposeClient

client.ComposeClient

The ComposeClient class provides APIs to execute queries on a GraphQL schema generated from a RuntimeCompositeDefinition. It allows applications to interact with documents using known models on a Ceramic node.

It is exported by the client module.

import { ComposeClient } from '@composedb/client'

Constructors​

constructor​

• new ComposeClient(params)

Parameters​

NameType
paramsComposeClientParams

Accessors​

context​

• get context(): Context

Context instance used internally.

Returns​

Context


did​

• get did(): undefined | DID

DID instance used internally by the Ceramic client instance.

Returns​

undefined | DID


id​

• get id(): null | string

ID of the DID attached to the Ceramic client instance used internally. If null, the Ceramic instance is not authenticated and mutations will fail.

Returns​

null | string


resources​

• get resources(): string[]

CACAO resources URLs for the models the client interacts with.

Returns​

string[]

Methods​

execute​

▸ execute(document, variableValues?): Promise<ExecutionResult<ObjMap<unknown>, ObjMap<unknown>>>

Execute a GraphQL query from a DocumentNode and optional variables.

Parameters​

NameType
documentDocumentNode
variableValues?Record<string, unknown>

Returns​

Promise<ExecutionResult<ObjMap<unknown>, ObjMap<unknown>>>


executeQuery​

▸ executeQuery(source, variableValues?): Promise<ExecutionResult<ObjMap<unknown>, ObjMap<unknown>>>

Execute a GraphQL query from its source and optional variables.

Parameters​

NameType
sourcestring | Source
variableValues?Record<string, unknown>

Returns​

Promise<ExecutionResult<ObjMap<unknown>, ObjMap<unknown>>>


setDID​

▸ setDID(did): void

Attach the given DID instance to the Ceramic client instance used internally. An authenticated DID instance is necessary to perform GraphQL mutations.

Parameters​

NameType
didDID

Returns​

void