Files
netrunner-landing/lib
nineap 0fa87e2d9a Фолбэк на кэш при недоступности PocketBase (Pricing/FAQ)
Pricing: при полном отказе всех запросов пробует localStorage-кэш
последнего успешного ответа вместо пустого состояния, пишет туда же при
успехе. Faq: отличает "в кэше правда пусто" от "не смогли загрузить" —
раньше оба случая показывали один и тот же текст "0 protocols found",
что вводило в заблуждение при обычном сетевом сбое.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-09 16:37:06 +07:00
..
2026-04-18 21:16:55 +10:00
2026-07-02 23:13:24 +07:00
2026-04-17 14:54:33 +07:00

lib/ — общие модули и утилиты

pb.ts

Синглтон-клиент PocketBase (headless CMS проекта) и типы для его коллекций. Различает серверный и клиентский URL: на сервере (SSR/ISR) используется PB_INTERNAL_URL — внутренний адрес PocketBase в докер-сети, в браузере — публичный NEXT_PUBLIC_PB_URL. На сервере дополнительно отключена автоотмена запросов (pb.autoCancellation(false)), т.к. PocketBase SDK по умолчанию отменяет параллельные одинаковые запросы, что ломает параллельный SSR/ISR-рендеринг разных страниц. В браузере глушится специфичная ошибка "the request was autocancelled" в консоли, чтобы не пугать разработчика ложным шумом. Экспортирует типы записей (PBPost, PBFaq, PBDownload) и хелперы getPbImage/getPbFileUrl для сборки прямых URL на файлы, хранящиеся в PocketBase. Используй этот модуль в любом месте, где нужно прочитать данные из CMS (посты, FAQ, тарифы, платформы загрузки, комментарии гостевой книги, документы).

dictionaries.ts

Динамическая загрузка JSON-словарей dictionaries/en.json / dictionaries/ru.json по коду локали через getDictionary(locale), с фоллбеком на en, если локаль не распознана. Помечен import "server-only" — импортировать его можно только из серверных компонентов (page.tsx, layout.tsx); это специально предотвращает попадание словарей целиком в клиентский JS-бандл. Клиентские компоненты получают уже нужный кусок словаря как проп (dict={dict.hero} и т.п.), а не читают его сами.

IDict.ts

TypeScript-интерфейс Dictionary, описывающий форму JSON-словарей (секции nav, hero, features, pricing, faq, blog, footer, download, terminal, loading, notFound, nodes, guestbook, auth, docs, speedtest). Используй его для типизации пропа dict в любом компоненте, который получает переведённые строки, — и для проверки, что en.json/ru.json синхронизированы между собой по набору ключей.

document.ts

Интерфейс PBDocument для коллекции документов раздела /docs ("хранилища" документации в хакерском стиле): категории Core/Security/Network/Legal/All и статусы Encrypted/Public/Dynamic/Internal, которые определяют бейдж и цвет карточки документа в docs-client.tsx.

utils.ts

Единственный хелпер cn() — объединение классов Tailwind с учётом конфликтов (clsx + tailwind-merge), стандартный паттерн из shadcn/ui. Используй его вместо шаблонных строк везде, где className собирается условно (например, cn(base, isActive && "text-primary")).