메뉴
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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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. |
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.
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.Wrap(msg) at every layer as the error propagates up; each wrap prepends context to the traceback (msg -> msg -> code | original).*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.yalogger (only for the *WithLog variants); nearly every other package in this repo returns yaerrors.Error.Index of every GoYaCodeDevUtils utility package (config, errors, logging, caching, rate limiting, backoff, hashing, gzip, RSA, feature flags, FSM, thread-safe collections, locales, Telegram bot stack) with a pointer to each package's own skill. Use before hand-rolling infrastructure code GoYaCodeDevUtils may already provide.
High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot.
Thin wrapper around gotd/td's telegram.Client adding background-connect-with-retry, bot-token authorization, updates.Manager wiring, and SOCKS5/MTProto proxy helpers. Use for direct low-level Telegram client control instead of raw gotd/td.
Redis-backed persistence for gotd/td's updates.Manager state (pts/qts/seq/date via RedisJSON) plus channel/user access-hash bookkeeping, and a GORM/AES-encrypted session-storage layer. Use for any yatgclient/yatgbot state or session persistence.
Generic pluggable key-value cache abstraction with interchangeable in-memory and Redis backends, hash-oriented API. Use for any caching/session-store need instead of hand-rolling a map or a bare redis.Client call.
Loads JSON locale files into a nested key-tree with lookup, {placeholder} formatting, JSON serving, language-tag normalization, and Go-struct codegen. Use for any i18n/localization instead of hand-rolled JSON locale loading.