@clinkchat/stdio-rpc-server
v1.152.5
Published
This is the successor of `clinkchat-node`, it does not use NAPI bindings but instead uses stdio executables to let you talk to core over jsonrpc over stdio. This simplifies cross-compilation and even reduces binary size (no CFFI layer and no NAPI layer).
Downloads
153
Readme
npm package for clinkchat-rpc-server
This is the successor of clinkchat-node
,
it does not use NAPI bindings but instead uses stdio executables
to let you talk to core over jsonrpc over stdio.
This simplifies cross-compilation and even reduces binary size (no CFFI layer and no NAPI layer).
Usage
The minimum nodejs version for this package is
16
npm i @clinkchat/stdio-rpc-server @clinkchat/jsonrpc-client
import { startClinkChat } from "@clinkchat/stdio-rpc-server";
import { C } from "@clinkchat/jsonrpc-client";
async function main() {
const dc = await startClinkChat("clinkchat-data");
console.log(await dc.rpc.getSystemInfo());
dc.close()
}
main()
For a more complete example refer to https://github.com/vgisclabs-bot/echo/pull/69/files (TODO change link when pr is merged).
How to use on an unsupported platform
How does it work when you install it
NPM automatically installs platform dependent optional dependencies when os
and cpu
fields are set correctly.
references:
- https://napi.rs/docs/deep-dive/release#3-the-native-addon-for-different-platforms-is-distributed-through-different-npm-packages, webarchive version
- https://docs.npmjs.com/cli/v6/configuring-npm/package-json#cpu
- https://docs.npmjs.com/cli/v6/configuring-npm/package-json#os
When you import this package it searches for the rpc server in the following locations and order:
CLINK_CHAT_RPC_SERVER
environment variable- use the PATH when
{takeVersionFromPATH: true}
is supplied in the options. - prebuilds in npm packages
so by default it uses the prebuilds.
How do you built this package in CI
- To build platform packages, run the
build_platform_package.py
script:python3 build_platform_package.py <cargo-target> # example python3 build_platform_package.py x86_64-apple-darwin
- Then pass it as an artifact to the last CI action that publishes the main package.
- upload all packages from
clinkchat-rpc-server/npm-package/platform_package
. - then publish
clinkchat-rpc-server/npm-package
,- this will run
update_optional_dependencies_and_version.js
(in theprepack
script), which puts all platform packages intooptionalDependencies
and updates theversion
inpackage.json
- this will run
How to build a version you can use locally on your host machine for development
You can not install the npm packet from the previous section locally, unless you have a local npm registry set up where you upload it too. This is why we have separate scripts for making it work for local installation.
- If you just need your host platform run
python scripts/make_local_dev_version.py
- note: this clears the
platform_package
folder - (advanced) If you need more than one platform for local install you can just run
node scripts/update_optional_dependencies_and_version.js
after building multiple platforms withbuild_platform_package.py
Thanks to nlnet
The initial work on this package was funded by nlnet as part of the Clink Tauri Project.