Claude Code. Any Model. The most powerful AI coding agent now speaks every language.
import { describe, expect, test } from "bun:test";
import { buildConnectionErrorMessage, classifyConnectionError } from "./connection-error.js";
describe("classifyConnectionError", () => {
test("classifies direct connection error codes", () => {
const cases = [
["ECONNREFUSED", "refused"],
["ENOTFOUND", "dns"],
["EAI_AGAIN", "dns"],
["ETIMEDOUT", "unreachable"],
["ECONNRESET", "unreachable"],
["ENETUNREACH", "unreachable"],
["EHOSTUNREACH", "unreachable"],
["ConnectionRefused", "refused"],
["ConnectionClosed", "unreachable"],
["FailedToOpenSocket", "unreachable"],
["ERR_SOCKET_CLOSED", "unreachable"],
] as const;
for (const [code, kind] of cases) {
expect(classifyConnectionError({ code })).toEqual({ kind, code });
}
});
test("walks an undici-style cause chain", () => {
const error = Object.assign(new TypeError("fetch failed"), {
cause: Object.assign(new Error("getaddrinfo ENOTFOUND host"), { code: "ENOTFOUND" }),
});
expect(classifyConnectionError(error)).toEqual({ kind: "dns", code: "ENOTFOUND" });
});
test("walks a deep two-level cause chain", () => {
const error = Object.assign(new TypeError("fetch failed"), {
cause: Object.assign(new Error("request failed"), {
cause: Object.assign(new Error("connect timed out"), { code: "ETIMEDOUT" }),
}),
});
expect(classifyConnectionError(error)).toEqual({
kind: "unreachable",
code: "ETIMEDOUT",
});
});
test("falls back to DNS wording when no code is present", () => {
const error = new Error("failed to lookup address information: nodename nor servname provided");
expect(classifyConnectionError(error)).toEqual({ kind: "dns", code: "ENOTFOUND" });
});
test("falls back to Bun's connection message when no code is present", () => {
const error = new Error("Unable to connect. Is the computer able to access the url?");
expect("code" in error).toBe(false);
expect(classifyConnectionError(error)).toEqual({
kind: "refused",
code: "ConnectionRefused",
});
});
test("returns null for non-connection errors", () => {
expect(classifyConnectionError({ code: "ERR_INVALID_ARG_TYPE" })).toBeNull();
expect(classifyConnectionError(new Error("ordinary failure"))).toBeNull();
expect(classifyConnectionError(undefined)).toBeNull();
});
test("stops walking a self-referential cause", () => {
const error = new Error("cyclic") as Error & { cause?: unknown };
error.cause = error;
expect(classifyConnectionError(error)).toBeNull();
});
});
describe("buildConnectionErrorMessage", () => {
test("builds an actionable DNS message from the endpoint host", () => {
const message = buildConnectionErrorMessage(
"dns",
"OpenAI Codex",
"https://chatgpt.com/backend-api/codex/responses"
);
expect(message).toContain("Cannot resolve");
expect(message).toContain("chatgpt.com");
expect(message).toContain("DNS");
expect(message).toContain("Tailscale");
expect(message).toContain("not OpenAI Codex");
});
test("tells users to start a refused loopback server", () => {
const loopbackEndpoints = [
"http://localhost:11434/v1/chat/completions",
"http://127.0.0.1:11434/v1/chat/completions",
"http://[::1]:11434/v1/chat/completions",
"http://0.0.0.0:11434/v1/chat/completions",
];
for (const endpoint of loopbackEndpoints) {
const message = buildConnectionErrorMessage("refused", "Local provider", endpoint);
expect(message).toContain("Make sure the server is running");
}
});
test("uses network and DNS guidance for a refused remote host", () => {
const message = buildConnectionErrorMessage(
"refused",
"OpenAI Codex",
"https://chatgpt.com/backend-api/codex/responses"
);
expect(message).not.toContain("Make sure the server is running");
expect(message).toContain("network");
expect(message).toContain("DNS");
expect(message).toContain("chatgpt.com");
});
test("builds an actionable unreachable-host message", () => {
const message = buildConnectionErrorMessage(
"unreachable",
"Remote provider",
"https://api.example.com/v1/messages"
);
expect(message).toContain("Check your network connection");
});
test("uses a non-URL endpoint verbatim", () => {
const message = buildConnectionErrorMessage("dns", "Provider", "not-a-url");
expect(message).toContain("not-a-url");
});
});