nlcloud
Содержание

Начало работы

Установка

Для nlcloud нужен Node.js 20+. Добавьте библиотеку в проект:

npm install nlcloud

Первые шаги

Вот полная программа, которая использует nlcloud.

import { Client } from "nlcloud";

const client = new Client({
  path: "flags.yaml",
  reloadInterval: 10_000, // ms
});

const ok = await client.enabled("new-checkout", "u_1842");
console.log(ok);

const v = await client.variant("search-ranking", "u_1842");
console.log(v);

Файл флагов

Флаги объявляются в YAML- или JSON-файле. У каждого флага есть значение по умолчанию и упорядоченный список правил; значение определяет первое совпавшее правило.

Храните файл в репозитории и выкатывайте вместе с кодом или укажите nlcloud путь, который обновляет другой процесс.

Вычисление флагов

Передайте имя флага, контекст вычисления и значение по умолчанию. Контекст несёт атрибуты, по которым срабатывают правила, например id пользователя.

Вычисление никогда не падает. Неизвестные флаги и несовпадение типов возвращают значение по умолчанию и сообщаются через хук ошибок.

Раскатки

Процентное правило хэширует имя флага и стабильный атрибут, обычно id пользователя, в корзину от 0 до 99. Увеличение процента только добавляет пользователей — никто не переключается туда-обратно.