Rxdb Client

Classes

Classes

RxDBClientError

Custom error classes for RxDB client

Constructor

constructor(message: string, code: string, details?: any)

Parameters:

ParameterTypeRequiredDescription
messagestringYes
codestringYes
detailsanyNo

ConnectionError

Constructor

constructor(message: string, details?: any)

Parameters:

ParameterTypeRequiredDescription
messagestringYes
detailsanyNo

ReplicationError

Constructor

constructor(message: string, details?: any)

Parameters:

ParameterTypeRequiredDescription
messagestringYes
detailsanyNo

ConfigurationError

Constructor

constructor(message: string, details?: any)

Parameters:

ParameterTypeRequiredDescription
messagestringYes
detailsanyNo

NotSupportedError

Constructor

constructor(message: string, details?: any)

Parameters:

ParameterTypeRequiredDescription
messagestringYes
detailsanyNo

ReplicationClient

Replication-based RxDB client Uses local database with server replication

Constructor

constructor(config: ReplicationConfig<TCollections>)

Parameters:

ParameterTypeRequiredDescription
configReplicationConfig<TCollections>Yes

Methods

isConnected

isConnected(): boolean

Returns:

boolean -

connect

connect(): Promise<void>

Returns:

Promise<void> -

disconnect

disconnect(removeData?: boolean): Promise<void>

Parameters:

ParameterTypeRequiredDescription
removeDatabooleanNo

Returns:

Promise<void> -

RestClient

REST-based RxDB client Uses direct REST API calls instead of local database

Constructor

constructor(config: RestConfig<TCollections>)

Parameters:

ParameterTypeRequiredDescription
configRestConfig<TCollections>Yes

Methods

isConnected

isConnected(): boolean

Returns:

boolean -

connect

connect(): Promise<void>

Returns:

Promise<void> -

disconnect

disconnect(_removeData?: boolean | undefined): Promise<void>

Parameters:

ParameterTypeRequiredDescription
_removeDataboolean | undefinedNo

Returns:

Promise<void> -

updateAuthToken

Update the auth token for all REST clients Used for token refresh without reconnecting

updateAuthToken(newToken: string): void

Parameters:

ParameterTypeRequiredDescription
newTokenstringYes

CollectionWrapper

Wrapper around RxDB collection providing standardized interface

Constructor

constructor(collection: RxCollection<TDocument>)

Parameters:

ParameterTypeRequiredDescription
collectionRxCollection<TDocument>Yes

Methods

insert

insert(doc: TDocument): Promise<TDocument>

Parameters:

ParameterTypeRequiredDescription
docTDocumentYes

Returns:

Promise<TDocument> -

bulkInsert

bulkInsert(docs: TDocument[]): Promise<TDocument[]>

Parameters:

ParameterTypeRequiredDescription
docsTDocument[]Yes

Returns:

Promise<TDocument[]> -

findOne

findOne(query: Query<TDocument>): Promise<TDocument | null>

Parameters:

ParameterTypeRequiredDescription
queryQuery<TDocument>Yes

Returns:

Promise<TDocument \| null> -

find

find(query: Query<TDocument>): Promise<TDocument[]>

Parameters:

ParameterTypeRequiredDescription
queryQuery<TDocument>Yes

Returns:

Promise<TDocument[]> -

update

update(id: string, updates: Partial<TDocument>): Promise<TDocument>

Parameters:

ParameterTypeRequiredDescription
idstringYes
updatesPartial<TDocument>Yes

Returns:

Promise<TDocument> -

delete

delete(id: string): Promise<boolean>

Parameters:

ParameterTypeRequiredDescription
idstringYes

Returns:

Promise<boolean> -

findOne$

findOne$(query: Query<TDocument>): Observable<TDocument | null>

Parameters:

ParameterTypeRequiredDescription
queryQuery<TDocument>Yes

Returns:

Observable<TDocument \| null> -

find$

find$(query: Query<TDocument>): Observable<TDocument[]>

Parameters:

ParameterTypeRequiredDescription
queryQuery<TDocument>Yes

Returns:

Observable<TDocument[]> -

getRxCollection

getRxCollection(): RxCollection<TDocument>

Returns:

RxCollection<TDocument> -

RestCollectionWrapper

Wrapper around REST client providing collection-like interface with client-side schema validation

Constructor

constructor(restClient: RxRestClient, collectionName: string, schema?: any)

Parameters:

ParameterTypeRequiredDescription
restClientRxRestClientYes
collectionNamestringYes
schemaanyNo

Methods

insert

insert(doc: TDocument): Promise<TDocument>

Parameters:

ParameterTypeRequiredDescription
docTDocumentYes

Returns:

Promise<TDocument> -

bulkInsert

bulkInsert(docs: TDocument[]): Promise<TDocument[]>

Parameters:

ParameterTypeRequiredDescription
docsTDocument[]Yes

Returns:

Promise<TDocument[]> -

findOne

findOne(query: Query<TDocument>): Promise<TDocument | null>

Parameters:

ParameterTypeRequiredDescription
queryQuery<TDocument>Yes

Returns:

Promise<TDocument \| null> -

find

find(query: Query<TDocument>): Promise<TDocument[]>

Parameters:

ParameterTypeRequiredDescription
queryQuery<TDocument>Yes

Returns:

Promise<TDocument[]> -

update

update(id: string, updates: Partial<TDocument>): Promise<TDocument>

Parameters:

ParameterTypeRequiredDescription
idstringYes
updatesPartial<TDocument>Yes

Returns:

Promise<TDocument> -

delete

delete(id: string): Promise<boolean>

Parameters:

ParameterTypeRequiredDescription
idstringYes

Returns:

Promise<boolean> -

findOne$

findOne$(_query: Query<TDocument>): Observable<TDocument | null>

Parameters:

ParameterTypeRequiredDescription
_queryQuery<TDocument>Yes

Returns:

Observable<TDocument \| null> -

find$

find$(_query: Query<TDocument>): Observable<TDocument[]>

Parameters:

ParameterTypeRequiredDescription
_queryQuery<TDocument>Yes

Returns:

Observable<TDocument[]> -

getRxCollection

getRxCollection(): never

Returns:

never -

updateClient

Update the underlying REST client Used for token refresh without reconnecting

updateClient(newClient: RxRestClient): void

Parameters:

ParameterTypeRequiredDescription
newClientRxRestClientYes
Previous
Types