@taskless-app/shared 0.1.45 → 0.1.46

package/dist/index.d.ts

@@ -26,4 +26,5 @@ export * from "./importPackage.js";
 export * from "./descriptionText.js";
 export * from "./brokenUrl.js";
 export * from "./sidebarSections.js";
+export * from "./notificationDelivery.js";
 export * from "./sourceUrl.js";

package/dist/index.js

@@ -26,5 +26,6 @@ export * from "./importPackage.js";
 export * from "./descriptionText.js";
 export * from "./brokenUrl.js";
 export * from "./sidebarSections.js";
+export * from "./notificationDelivery.js";
 export * from "./sourceUrl.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC"}

package/dist/notificationDelivery.d.ts

@@ -0,0 +1,35 @@
+export type DeliveryLevel = "feed" | "counter" | "push";
+/**
+ * Уровень доставки для каждого вида, который мы шлём.
+ *
+ * ДОБАВИЛ НОВЫЙ ВИД — ДОПИШИ ЕГО СЮДА. Тест
+ * `packages/api/tests/notifications.deliveryLevels.test.ts` обходит
+ * builders.ts и падает, если вид оттуда здесь не объявлен.
+ */
+export declare const DELIVERY_LEVELS: Readonly<Record<string, DeliveryLevel>>;
+/**
+ * Уровень для вида, который в реестре не объявлен.
+ *
+ * НЕ `push`: именно «дефолт — звенеть» и был багом — новый вид бил в телефон
+ * всем сразу, как только появлялся в builders.ts. И не `feed`: незамеченный
+ * вид не должен ещё и исчезать бесследно. `counter` — самое безопасное из
+ * трёх: видно, но не будит. Дефолт при этом не способ жизни, а страховка —
+ * забыть вид не даёт тест полноты реестра.
+ */
+export declare const DEFAULT_DELIVERY_LEVEL: DeliveryLevel;
+/** Объявлен ли уровень доставки для этого вида. Спрашивает тест полноты. */
+export declare function isDeliveryLevelDeclared(kind: string): boolean;
+export declare function deliveryLevelOf(kind: string): DeliveryLevel;
+/** Может ли вид дойти до телефона. Настройка пользователя — поверх этого. */
+export declare function canPush(kind: string): boolean;
+/** Двигает ли вид значок непрочитанного. */
+export declare function countsUnread(kind: string): boolean;
+/**
+ * Виды уровня «лента» — для `kind: { notIn: ... }` в запросах счётчика.
+ *
+ * Миграция не нужна: счётчик считается запросом, и прошлые строки
+ * пересчитываются сами, как только вид попал сюда.
+ */
+export declare const FEED_ONLY_KINDS: readonly string[];
+export declare const SWARM_FEED_KIND = "swarm.feed";
+export declare const SWARM_NOTE_KIND = "swarm.note";

package/dist/notificationDelivery.js

@@ -0,0 +1,178 @@
+// PRJ-130: уровень доставки — СВОЙСТВО ВИДА уведомления, объявленное здесь,
+// рядом с самим видом, а не забытая настройка и не память автора.
+//
+// До этой правки «только лента» существовало в комментариях (`taskCreated`
+// в builders.ts обещал «пульс по проектам»), а в коде — нет: единственный
+// механизм, NEVER_PUSH_KINDS, знал два вида, оба про рой. Всё остальное
+// уходило пушем, потому что `isAllowed` для незнакомого вида отвечала `true`.
+// Из 49 видов, которые шлёт builders.ts, объявлено было 29 — про остальные
+// «не вспомнили», и вспомнить было негде.
+//
+// Три уровня, по возрастанию громкости:
+//
+//   feed    — строка в истории есть, счётчик не двигает, телефон молчит;
+//   counter — то же плюс значок непрочитанного;
+//   push    — то же плюс пуш на телефон.
+//
+// Правило, по которому вид попадает в `push`: событие адресовано человеку
+// ЛИЧНО и от него чего-то ждут. Назначили, упомянули, ответили ему, зовут в
+// звонок, сломался его ключ. «В проекте что-то произошло» не звенит никогда,
+// сколько бы участников в проекте ни было.
+//
+// Уровень говорит, ЧЕМ вид может быть доставлен; настройка пользователя
+// (notifications/preferences.ts) — хочет ли этого человек. Настройка стоит
+// ПОВЕРХ уровня и может только убавить: включить пуш виду уровня `feed`
+// нельзя, потому что управлять там нечем — тумблер, который ничего не делает,
+// врёт человеку (так уже решили в TASWM-327).
+//
+// Живёт в shared, а не в api, потому что уровень нужен обеим сторонам: сервер
+// решает по нему, слать ли пуш и считать ли строку в счётчике непрочитанного,
+// а веб — двигать ли бейдж оптимистично на входящем SSE. Один список на два
+// пакета; два списка неизбежно разъедутся, и разъезд означал бы тихо
+// вернувшийся пуш.
+/**
+ * Уровень доставки для каждого вида, который мы шлём.
+ *
+ * ДОБАВИЛ НОВЫЙ ВИД — ДОПИШИ ЕГО СЮДА. Тест
+ * `packages/api/tests/notifications.deliveryLevels.test.ts` обходит
+ * builders.ts и падает, если вид оттуда здесь не объявлен.
+ */
+export const DELIVERY_LEVELS = {
+    // ——— push: адресовано лично, от человека чего-то ждут ————————————————
+    "task.assigned": "push",
+    "task.mention": "push",
+    // Аудиторию комментариев сужает отдельная задача — здесь только уровень.
+    "task.comment": "push",
+    "task.reply": "push",
+    "task.priority_urgent": "push",
+    "task.deadline_near": "push",
+    "chat.mention": "push",
+    "chat.thread.replied": "push",
+    "room.mention": "push",
+    // Личка — самый адресный вид, который у нас есть. Тем же видом ходит и
+    // сообщение в канале (rooms/messageService.ts не различает их по kind), так
+    // что здесь мы платим за DM шумом каналов. Разделять аудиторию — работа
+    // отдельной задачи; ронять сюда весь чат ради каналов нельзя.
+    "room.message": "push",
+    "document.mention": "push",
+    "document.comment_mention": "push",
+    "post.mention": "push",
+    "call.incoming": "push",
+    "call.invite": "push",
+    "call.join_now": "push",
+    "call.started": "push",
+    "call.missed": "push",
+    "call.reminder_5m": "push",
+    // PRJ-130 (решено в этой задаче): гостя позвали в звонок — это зов, а не
+    // сводка. Гость обычно вне приложения, и лента, которую он не откроет,
+    // равна отсутствию приглашения.
+    "call.guest_invite": "push",
+    // «Тебя записали в созвон» — приглашение, как event.invite. Соседние
+    // call.rescheduled/cancelled ниже уровнем: там встреча уже твоя, меняются
+    // детали.
+    "call.scheduled": "push",
+    "event.invite": "push",
+    "workspace.invite": "push",
+    "ai.key_broken": "push",
+    // Лимит исчерпан → AI-фичи встали. Адресовано лично (владельцу лимита или
+    // админам воркспейса) и требует действия — поднять лимит.
+    "ai.quota.user_exceeded": "push",
+    "ai.quota.workspace_exceeded": "push",
+    // PRJ-130 (решено в этой задаче): дайджест и напоминание человек завёл САМ.
+    // Напоминание, пришедшее в ленту, — это не напоминание.
+    "agent.daily_digest": "push",
+    "agent.reminder": "push",
+    "swarm.anomaly": "push",
+    "swarm.overmind_down": "push",
+    // ——— counter: заметить нужно, будить незачем ———————————————————————
+    "task.status_changed": "counter",
+    "task.released": "counter",
+    "task.relation_added": "counter",
+    "task.deleted": "counter",
+    "document.comment": "counter",
+    "document.shared": "counter",
+    "suggestion.accepted": "counter",
+    "suggestion.rejected": "counter",
+    "call.rescheduled": "counter",
+    "call.cancelled": "counter",
+    // Тот же класс, что две строки выше: встреча уже твоя, меняются детали
+    // («изменил созвон») или тебя из неё убрали («убрал вас из созвона»).
+    // Событие адресное — пропасть из значка оно не должно.
+    "call.updated": "counter",
+    "call.removed": "counter",
+    "call.reminder_1h": "counter",
+    // Инфраструктурные тревоги: адресованы роли, а не человеку, и ждут не
+    // сиюминутной реакции.
+    "channel.alert": "counter",
+    "resource.alert": "counter",
+    "storage.quota": "counter",
+    "ci.branch_red": "counter",
+    "service.state_changed": "counter",
+    // В постановке этих двух не было — нашлись при обходе (deploys/
+    // prodLivenessWatcher.ts и github/webhook.ts). Тот же класс, что тревоги
+    // выше, поэтому тот же уровень.
+    "env.liveness_changed": "counter",
+    "workflow.changed": "counter",
+    // Поправка владельца к черновому раскладу (коммент к PRJ-130): «тебя
+    // добавили в проект» — событие адресное, пропасть оно не должно. Звенеть
+    // при этом незачем.
+    "project.member_added": "counter",
+    // «Указал вас автором новости» — то же самое, что строка выше: адресное,
+    // а не «в проекте что-то произошло».
+    "post.coauthored": "counter",
+    // В постановке не было. «Ответили в треде, за которым ты следишь» — слабее,
+    // чем chat.thread.replied («ответили ТЕБЕ»), и попадает под то же правило,
+    // что веерные виды: тебе никто не писал, ты в аудитории.
+    "chat.thread.followed": "counter",
+    // ——— feed: «в проекте что-то произошло» ————————————————————————————
+    "task.created": "feed",
+    "task.status_changed.broadcast": "feed",
+    "task.done.broadcast": "feed",
+    "task.commented.broadcast": "feed",
+    "reaction.received": "feed",
+    "project.created": "feed",
+    "project.subproject_added": "feed",
+    "call.ended": "feed",
+    // TASWM-327: тихие уровни надзора роя. Здесь они перестали быть исключением
+    // (NEVER_PUSH_KINDS) и стали обычной строкой реестра — политика та же.
+    "swarm.feed": "feed",
+    "swarm.note": "feed",
+};
+/**
+ * Уровень для вида, который в реестре не объявлен.
+ *
+ * НЕ `push`: именно «дефолт — звенеть» и был багом — новый вид бил в телефон
+ * всем сразу, как только появлялся в builders.ts. И не `feed`: незамеченный
+ * вид не должен ещё и исчезать бесследно. `counter` — самое безопасное из
+ * трёх: видно, но не будит. Дефолт при этом не способ жизни, а страховка —
+ * забыть вид не даёт тест полноты реестра.
+ */
+export const DEFAULT_DELIVERY_LEVEL = "counter";
+/** Объявлен ли уровень доставки для этого вида. Спрашивает тест полноты. */
+export function isDeliveryLevelDeclared(kind) {
+    return Object.prototype.hasOwnProperty.call(DELIVERY_LEVELS, kind);
+}
+export function deliveryLevelOf(kind) {
+    return DELIVERY_LEVELS[kind] ?? DEFAULT_DELIVERY_LEVEL;
+}
+/** Может ли вид дойти до телефона. Настройка пользователя — поверх этого. */
+export function canPush(kind) {
+    return deliveryLevelOf(kind) === "push";
+}
+/** Двигает ли вид значок непрочитанного. */
+export function countsUnread(kind) {
+    return deliveryLevelOf(kind) !== "feed";
+}
+/**
+ * Виды уровня «лента» — для `kind: { notIn: ... }` в запросах счётчика.
+ *
+ * Миграция не нужна: счётчик считается запросом, и прошлые строки
+ * пересчитываются сами, как только вид попал сюда.
+ */
+export const FEED_ONLY_KINDS = Object.keys(DELIVERY_LEVELS)
+    .filter((k) => DELIVERY_LEVELS[k] === "feed");
+// Виды тихого надзора роя — их проставляет mcp/tools/swarm.ts, и имя обязано
+// жить там же, где политика доставки: разъезд означал бы тихо вернувшийся пуш.
+export const SWARM_FEED_KIND = "swarm.feed";
+export const SWARM_NOTE_KIND = "swarm.note";
+//# sourceMappingURL=notificationDelivery.js.map

package/dist/notificationDelivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationDelivery.js","sourceRoot":"","sources":["../src/notificationDelivery.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskless-app/shared",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "type": "module",
   "description": "Shared types, Zod schemas and design tokens for the Taskless API contract — consumed by @taskless/api, @taskless/web and the Taskless mobile app.",
   "license": "MIT",