martin/databag
1
0
Fork 0
mirror of https://github.com/balzack/databag.git synced 2025-05-04 15:35:16 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Pierre Balzack 2024-08-20 17:29:31 -07:00 committed by GitHub
parent cf2984eaca
commit baab6cab9f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 1 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
app/sdk/README.md
View File

@ -1,55 +1 @@
DatabagClientSDK provides an interface and implementation for the decentralized databag network. The SDK is written in pure typescript so it can be imported into a wide variety of applications. The project contains reference applications for react-js, react-native, and node. The platform specific implementations of storage and cryptography are defined externally and provided to the SDK through interfaces DatabagClientSDK provides a typescript interface for communication over the decentralized databag network. The SDK has minimal dependencies and contains reference applications for react-js, react-native, and node. [Click here for the API](/app/sdk/API.md)
### The SDK must first be allocated
```DatabacgClientSDK(crypto: Crypto | null, log?: Logging)```
### Persistent storage can then be provided to the SDK.
Mobile apps typically use the SqlStore interface allowing for offline use cases where most of the relational data is stored
```initOfflineStore(sql: SqlStore): Promise<Session | null>```
Browser apps typically use the WebStore interface where minimal session data is stored
```initOnlineStore(web: WebStore): Promise<Session | null>```
### Account communcation is provided through the Session interface
login provides a Session through an account login
```login(handle: string, password: string, node: string, secure: boolean, mfaCode: string | null, params: SessionParams): Promise<Session>```
access provides a Session through token access to an account when password is forgotten
```access(node: string, secure: boolean, token: string, params: SessionParams): Promise<Session>```
create provides a Session to a newly created account
```create(handle: string, password: string, node: string, secure: boolean, token: string | null, params: SessionParams): Promise<Session>```
available returns the number of accounts that can be publically created
```available(node: string, secure: boolean): Promise<number>```
username returns whether the username is available for account creation
```username(name: string, token: string, node: string, secure: boolean): Promise<boolean>```
logout releases the Session interface
```logout(session: Session, all: boolean): Promise<void>```
### Admin communcation is provided through the Node interface
configure allocates the Node interface for the server
```configure(node: string, secure: boolean, token: string, mfaCode: string | null): Promise<Node>```
### Bot communication is provided through the Bot interface
automate allocates the Bot interface for ia specific communication channel
```automate(node: string, secure: boolean, token: string): Promise<Bot>```