goyacodedevutils-yaerrors

name	goyacodedevutils-yaerrors
description	Structured error type with an HTTP-style status code and wrap-chain traceback. The standard error return type across GoYaCodeDevUtils and YaCodeDev services — use instead of the builtin error/fmt.Errorf for anything non-trivial.

yaerrors Skill

Import path: github.com/YaCodeDev/GoYaCodeDevUtils/yaerrors.

Custom structured error type carrying an HTTP-style status code and a wrap-chain traceback. Used as the standard error return type across this entire ecosystem instead of the builtin error.

Key API

• Error interface — embeds error; adds Wrap(msg) Error, WrapWithLog(msg, log) Error, Code() int, Error() string, Unwrap() error, UnwrapLastError() string.
• FromError(code int, cause error, wrap string) Error — wrap an existing error with a code and message.
• FromErrorWithLog(code, cause, wrap, log) Error — same, and also logs.
• FromString(code int, msg string) Error — construct from a plain message, no underlying cause.
• FromStringWithLog(code, msg, log) Error — same, and also logs.
• var ErrTeapot — safety fallback (code = http.StatusTeapot) substituted when a nil *yaError is called.

Usage Notes

• Call Wrap(msg) at every layer as the error propagates up; each wrap prepends context to the traceback (msg -> msg -> code | original).
• Methods are nil-safe: calling them on a nil *yaError returns ErrTeapot instead of panicking — a bug marker, not a crash.
• *WithLog constructors/methods always log at Error level. For a 4xx or otherwise expected/transient error, prefer plain FromError/FromString/Wrap plus a separate classify-then-log step, so client/validation errors don't page maintenance at Error severity.
• No dependency on other repo packages except yalogger (only for the *WithLog variants); nearly every other package in this repo returns yaerrors.Error.