Web SDK quickstart

The Web SDK creates and stores a visitorId. Your backend sends that ID and the conversation to Era with the Node SDK.

Install

npm install @seasonlabs/era-web

Create the browser client

import { EraWeb } from "@seasonlabs/era-web";

const eraWeb = new EraWeb({
  baseUrl: "https://your-era-endpoint.com",
  publishableKey: "your_publishable_key",
});

A publishable key is safe to include in browser code. Never include the secret Node SDK API key.

Initialize the visitor

const visitorId = await eraWeb.init();

The SDK reuses the same visitor across page loads when browser storage is available.

Send the visitor to your backend

await fetch("/api/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ messages, visitorId, sessionId }),
});

Your backend passes visitorId to the Node SDK:

const eraContext = await era.turnContext(messages, {
  visitorId,
  sessionId,
});

Treat visitorId as a continuity ID, not as proof that the user is signed in.

Use a CDN

CDN distribution is coming soon. For now, install @seasonlabs/era-web from npm and use the package import shown above.

Get started

Concepts

Reference

Web SDK quickstart

Use a CDN

Next steps

Identity lifecycle

Web SDK reference

​Use a CDN

​Next steps

Identity lifecycle

Web SDK reference

Use a CDN

Next steps