npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@robono/client

v0.6.2

Published

Headless client core for Robono-connected web and mobile apps.

Readme

@robono/client

Headless client core shared by the Robono Web and React Native SDKs. It keeps Robono server credentials out of browsers and phones while providing Bridge calls, push-triggered synchronization, polling recovery, state subscriptions, and delivery diagnostics.

License

Licensed for authorized Robono integrations. Redistribution as a standalone SDK, bypassing Robono, and competing bridge services are prohibited. See the included LICENSE and license FAQ.

Most applications should install @robono/web or @robono/react-native. Install this package directly only when building another platform wrapper:

This package is ESM-only. CommonJS applications must load it with await import("@robono/client").

npm install @robono/client

The package includes TypeScript declarations and SBOM.spdx.json.

import {
  createRobonoHttpTransport,
  RobonoClient,
} from "@robono/client";

const client = new RobonoClient({
  externalUserId: signedInUser.id,
  transport: createRobonoHttpTransport({
    baseUrl: "https://your-app.example",
    getAccessToken: () => yourAuth.getAccessToken(),
    language: signedInUser.language,
  }),
});

const unsubscribe = client.subscribe(state => {
  renderWithYourExistingScreens(state);
  console.log(state.diagnostics.lastUpdateVia);
});

try {
  await client.start();
} catch (error) {
  // Initial authentication, CORS, and configuration failures reject.
  showBridgeUnavailable(error);
}

The language is a BCP 47 value such as es. Override it per operation with the final option { language: signedInUser.language }. Display error.userMessage?.localized_message for user-safe failures and record.status_message?.localized_message for returned statuses; use stable codes for logic and technical messages only for logs. After sign-in and whenever the participant changes language, call client.preferences.updateLanguage(signedInUser.language) once. The preference belongs to this connected app and signed-in participant, not to a connection or guardian. This preference localizes Robono-generated user notices; it does not translate chat content or developer diagnostics.

Machine-readable prices are available through client.pricing.get(). The call uses your authenticated /robono/pricing backend adapter so Robono credentials stay off the device. Pass a catalog version to retrieve the immutable snapshot named by a backend-verified pricing.updated event. Check each rate's billing_model: SMS invitation overage uses actual aggregate Telnyx cost with no markup rather than a fixed per-country or worldwide price.

For a delayed event, use its stable code and parameters, then call client.userMessages.localize({ code, parameters, language: viewer.language }) separately for each child or guardian viewer. Push contains identifiers only; synchronize records before creating visible notification text. The language catalog identifies which languages support notices, translation, transcription, and speech output. Fallback is full locale, recognized script, base language, then English.

networks.list() returns the available endpoints and the identifier each one requires. The unified connections methods connect, list every page, update, and disconnect either endpoint type. The unified messages methods send, list, and mark messages delivered, read, or heard. The synchronized state.connections and state.messagesByConnection collections use the same normalized shape for every endpoint.

When a user ends a friendship, call connections.disconnect(...). For a disconnected connection, preserve history and remove sending, reply, and quote controls. Requesting the same endpoint and identifier again creates a reconnect request; keep communication disabled until the connection becomes active or accepted. The connection lifecycle covers both the initiating and receiving endpoint.

Call networks.refresh() when opening Add Friend. The client also refreshes the directory after its five-minute TTL and when it receives bridge.directory_changed.

Pass verified Robono push data to client.receivePush(data) for immediate synchronization. Recovery polling defaults to about 60 seconds with jitter, backs off after failures, and can be disabled with pollingEnabled: false when another reliable recovery signal exists. Call client.stop() and unsubscribe() when the owning lifecycle ends.

Optional language and speech operations are typed and available through the protected backend route. See the developer guide.

Use connections.listPage({ limit, cursor }) when rendering one page. Use connections.listAll({ pageSize, maxItems }) for a bounded full refresh and check its truncated result before treating it as complete. connections.list() is retained as the convenience full-list form.

Every client write accepts { idempotencyKey, requestId, signal, retries } as its final argument. The HTTP transport retries transient failures at most twice by default and reuses one key within that call. Persist your own stable key and reuse it across later retries, jobs, restarts, or devices.

For media composed as one message, give each item the same attachment_batch.id, its zero-based index, and the common count. The negotiated attachment limit is validated before the request.

Guardian messaging uses the same authenticated client. Your backend must authorize guardian operations independently from ordinary chat.

Subscribed state is temporary synchronization state, not your permanent database. Persist signed events and required records in your existing backend. That backend must authenticate the user and authorize every operation.

The package is ESM-only, requires fetch, and includes TypeScript declarations. This is an early-access 0.x package: patch releases are compatible fixes, while a minor release before 1.0 may include a documented breaking change. Use a currently supported release. A fixed maintenance period for older releases requires a signed customer agreement. Read the packaged CHANGELOG.md before upgrading and report SDK problems at robono.com/contact?topic=sdk.

Full documentation is at robono.com/docs.