@pellux/goodvibes-transport-http

Public GoodVibes HTTP transport package for JSON requests, auth headers, retry/backoff, SSE streams, and contract route invocation.

Most applications should install @pellux/goodvibes-sdk and import @pellux/goodvibes-sdk/transport-http. Install this package directly when you only need the HTTP transport subset.

Key exports:

• Contract routes: invokeContractRoute, openContractRouteStream, requireContractRoute.
• HTTP transport: createHttpTransport, createFetch, requestJsonRaw, createJsonRequestInit, normalizeTransportError, readJsonBody.
• Idempotency: generateIdempotencyKey.
• Retry / backoff: DEFAULT_HTTP_RETRY_POLICY, resolveHttpRetryPolicy, normalizeHttpRetryPolicy, applyPerMethodPolicy, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal.
• Stream reconnect: DEFAULT_STREAM_RECONNECT_POLICY, normalizeStreamReconnectPolicy, getStreamReconnectDelay. Shares the same exponential-backoff shape as HTTP retry; transport-realtime's SSE and WebSocket connectors build on these.
• SSE streaming: openServerSentEventStream, openRawServerSentEventStream.
• Auth / headers: normalizeAuthToken, resolveAuthToken, resolveHeaders, mergeHeaders, mergeHeaderRecord.
• Paths: buildUrl, normalizeBaseUrl, createTransportPaths, isPrivateNetworkHost.
• Client plumbing: splitClientArgs, clientInputRecord, mergeClientInput, firstJsonSchemaFailure. Internal helpers generated method clients use to split positional input/options arguments and validate a response body against a JSON Schema; most consumers never call these directly.
• Middleware: TransportMiddleware / TransportContext types (compose chains with composeMiddleware from transport-core).

Use this surface when you need lower-level HTTP/SSE control or when you are building a custom GoodVibes client on top of the synced contracts.

import { createJsonRequestInit, requestJsonRaw } from '@pellux/goodvibes-sdk/transport-http';

const body = await requestJsonRaw(
  fetch,
  'http://127.0.0.1:3421/api/control-plane/auth',
  createJsonRequestInit(process.env.GOODVIBES_TOKEN ?? null),
);