Use it in your app

The CLI builds and ships the SDK. Your application is what actually calls it. This page gets the package installed and a client running; run an operation is the call itself. The package is an ordinary npm or pip package. There is no Fused runtime to deploy alongside it; it opens one gRPC connection to your Engine and that is the whole dependency.

Install it

sdk apply --download extracts the package to fused-sdks/<name>. It is not published anywhere, so install it from that path.

cd fused-sdks/support-sdk
npm install && npm run build

cd ../../
npm install ./fused-sdks/support-sdk

pip install ./fused-sdks/support-sdk

Vendor it, or publish it to your own private registry — the generated package.json and pyproject.toml carry the name you gave the SDK.

Create the client

One client, one gRPC channel, shared by every service on it.

import { FusedSDK } from 'support-sdk';

const sdk = new FusedSDK({
  grpcUrl: process.env.FUSED_ENGINE_GRPC_URL,
  token: process.env.FUSED_SDK_TOKEN!,
});

import os
from fused.support_sdk import FusedSDK

sdk = FusedSDK({
    "grpc_url": os.environ["FUSED_ENGINE_GRPC_URL"],
    "token": os.environ["FUSED_SDK_TOKEN"],
})

token is the execution token from apply. grpcUrl is optional — it falls back to FUSED_ENGINE_GRPC_URL, then FUSED_ENGINE_URL, then localhost. Set it explicitly; the fallback has a trap.

Shut it down

The channel is long-lived, so close it when your process does.

process.on('SIGTERM', () => sdk.close());

async with FusedSDK(config) as sdk:
    ...

# or explicitly
await sdk.close()

Run an operation

The call itself: what you pass, what comes back, and what can go wrong.

Receive events

The other half of your application code: reacting to what the provider sends you.

Get Started

Guides

Reference

Use it in your app

Install it

Create the client

Shut it down

Run an operation

Receive events

​Install it

​Create the client

​Shut it down

Run an operation

Receive events

Install it

Create the client

Shut it down