@krizaka/notifications 0.2.0 → 0.2.2

package/dist/{chunk-2MH7PZDT.js → chunk-AQI4ZDWW.js}

@@ -2,7 +2,7 @@ import {
   CHANNELS,
   NOTIFICATION_CODE,
   NotificationError
-} from "./chunk-FQYNUK64.js";
+} from "./chunk-RTHXH2BK.js";
 
 // src/rules.ts
 import { createHash } from "crypto";
@@ -85,4 +85,4 @@ export {
   viewOf,
   checkInput
 };
-//# sourceMappingURL=chunk-2MH7PZDT.js.map
+//# sourceMappingURL=chunk-AQI4ZDWW.js.map

package/dist/{chunk-FQYNUK64.js → chunk-RTHXH2BK.js}

@@ -26,4 +26,4 @@ export {
   NOTIFICATION_CODE,
   NotificationError
 };
-//# sourceMappingURL=chunk-FQYNUK64.js.map
+//# sourceMappingURL=chunk-RTHXH2BK.js.map

package/dist/chunk-RTHXH2BK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/port.ts"],"sourcesContent":["/**\n * The ports of « notifications »: the bell (an item per notification), the account's preferences (a matrix of categories by\n * channels), the phones registered for push, and one outbox message per enabled channel. Generic: no push or realtime import (the\n * workers that deliver a channel are the product's, or the Java service's for e-mail), no database client, no wall clock.\n */\nexport type { Clock, Query } from \"@krizaka/db\";\n\n/**\n * The channels an account switches. `app` is the bell and the live event of the open pages (one switch);\n * `push` goes to the account's registered phones; `email` to its address.\n */\nexport const CHANNEL = { app: \"app\", push: \"push\", email: \"email\" } as const;\nexport type Channel = (typeof CHANNEL)[keyof typeof CHANNEL];\nexport const CHANNELS: readonly Channel[] = [CHANNEL.app, CHANNEL.push, CHANNEL.email];\n\n/** What the outbox carries: the `channel` of Java's `evt.notification.requested.v1` (EMAIL) and two more for the web (PUSH, LIVE). */\nexport const DELIVERY = { email: \"EMAIL\", push: \"PUSH\", live: \"LIVE\" } as const;\nexport type Delivery = (typeof DELIVERY)[keyof typeof DELIVERY];\n\nexport const PLATFORM = { ios: \"ios\", android: \"android\", web: \"web\" } as const;\nexport type Platform = (typeof PLATFORM)[keyof typeof PLATFORM];\n\n/** A category as the product declares it. */\nexport interface CategoryDefaults {\n  /** Cannot be switched off (security, the account): its channels follow `defaults`, whatever the account chose. */\n  locked: boolean;\n  /** Which channels are on until the account chooses. */\n  defaults: Record<Channel, boolean>;\n  /** After `burstMax` notifications of this category to one account within `burstWindowSeconds`, the next ones are bell-only. */\n  burstMax: number;\n  burstWindowSeconds: number;\n}\n\n/** The categories (declared by the product, tuned by the admin) and the retention. Read from the settings at each call. */\nexport interface NotificationConfig {\n  categories: Record<string, CategoryDefaults>;\n  /** Days an item is kept before `purge`. */\n  retentionDays: number;\n}\n\n/** One line of the bell. */\nexport interface Item {\n  id: string;\n  accountId: string;\n  category: string;\n  template: string;\n  payload: Record<string, unknown>;\n  dedupeKey: string | null;\n  /** Shown in the bell. An item whose app channel was off is kept (the burst count and the history) but not shown. */\n  inBell: boolean;\n  createdAt: Date;\n  readAt: Date | null;\n}\n\nexport interface Device {\n  id: string;\n  accountId: string;\n  platform: Platform;\n  token: string;\n  createdAt: Date;\n  lastSeenAt: Date;\n}\n\n/** Where the state lives. Every adapter runs `notificationStoreContract` (`@krizaka/notifications/testkit`). */\nexport interface NotificationStore {\n  /**\n   * Writes the item and says whether it exceeds the burst cap, ATOMICALLY per account and category (the database serialises\n   * concurrent callers with a transaction-level advisory lock, so the cap holds under concurrency: pass the caller's `tx`).\n   * `duplicate` when the account already has an item with this `dedupeKey`: nothing is written.\n   */\n  record(item: Item, burst: { max: number; since: Date }): Promise<{ duplicate: boolean; capped: boolean }>;\n  /** The account's explicit choices. */\n  preferences(accountId: string): Promise<{ category: string; channel: Channel; enabled: boolean }[]>;\n  setPreference(accountId: string, category: string, channel: Channel, enabled: boolean, now: Date): Promise<void>;\n  /** Items shown in the bell, newest first; `before` is the cursor (the last item of the previous page). */\n  list(accountId: string, options: { unreadOnly: boolean; limit: number; before?: { createdAt: Date; id: string } }): Promise<Item[]>;\n  unreadCount(accountId: string): Promise<number>;\n  /** Marks read the account's own unread items among `ids` (all of them when `ids` is null). The first `read_at` stays. Returns how many. */\n  markRead(accountId: string, ids: readonly string[] | null, now: Date): Promise<number>;\n  /** A token belongs to one account: registering it again moves it, and brings back a revoked one. */\n  upsertDevice(device: Device): Promise<void>;\n  devices(accountId: string): Promise<Device[]>;\n  /** The push service said the token is dead. */\n  revokeDevice(token: string, now: Date): Promise<boolean>;\n  purgeBefore(before: Date): Promise<number>;\n  /** Removes everything held about the account. Returns how many rows. */\n  erase(accountId: string): Promise<number>;\n}\n\nexport const NOTIFICATION_CODE = {\n  badCategory: \"NOTIFICATIONS_BAD_CATEGORY\",\n  badInput: \"NOTIFICATIONS_BAD_INPUT\",\n  locked: \"NOTIFICATIONS_LOCKED\",\n  badConfig: \"NOTIFICATIONS_BAD_CONFIG\",\n} as const;\nexport type NotificationCode = (typeof NOTIFICATION_CODE)[keyof typeof NOTIFICATION_CODE];\n\nexport class NotificationError extends Error {\n  constructor(\n    readonly code: NotificationCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"NotificationError\";\n  }\n}\n"],"mappings":";AAWO,IAAM,UAAU,EAAE,KAAK,OAAO,MAAM,QAAQ,OAAO,QAAQ;AAE3D,IAAM,WAA+B,CAAC,QAAQ,KAAK,QAAQ,MAAM,QAAQ,KAAK;AAG9E,IAAM,WAAW,EAAE,OAAO,SAAS,MAAM,QAAQ,MAAM,OAAO;AAG9D,IAAM,WAAW,EAAE,KAAK,OAAO,SAAS,WAAW,KAAK,MAAM;AAsE9D,IAAM,oBAAoB;AAAA,EAC/B,aAAa;AAAA,EACb,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,WAAW;AACb;AAGO,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YACW,MACT,SACA;AACA,UAAM,OAAO;AAHJ;AAIT,SAAK,OAAO;AAAA,EACd;AAAA,EALW;AAMb;","names":[]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { N as NotificationStore, C as Channel, a as NotificationConfig, b as CategoryDefaults, D as Delivery, P as Platform, I as Item, c as Device } from './port-DptCmYwy.js';
-export { d as CHANNEL, e as CHANNELS, f as DELIVERY, g as NOTIFICATION_CODE, h as NotificationCode, i as NotificationError, j as PLATFORM } from './port-DptCmYwy.js';
+import { N as NotificationStore, C as Channel, a as NotificationConfig, b as CategoryDefaults, D as Delivery, P as Platform, I as Item, c as Device } from './port-B-JRUQH3.js';
+export { d as CHANNEL, e as CHANNELS, f as DELIVERY, g as NOTIFICATION_CODE, h as NotificationCode, i as NotificationError, j as PLATFORM } from './port-B-JRUQH3.js';
 import * as _krizaka_db from '@krizaka/db';
 import { Clock, Query } from '@krizaka/db';
 export { Clock, Query } from '@krizaka/db';

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   resolveChannels,
   uuidOf,
   viewOf
-} from "./chunk-2MH7PZDT.js";
+} from "./chunk-AQI4ZDWW.js";
 import {
   CHANNEL,
   CHANNELS,
@@ -15,7 +15,7 @@ import {
   NOTIFICATION_CODE,
   NotificationError,
   PLATFORM
-} from "./chunk-FQYNUK64.js";
+} from "./chunk-RTHXH2BK.js";
 
 // src/memory.ts
 var copy = (v) => ({ ...v });

package/dist/{port-DptCmYwy.d.ts → port-B-JRUQH3.d.ts}

@@ -5,7 +5,7 @@
  */
 
 /**
- * The channels an account switches. `app` is the bell and the live event of the open pages (one switch, like Orochia's matrix);
+ * The channels an account switches. `app` is the bell and the live event of the open pages (one switch);
  * `push` goes to the account's registered phones; `email` to its address.
  */
 declare const CHANNEL: {

package/dist/settings.d.ts

@@ -1,5 +1,5 @@
 import { Registry } from '@krizaka/settings';
-import { C as Channel, a as NotificationConfig } from './port-DptCmYwy.js';
+import { C as Channel, a as NotificationConfig } from './port-B-JRUQH3.js';
 
 /** What a product declares for a category; the admin tunes the values (except `locked`, which is code). */
 interface CategoryDeclaration {

package/dist/settings.js

@@ -2,12 +2,12 @@ import {
   CATEGORY_NAME,
   NOTIFICATION_BOUNDS,
   NOTIFICATION_DEFAULTS
-} from "./chunk-2MH7PZDT.js";
+} from "./chunk-AQI4ZDWW.js";
 import {
   CHANNELS,
   NOTIFICATION_CODE,
   NotificationError
-} from "./chunk-FQYNUK64.js";
+} from "./chunk-RTHXH2BK.js";
 
 // src/settings.ts
 import { flag, integer } from "@krizaka/settings";

package/dist/testkit.d.ts

@@ -1,4 +1,4 @@
-import { I as Item, N as NotificationStore } from './port-DptCmYwy.js';
+import { I as Item, N as NotificationStore } from './port-B-JRUQH3.js';
 
 declare const T0: Date;
 declare const at: (seconds: number) => Date;

package/dist/testkit.js

@@ -1,6 +1,6 @@
 import {
   CHANNEL
-} from "./chunk-FQYNUK64.js";
+} from "./chunk-RTHXH2BK.js";
 
 // src/testkit.ts
 import { randomUUID } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krizaka/notifications",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "The bell, channels and preferences for every Krizaka product: one notify() writes the in-app item and appends one outbox message per enabled channel (e-mail, push per device, live), respecting the account's matrix of categories by channels and per-category burst caps that hold under concurrency. The product declares its categories; the admin tunes defaults and caps. No push or realtime import, no wall clock.",
   "keywords": [
     "krizaka",
@@ -57,13 +57,13 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
     "zod": "^4.6.7",
-    "@krizaka/config": "^0.8.1",
-    "@krizaka/outbox": "^0.1.1"
+    "@krizaka/config": "^0.17.0",
+    "@krizaka/outbox": "^0.1.3"
   },
   "dependencies": {
-    "@krizaka/db": "^0.2.0",
-    "@krizaka/settings": "^0.5.0",
-    "@krizaka/time": "^0.1.0"
+    "@krizaka/settings": "^0.5.2",
+    "@krizaka/time": "^0.2.0",
+    "@krizaka/db": "^0.3.1"
   },
   "peerDependencies": {
     "vitest": ">=4",
@@ -81,7 +81,7 @@
     "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
     "lint": "eslint . --max-warnings 0 && tsc --noEmit",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run",
+    "test": "vitest run --coverage --coverage.provider=v8 --coverage.reporter=lcov --coverage.reporter=text-summary \"--coverage.include=src/**/*.ts\"",
     "check": "pnpm run lint && pnpm run test && pnpm run build"
   }
 }

package/dist/chunk-FQYNUK64.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/port.ts"],"sourcesContent":["/**\n * The ports of « notifications »: the bell (an item per notification), the account's preferences (a matrix of categories by\n * channels), the phones registered for push, and one outbox message per enabled channel. Generic: no push or realtime import (the\n * workers that deliver a channel are the product's, or the Java service's for e-mail), no database client, no wall clock.\n */\nexport type { Clock, Query } from \"@krizaka/db\";\n\n/**\n * The channels an account switches. `app` is the bell and the live event of the open pages (one switch, like Orochia's matrix);\n * `push` goes to the account's registered phones; `email` to its address.\n */\nexport const CHANNEL = { app: \"app\", push: \"push\", email: \"email\" } as const;\nexport type Channel = (typeof CHANNEL)[keyof typeof CHANNEL];\nexport const CHANNELS: readonly Channel[] = [CHANNEL.app, CHANNEL.push, CHANNEL.email];\n\n/** What the outbox carries: the `channel` of Java's `evt.notification.requested.v1` (EMAIL) and two more for the web (PUSH, LIVE). */\nexport const DELIVERY = { email: \"EMAIL\", push: \"PUSH\", live: \"LIVE\" } as const;\nexport type Delivery = (typeof DELIVERY)[keyof typeof DELIVERY];\n\nexport const PLATFORM = { ios: \"ios\", android: \"android\", web: \"web\" } as const;\nexport type Platform = (typeof PLATFORM)[keyof typeof PLATFORM];\n\n/** A category as the product declares it. */\nexport interface CategoryDefaults {\n  /** Cannot be switched off (security, the account): its channels follow `defaults`, whatever the account chose. */\n  locked: boolean;\n  /** Which channels are on until the account chooses. */\n  defaults: Record<Channel, boolean>;\n  /** After `burstMax` notifications of this category to one account within `burstWindowSeconds`, the next ones are bell-only. */\n  burstMax: number;\n  burstWindowSeconds: number;\n}\n\n/** The categories (declared by the product, tuned by the admin) and the retention. Read from the settings at each call. */\nexport interface NotificationConfig {\n  categories: Record<string, CategoryDefaults>;\n  /** Days an item is kept before `purge`. */\n  retentionDays: number;\n}\n\n/** One line of the bell. */\nexport interface Item {\n  id: string;\n  accountId: string;\n  category: string;\n  template: string;\n  payload: Record<string, unknown>;\n  dedupeKey: string | null;\n  /** Shown in the bell. An item whose app channel was off is kept (the burst count and the history) but not shown. */\n  inBell: boolean;\n  createdAt: Date;\n  readAt: Date | null;\n}\n\nexport interface Device {\n  id: string;\n  accountId: string;\n  platform: Platform;\n  token: string;\n  createdAt: Date;\n  lastSeenAt: Date;\n}\n\n/** Where the state lives. Every adapter runs `notificationStoreContract` (`@krizaka/notifications/testkit`). */\nexport interface NotificationStore {\n  /**\n   * Writes the item and says whether it exceeds the burst cap, ATOMICALLY per account and category (the database serialises\n   * concurrent callers with a transaction-level advisory lock, so the cap holds under concurrency: pass the caller's `tx`).\n   * `duplicate` when the account already has an item with this `dedupeKey`: nothing is written.\n   */\n  record(item: Item, burst: { max: number; since: Date }): Promise<{ duplicate: boolean; capped: boolean }>;\n  /** The account's explicit choices. */\n  preferences(accountId: string): Promise<{ category: string; channel: Channel; enabled: boolean }[]>;\n  setPreference(accountId: string, category: string, channel: Channel, enabled: boolean, now: Date): Promise<void>;\n  /** Items shown in the bell, newest first; `before` is the cursor (the last item of the previous page). */\n  list(accountId: string, options: { unreadOnly: boolean; limit: number; before?: { createdAt: Date; id: string } }): Promise<Item[]>;\n  unreadCount(accountId: string): Promise<number>;\n  /** Marks read the account's own unread items among `ids` (all of them when `ids` is null). The first `read_at` stays. Returns how many. */\n  markRead(accountId: string, ids: readonly string[] | null, now: Date): Promise<number>;\n  /** A token belongs to one account: registering it again moves it, and brings back a revoked one. */\n  upsertDevice(device: Device): Promise<void>;\n  devices(accountId: string): Promise<Device[]>;\n  /** The push service said the token is dead. */\n  revokeDevice(token: string, now: Date): Promise<boolean>;\n  purgeBefore(before: Date): Promise<number>;\n  /** Removes everything held about the account. Returns how many rows. */\n  erase(accountId: string): Promise<number>;\n}\n\nexport const NOTIFICATION_CODE = {\n  badCategory: \"NOTIFICATIONS_BAD_CATEGORY\",\n  badInput: \"NOTIFICATIONS_BAD_INPUT\",\n  locked: \"NOTIFICATIONS_LOCKED\",\n  badConfig: \"NOTIFICATIONS_BAD_CONFIG\",\n} as const;\nexport type NotificationCode = (typeof NOTIFICATION_CODE)[keyof typeof NOTIFICATION_CODE];\n\nexport class NotificationError extends Error {\n  constructor(\n    readonly code: NotificationCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"NotificationError\";\n  }\n}\n"],"mappings":";AAWO,IAAM,UAAU,EAAE,KAAK,OAAO,MAAM,QAAQ,OAAO,QAAQ;AAE3D,IAAM,WAA+B,CAAC,QAAQ,KAAK,QAAQ,MAAM,QAAQ,KAAK;AAG9E,IAAM,WAAW,EAAE,OAAO,SAAS,MAAM,QAAQ,MAAM,OAAO;AAG9D,IAAM,WAAW,EAAE,KAAK,OAAO,SAAS,WAAW,KAAK,MAAM;AAsE9D,IAAM,oBAAoB;AAAA,EAC/B,aAAa;AAAA,EACb,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,WAAW;AACb;AAGO,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YACW,MACT,SACA;AACA,UAAM,OAAO;AAHJ;AAIT,SAAK,OAAO;AAAA,EACd;AAAA,EALW;AAMb;","names":[]}