0.2.7 • Published 1 year ago

@recouch/couchbase-lite-capacitor v0.2.7

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
1 year ago

@recouch/couchbase-lite-capacitor

Couchbase Lite bindings for iOS and Android with Capacitor

Install

npm install @recouch/couchbase-lite-capacitor
npx cap sync

API

openDatabase(...)

openDatabase(options: { name: string; directory?: string; }) => Result<DatabaseRef>
ParamType
options{ name: string; directory?: string; }

Returns: Result<Tagged<'Database'>>


addDatabaseChangeListener(...)

addDatabaseChangeListener(options: DatabaseRefOptions, handler: DatabaseChangeListener) => Result<ListenerToken>
ParamType
optionsDatabaseRefOptions
handlerDatabaseChangeListener

Returns: Result<Tagged<'ListenerToken'>>


beginTransaction(...)

beginTransaction(options: DatabaseRefOptions) => Result<void>
ParamType
optionsDatabaseRefOptions

Returns: Result<void>


closeDatabase(...)

closeDatabase(options: DatabaseRefOptions) => Result<void>
ParamType
optionsDatabaseRefOptions

Returns: Result<void>


databaseName(...)

databaseName(options: DatabaseRefOptions) => Result<string>
ParamType
optionsDatabaseRefOptions

Returns: Result<string>


databasePath(...)

databasePath(options: DatabaseRefOptions) => Result<string>
ParamType
optionsDatabaseRefOptions

Returns: Result<string>


deleteDatabase(...)

deleteDatabase(options: { name: string; directory: string; }) => Result<void>
ParamType
options{ name: string; directory: string; }

Returns: Result<void>


deleteDatabase(...)

deleteDatabase(options: DatabaseRefOptions) => Result<void>
ParamType
optionsDatabaseRefOptions

Returns: Result<void>


endTransaction(...)

endTransaction(options: DatabaseRefOptions & { commit: boolean; }) => Result<void>
ParamType
optionsDatabaseRefOptions & { commit: boolean; }

Returns: Result<void>


removeDatabaseChangeListener(...)

removeDatabaseChangeListener(options: { token: ListenerToken; }) => Result<void>
ParamType
options{ token: Tagged<'ListenerToken'>; }

Returns: Result<void>


addDocumentChangeListener(...)

addDocumentChangeListener(options: DatabaseRefOptions & { id: string; }, handler: DocumentChangeListener) => Result<ListenerToken>
ParamType
optionsDatabaseRefOptions & { id: string; }
handlerDocumentChangeListener

Returns: Result<Tagged<'ListenerToken'>>


deleteDocument(...)

deleteDocument(options: DatabaseRefOptions & { id: string; }) => Result<void>
ParamType
optionsDatabaseRefOptions & { id: string; }

Returns: Result<void>


documentExists(...)

documentExists(options: DatabaseRefOptions & { id: string; }) => Result<boolean>
ParamType
optionsDatabaseRefOptions & { id: string; }

Returns: Result<boolean>


getDocument(...)

getDocument<T = object>(options: DatabaseRefOptions & { id: string; }) => Result<T | undefined>
ParamType
optionsDatabaseRefOptions & { id: string; }

Returns: Result<T>


saveDocument(...)

saveDocument<T = object>(options: DatabaseRefOptions & { id: string; value: T; }) => Result<void>
ParamType
optionsDatabaseRefOptions & { id: string; value: T; }

Returns: Result<void>


createQuery(...)

createQuery<T = unknown, P = Record<string, string>>(options: DatabaseRefOptions & { query: string; }) => Result<QueryRef<T, P>>
ParamType
optionsDatabaseRefOptions & { query: string; }

Returns: Result<QueryRef<T, P>>


addQueryChangeListener(...)

addQueryChangeListener<T = unknown, P = Record<string, string>>(options: QueryRefOptions<T, P>, handler: QueryChangeListener<T>) => Result<ListenerToken>
ParamType
optionsQueryRefOptions<T, P>
handlerQueryChangeListener<T>

Returns: Result<Tagged<'ListenerToken'>>


executeQuery(...)

executeQuery<T = unknown, P = Record<string, string>>(options: QueryRefOptions<T, P>) => Result<T[]>
ParamType
optionsQueryRefOptions<T, P>

Returns: Result<T[]>


explainQuery(...)

explainQuery<T = unknown, P = Record<string, string>>(options: QueryRefOptions<T, P>) => Result<string>
ParamType
optionsQueryRefOptions<T, P>

Returns: Result<string>


getQueryParameters(...)

getQueryParameters<T = unknown, P = Record<string, string>>(options: QueryRefOptions<T, P>) => Result<Partial<P>>
ParamType
optionsQueryRefOptions<T, P>

Returns: Result<Partial<P>>


removeQueryChangeListener(...)

removeQueryChangeListener(options: { token: ListenerToken; }) => Result<void>
ParamType
options{ token: Tagged<'ListenerToken'>; }

Returns: Result<void>


setQueryParameters(...)

setQueryParameters<T = unknown, P = Record<string, string>>(options: QueryRefOptions<T, P> & { parameters: Partial<P>; }) => Result<void>
ParamType
optionsQueryRefOptions<T, P> & { parameters: Partial<P>; }

Returns: Result<void>


addDocumentReplicationListener(...)

addDocumentReplicationListener(options: ReplicatorRefOptions, handler: DocumentReplicationListener) => Result<ListenerToken>
ParamType
optionsReplicatorRefOptions
handlerDocumentReplicationListener

Returns: Result<Tagged<'ListenerToken'>>


addReplicatorChangeListener(...)

addReplicatorChangeListener(options: ReplicatorRefOptions, handler: ReplicatorChangeListener) => Result<ListenerToken>
ParamType
optionsReplicatorRefOptions
handlerReplicatorChangeListener

Returns: Result<Tagged<'ListenerToken'>>


createReplicator(...)

createReplicator(options: { config: ReplicatorConfiguration; }) => Result<ReplicatorRef>
ParamType
options{ config: ReplicatorConfiguration; }

Returns: Result<Tagged<'Replicator'>>


documentsPendingReplication(...)

documentsPendingReplication(options: ReplicatorRefOptions) => Result<string[]>
ParamType
optionsReplicatorRefOptions

Returns: Result<string[]>


isDocumentPendingReplication(...)

isDocumentPendingReplication(options: ReplicatorRefOptions & { documentID: string; }) => Result<boolean>
ParamType
optionsReplicatorRefOptions & { documentID: string; }

Returns: Result<boolean>


removeReplicatorListener(...)

removeReplicatorListener(options: { token: ListenerToken; }) => Result<void>
ParamType
options{ token: Tagged<'ListenerToken'>; }

Returns: Result<void>


replicatorConfiguration(...)

replicatorConfiguration(options: ReplicatorRefOptions) => Result<ReplicatorConfiguration>
ParamType
optionsReplicatorRefOptions

Returns: Result<ReplicatorConfiguration>


replicatorStatus(...)

replicatorStatus(options: ReplicatorRefOptions) => Result<ReplicatorStatus>
ParamType
optionsReplicatorRefOptions

Returns: Result<ReplicatorStatus>


setHostReachable(...)

setHostReachable(options: ReplicatorRefOptions & { reachable: boolean; }) => Result<void>
ParamType
optionsReplicatorRefOptions & { reachable: boolean; }

Returns: Result<void>


startReplicator(...)

startReplicator(options: ReplicatorRefOptions & { resetCheckpoint?: boolean; }) => Result<void>
ParamType
optionsReplicatorRefOptions & { resetCheckpoint?: boolean; }

Returns: Result<void>


stopReplicator(...)

stopReplicator(options: ReplicatorRefOptions) => Result<void>
ParamType
optionsReplicatorRefOptions

Returns: Result<void>


blobProperties(...)

blobProperties(options: BlobOptions) => Result<BlobMetadata>
ParamType
optionsBlobOptions

Returns: Result<BlobMetadata>


databaseGetBlob(...)

databaseGetBlob(options: { database: DatabaseRef; properties: BlobMetadata; }) => Result<string>
ParamType
options{ database: Tagged<'Database'>; properties: BlobMetadata; }

Returns: Result<string>


databaseSaveBlob(...)

databaseSaveBlob(options: BlobOptions & { database: DatabaseRef; }) => Result<void>
ParamType
optionsBlobOptions & { database: Tagged<'Database'>; }

Returns: Result<void>


documentGetBlob(...)

documentGetBlob(options: DatabaseRefOptions & { id: string; property: string; }) => Result<string>
ParamType
optionsDatabaseRefOptions & { id: string; property: string; }

Returns: Result<string>


documentGetBlobProperties(...)

documentGetBlobProperties(options: DatabaseRefOptions & { id: string; property: string; }) => Result<BlobMetadata>
ParamType
optionsDatabaseRefOptions & { id: string; property: string; }

Returns: Result<BlobMetadata>


documentIsBlob(...)

documentIsBlob(options: DatabaseRefOptions & { id: string; property: string; }) => Result<boolean>
ParamType
optionsDatabaseRefOptions & { id: string; property: string; }

Returns: Result<boolean>


documentSaveBlob(...)

documentSaveBlob(options: DatabaseRefOptions & BlobOptions & { id: string; property: string; }) => Result<void>
ParamType
optionsDatabaseRefOptions & BlobOptions & { id: string; property: string; }

Returns: Result<void>


Interfaces

DatabaseRefOptions

PropType
databaseDatabaseRef

QueryRefOptions

PropType
queryQueryRef<T, P>

ReplicatorRefOptions

PropType
replicatorReplicatorRef

ReplicatorStatus

PropType
activity'stopped' | 'offline' | 'connecting' | 'idle' | 'busy'
errorstring
progress{ complete: number; documentCount: number; }

ReplicatorConfiguration

PropType
databaseDatabaseRef
endpointstring | Tagged<'Database'>
authenticator{ type: 'basic'; username: string; password: string; } | { type: 'session'; sessionID: string; cookieName?: string; }
replicatorTypeReplicatorType
continuousboolean
disableAutoPurgeboolean
maxAttemptsnumber
maxAttemptWaitTimenumber
heartbeatnumber
conflictResolver((document: { documentID: string; localDocument: object; remoteDocument: object; }) => void)
pushFilter((document: { documentID: string; value: object; accessRemoved: boolean; deleted: boolean; }) => void)
pullFilter((document: { documentID: string; value: object; accessRemoved: boolean; deleted: boolean; }) => void)

BlobMetadata

PropType
'@type''blob'
content_typestring
digeststring
lengthnumber

BlobOptions

PropType
blobBlobConfig

Type Aliases

Result

Promise<T extends void ? void : { value: T }>

DatabaseRef

Opaque<unknown, 'Database'>

Opaque

Create an opaque type, which hides its internal details from the public, and can only be created by being used explicitly.

The generic type parameter can be anything. It doesn't have to be an object.

Read more about opaque types.

There have been several discussions about adding this feature to TypeScript via the opaque type operator, similar to how Flow does it. Unfortunately, nothing has (yet) moved forward:

Type & Tagged<Token>

Tagged

{ readonly tag: Token; }

DatabaseChangeListener

(docIDs: string[]): void

ListenerToken

Opaque<unknown, 'ListenerToken'>

DocumentChangeListener

(docID: string): void

QueryRef

Opaque<{ readonly resultType: Result; readonly parametersType: Parameters; }, 'Query'>

Parameters

Obtain the parameters of a function type in a tuple

T extends (...args: infer P) => any ? P : never

Record

Construct a type with a set of properties K of type T

{

}

QueryChangeListener

(results: T[]): void

Partial

Make all properties in T optional

{ P in keyof T?: TP; }

ReplicatorRef

Opaque<unknown, 'Replicator'>

DocumentReplicationListener

(direction: "push" | "pull", documents: ReplicatedDocInfo[]): void

ReplicatedDocInfo

{ id: string; accessRemoved: boolean; deleted: boolean; error?: string; }

ReplicatorChangeListener

(status: ReplicatorStatus): void

ReplicatorType

'pushAndPull' | 'push' | 'pull'

BlobConfig

{ data: Buffer; contentType?: string; }

0.2.7

1 year ago

0.2.6

2 years ago

0.2.5

2 years ago

0.2.3

2 years ago

0.2.2

2 years ago

0.2.1

2 years ago

0.2.0

2 years ago