splash / bridge-bundle

3.0.x-dev 2026-09-11 14:48 UTC

Requires

• php: ^8.1
• ext-pcntl: *
• ext-posix: *
• splash/php-bundle: ^3.0
• webmozart/assert: ^1.0

Requires (Dev)

• badpixxel/php-sdk: ^3.0
• splash/bridge-builder: ^3.0
• splash/faker: ^3.0
• splash/toolkit: ^3.0

MIT

• Splash Sync
• Bernard Paquier

Published on Packagist.org on 2026-09-11 12:48 UTC

README

Splash Bridge Bundle

Host side of the Splash Bridge: loads connectors compiled as isolated standalone workers (.splx binaries, .phar archives or build directories) by Bridge Builder, registers each of them as a regular Splash connector named <version>@<name>, and drives it over JSON-RPC in its own process.

Zero dependency conflicts between connectors, zero PHP requirement on the target for .splx workers, and reverse callbacks (files, commits, configuration updates) so the isolated worker still talks to the host.

composer require splash/bridge-bundle

Documentation

• Overview — registry, manifest, bridged connector, transports, callbacks
• Configuration — splash_bridges:, bridges directory, workers environment
• Worker contract — protocol, HttpContext (no session), form whitelist, callbacks, checklist for connector authors

AI coding agents: see llms.txt, and the splash-connector skill (splash/skills).

Commands

Command	Purpose
splash:bridges:list	List the bridge connectors found in the registry
splash:bridges:stop	Gracefully stop running worker daemons (socket transport)

License

MIT - See LICENSE