Devframe

DF0033: Dev RPC Bridge Failed to Start

Failed to start dev RPC bridge for "{id}": {reason}

Message

Failed to start dev RPC bridge for "{id}": {reason}

Cause

devframeViteBridge() (from @devframes/vite) could not bring up the bridge dev server that pairs a host-served SPA with devframe's RPC backend, usually because the preferred port is taken with no fallback range, or def.setup(ctx) threw. The surrounding Vite dev server keeps running, but the SPA's __connection.json lookup fails until the bridge starts.

Fix

  • Pin a port via cli.port / cli.portRange on the definition, or port on devframeViteBridge.
  • Inspect reason (or the attached cause) to fix the setup function or free the port.

Source

  • packages/vite/src/index.ts: devframeViteBridge() logs DF0033 when port resolution or createDevServer throws during configureServer.

DF0032: Streaming Channel Already Registered

Streaming channel "{channel}" is already registered.

DF0034: Already-Namespaced Scoped Registration

Scoped RPC registration for namespace "{namespace}" received an already-namespaced function name "{name}".