Skip to main content
Version: 0.8.x

Class: ComposeClient

client.ComposeClient

The ComposeClient class provides APIs to execute queries on a GraphQL schema generated from a RuntimeCompositeDefinition, leveraging the ComposeRuntime class.

It is exported by the client module.

import { ComposeClient } from '@composedb/client'

Constructors​

constructor​

• new ComposeClient(params): ComposeClient

Parameters​

NameType
paramsComposeClientParams

Returns​

ComposeClient

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<Data>(document, variableValues?): Promise<ExecutionResult<Data, ObjMap<unknown>>>

Execute a GraphQL query from a DocumentNode and optional variables.

Type parameters​

NameType
DataRecord<string, unknown>

Parameters​

NameType
documentDocumentNode
variableValues?Record<string, unknown>

Returns​

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


executeQuery​

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

Execute a GraphQL query from its source and optional variables.

Type parameters​

NameType
DataRecord<string, unknown>

Parameters​

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

Returns​

Promise<ExecutionResult<Data, 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