platform/plugins/client-resources/readme.md
Andrey Sobolev 5b6ef778f3
Migrate to hcengineering and publish to github packages (#2273)
Signed-off-by: Andrey Sobolev <haiodo@gmail.com>
2022-09-21 14:08:25 +06:00

34 lines
836 B
Markdown

# Overview
Package allow to create a client to interact with running platform.
## Usage
```ts
import clientResources from '@hcengineering/client-resources'
import core, { Client } from '@hcengineering/core'
// ...
const token = ... // Token obtained somehow.
const connection: Client = await (await clientResources()).function.GetClient(token, transactorUrl)
// Now client is usable
// Use close, to shutdown connection.
await connection.close()
```
## Node JS
For NodeJS enviornment it is required to configure ClientSocketFactory using 'ws' package.
```ts
// We need to override default WebSocket factory with 'ws' one.
setMetadata(client.metadata.ClientSocketFactory, (url) => new WebSocket(url))
const connection: Client = await (await clientResources()).function.GetClient(token, transactorUrl)
...
```