goyacodedevutils-catalog

name	goyacodedevutils-catalog
description	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.

GoYaCodeDevUtils Catalog

Use this skill first whenever you need infrastructure/utility functionality: config loading, errors, logging, caching, rate limiting, retries, hashing, compression, encryption, feature flags, state machines, thread-safe collections, i18n, or a Telegram bot. Using an existing GoYaCodeDevUtils package is mandatory wherever one covers the need; do not hand-roll an equivalent.

Import path prefix: github.com/YaCodeDev/GoYaCodeDevUtils/<package>.

Foundation

• yaerrors — structured error type with an HTTP-style code and wrap-chain traceback; the standard error return type across every package here. Skill: goyacodedevutils-yaerrors.
• yalogger — structured logrus-backed Logger interface threaded through nearly every package. Skill: goyacodedevutils-yalogger.
• config — loads env vars (plus .env and .yatools/<name>.json overlays) directly into typed structs via reflection. Skill: goyacodedevutils-config.
• valueparser — generic string-to-typed-value parsing (scalars, arrays, maps, custom Unmarshalable/TextUnmarshaler types); powers config. Skill: goyacodedevutils-valueparser.

Data structures & caching

• threadsafemap — generic mutex-protected map[K]V. Skill: goyacodedevutils-threadsafemap.
• yathreadsafeset — generic mutex-protected set with union/difference/intersect. Skill: goyacodedevutils-yathreadsafeset.
• yacache — pluggable key-value cache (in-memory or Redis backend) with a hash-oriented API. Skill: goyacodedevutils-yacache.
• yafsm — finite-state-machine storage on top of yacache, keyed per-entity. Skill: goyacodedevutils-yafsm.
• yaratelimit — fixed-window rate limiter on top of yacache. Skill: goyacodedevutils-yaratelimit.

Bit flags & retries

• yaautoflags — packs a struct's bool fields into/out of a single integer Flags field. Skill: goyacodedevutils-yaautoflags.
• yaflags — packs/unpacks raw bit-index lists into/from an unsigned integer. Skill: goyacodedevutils-yaflags.
• yabackoff — exponential back-off strategy for retry loops. Skill: goyacodedevutils-yabackoff.

Encoding, hashing & security

• yaencoding — Gob/MessagePack encode-decode plus base64 helpers. Skill: goyacodedevutils-yaencoding.
• yagzip — gzip compress/decompress with a decompression-size cap. Skill: goyacodedevutils-yagzip.
• yahash — salted, time-windowed hashing (e.g. short-lived tokens) around any hash function. Skill: goyacodedevutils-yahash.
• yarsa — deterministic RSA key generation, flexible key parsing, chunked RSA-OAEP encrypt/decrypt. Skill: goyacodedevutils-yarsa.
• yaginmiddleware — Gin middleware that encrypts a typed struct into an HTTP header (RSA-OAEP + gzip + MessagePack + base64), built on yarsa/yagzip/yaencoding. Skill: goyacodedevutils-yaginmiddleware.

Localization

• yalocales — loads JSON locale files into a lookup/format tree with strict cross-language key consistency, plus Go codegen. Skill: goyacodedevutils-yalocales.

Telegram bot stack

• yatgbot — high-level Telegram bot framework (router, filters, middleware, FSM-aware routing, per-user locale, message queue); composes most of the packages above. Skill: goyacodedevutils-yatgbot.
• yatgclient — gotd/td client wrapper: background-connect-with-retry, bot auth, updates-manager wiring, SOCKS5/MTProto proxy helpers. Skill: goyacodedevutils-yatgclient.
• yatgstorage — Redis-backed updates.Manager state storage plus AES/GORM session storage for the client auth key. Skill: goyacodedevutils-yatgstorage.
• yatgmessageencoding — converts a custom Markdown-like syntax to/from Telegram rich-text entities (UTF-16LE offsets). Skill: goyacodedevutils-yatgmessageencoding.

Fx wiring

Optional, additive go.uber.org/fx modules exist in each package's own fx.go for yalogger, yagzip, yabackoff, yatgmessageencoding, yalocales, yacache, yatgstorage, yatgclient, and yatgbot — consuming services can wire these via Fx instead of manual construction. Packages left out are generic over a caller-specific type parameter (threadsafemap, yathreadsafeset, yahash, yaratelimit, yafsm, yaginmiddleware, config) or are pure helper-function packages with nothing constructible (yaerrors, yaencoding, yaflags, yaautoflags, yarsa, valueparser) — see each package's own skill for its module name(s).

Choosing a package

• Need a typed config from env vars? config (with optional .yatools/<name>.json overlay support).
• Need to return or propagate an error with an HTTP-style code? yaerrors — never the builtin error for anything non-trivial.
• Need a cache, and maybe rate limiting or a state machine on top of it? yacache, then yaratelimit/yafsm.
• Need retries with backoff? yabackoff, not a hand-rolled sleep loop.
• Need to send an encrypted struct over an HTTP header? yaginmiddleware (already wires yarsa + yagzip + yaencoding).
• Building a Telegram bot? Start from yatgbot; only reach for yatgclient/yatgstorage/yatgmessageencoding directly for lower-level control.
• Something not listed here but still infrastructure-shaped (env config, caching, retries, hashing, encryption, i18n, bit flags, thread-safe collections)? Re-check this catalog before adding a new dependency or hand-rolling it.