@triggery/devtools-bridge

Page-side bridge that makes a Triggery runtime observable to external tools — the Chrome extension, a future standalone web panel, custom inspectors, anything that can listen to window.postMessage. Framework-agnostic, zero runtime dependencies, returns a no-op in Node / SSR.

Install

pnpm

pnpm add @triggery/core @triggery/devtools-bridge

npm

npm install @triggery/core @triggery/devtools-bridge

yarn

yarn add @triggery/core @triggery/devtools-bridge

bun

bun add @triggery/core @triggery/devtools-bridge

Peer deps: @triggery/core.

What’s inside

Export	Purpose
installDevtoolsBridge(runtime)	Attach the page-side bridge to a runtime. Returns a dispose() callback.

Quick example

import { createRuntime } from '@triggery/core';
import { installDevtoolsBridge } from '@triggery/devtools-bridge';

const runtime = createRuntime();

if (import.meta.env.DEV) {
  installDevtoolsBridge(runtime);
}

That’s it. The bridge:

1. Exposes a discovery handle on window.__triggery_devtools__ so tools can detect the runtime.
2. Broadcasts a triggery:hello postMessage with the current graph() + inspector buffer.
3. Subscribes to the runtime and broadcasts a triggery:snapshot for every new run.
4. On dispose(), removes the discovery handle and broadcasts a triggery:bye.

In Node / SSR installDevtoolsBridge returns a no-op disposer.

Wire format

{ source: 'triggery-devtools', type: 'triggery:hello',    runtimeId, graph, buffer, at }
{ source: 'triggery-devtools', type: 'triggery:snapshot', runtimeId, snapshot,     at }
{ source: 'triggery-devtools', type: 'triggery:bye',      runtimeId,               at }

Related packages

@triggery/core The runtime this bridge attaches to.

@triggery/devtools-panel In-app inspector React components.

@triggery/devtools-redux Stream runtime events into the Redux DevTools extension.

Source

• GitHub
• npm
• Changelog