Outbound HTTP

One call to a vendor: outbound() from @ultimat3/core/outbound. A server fetch( with no signal is a build error in a scaffolded app (the raw-fetch guard, boundaries step) and in this repository (bun run fetch-deadline, X_FETCH_UNBOUNDED). A subpath, never the barrel: core is in every bundle graph and the dial screen reads Bun.dns.

import { outbound } from '@ultimat3/core/outbound';
import { t } from '@ultimat3/schema';

const Charge = t.object({ id: t.string, status: t.string });

export async function chargeStatus(id: string): Promise<{ id: string; status: string }> {
  const answer = await outbound({
    url: `https://api.vendor.example/v1/charges/${encodeURIComponent(id)}`,
    vendor: 'vendor',
    dial: 'named',
    deadlineMs: 10_000,
    headers: { authorization: 'Bearer <token>' },
  });
  return answer.json(Charge);
}

What every call gets

dial: which network a URL may reach

Required, a decision per call.

screenDial(url, { resolve, allowPrivate }) is the screen alone, for a transport that keeps its own codes: @ultimat3/jobs' webhook target and @ultimat3/scraping's wildcard leg call it.

Failures

A 401 is X_OUTBOUND_REFUSED with meta.status: 401. There is no refresh hook: the app's own wrapper refreshes its token and calls again. Token storage and single-flight stay the app's.

breaker(): stop paying for a dependency that is down

import { breaker } from '@ultimat3/core';
import { outbound } from '@ultimat3/core/outbound';

const vendorGate = breaker({ name: 'vendor', failures: 5, cooldownMs: 30_000 });

export const ping = () =>
  outbound({
    url: 'https://api.vendor.example/v1/ping',
    vendor: 'vendor',
    dial: 'named',
    deadlineMs: 5_000,
    breaker: vendorGate,
  });

Manual use: const ticket = gate.admit(), then succeeded(ticket), failed(ticket) or released(ticket); or run(fn) for all three. state() never consumes a probe.

Stays raw, on purpose