SDK Reference

The FusionLayer SDK provides a stable, typed client for authentication, capture, and recall. Use it when you want portable artifacts and privacy modes without hand-rolling HTTP.

API reference All docs

Install

npm install @fusionlayer/sdk

API Key Auth (Server-Side)

For services and backends, API keys keep auth simple and avoid browser-only cookie flows.

import { FusionLayerClient } from '@fusionlayer/sdk'

const fl = new FusionLayerClient({
  apiKey: process.env.FL_API_KEY,
  baseUrl: 'https://api.fusionlayer.app', // optional
})

const ctx = await fl.recallContext({ query: 'recent work on auth module' })
console.log(ctx.entries)

Session Auth (Browser / Client-Side)

import { Auth, FusionLayerClient, InMemoryTokenStore } from '@fusionlayer/sdk'

const auth = new Auth(new InMemoryTokenStore())
const fl = new FusionLayerClient({ baseUrl: 'https://api.fusionlayer.app' }, auth)

const { accessToken, refreshToken } = await fl.login({
  email: '[email protected]',
  password: 'your-password',
})
await auth.setTokens({ accessToken, refreshToken })

Capture

Capture is exposed as a focused subpath so it can be used independently of the full client.

import { captureEvent } from '@fusionlayer/sdk/capture'

await captureEvent(
  {
    vendor: 'cursor',
    client: 'my-app',
    payload_kind: 'prompt',
    payload: 'Explain the auth flow',
    mode: 'smart',
  },
  { apiKey: process.env.FL_API_KEY },
)

Privacy Mode Helpers

import { getMode, setMode } from '@fusionlayer/sdk/prefs'

setMode('private')
setMode('incognito')
setMode('smart')
console.log(getMode())

Exports

Import Contents
@fusionlayer/sdk Auth, FusionLayerClient, token stores, errors, and types
@fusionlayer/sdk/capture captureEvent, CaptureEnvelope, CaptureOptions, CaptureMode
@fusionlayer/sdk/prefs getMode, setMode