Function describeError

packages/plugin/src/shared/error-message.ts:46–107

(error: unknown)

}

export function describeError(error: unknown): ErrorDescription {
    const stringForm = clip(safeString(error), 400);

    if (!(error instanceof Error) && !(error && typeof error === "object")) {
        return {
            name: typeof error,
            message: "",
            stringForm,
            brief: stringForm || "<empty>",
        };
    }

    const obj = error as Record<string, unknown>;
    const nameFromField = readString(obj.name);
    const nameFromCtor = error?.constructor?.name;
    const name = nameFromField ?? nameFromCtor ?? "Error";

    const message = readString(obj.message) ?? "";
    const status = readString(obj.status) ?? readString(obj.statusCode);
    const code = readString(obj.code);

    let causeName: string | undefined;
    const cause = obj.cause;
    if (cause && typeof cause === "object") {
        const causeRecord = cause as Record<string, unknown>;
        causeName =
            readString(causeRecord.name) ??
            (cause as { constructor?: { name?: string } }).constructor?.name;
    }

    const stack = readString(obj.stack);
    const stackHead = stack
        ? stack
              .split("\n")
              .slice(0, 4)
              .map((l) => l.trim())
              .filter((l) => l.length > 0)
              .join(" | ")
        : undefined;

    const briefParts: string[] = [];
    if (name) briefParts.push(name);
    if (message) briefParts.push(`message="${clip(message, 200)}"`);
    if (status) briefParts.push(`status=${status}`);
    if (code) briefParts.push(`code=${code}`);
    if (causeName) briefParts.push(`cause=${causeName}`);
    if (!message && stringForm && stringForm !== name) {
        briefParts.push(`str="${clip(stringForm, 200)}"`);
    }
    const brief = briefParts.join(" ") || stringForm || name;

    return {
        name,
        message,
        ...(status ? { status } : {}),
        ...(code ? { code } : {}),
        ...(causeName ? { causeName } : {}),
        ...(stackHead ? { stackHead } : {}),