@krizaka/notifications 0.0.0-stage → 0.2.0

package/dist/index.js

@@ -0,0 +1,296 @@
+import {
+  NOTIFICATION_BOUNDS,
+  NOTIFICATION_DEFAULTS,
+  categoryOf,
+  checkConfig,
+  checkInput,
+  resolveChannels,
+  uuidOf,
+  viewOf
+} from "./chunk-2MH7PZDT.js";
+import {
+  CHANNEL,
+  CHANNELS,
+  DELIVERY,
+  NOTIFICATION_CODE,
+  NotificationError,
+  PLATFORM
+} from "./chunk-FQYNUK64.js";
+
+// src/memory.ts
+var copy = (v) => ({ ...v });
+var newestFirst = (a, b) => b.createdAt.valueOf() - a.createdAt.valueOf() || b.id.localeCompare(a.id);
+function memoryNotificationStore() {
+  const items = /* @__PURE__ */ new Map();
+  const prefs = /* @__PURE__ */ new Map();
+  const devices = /* @__PURE__ */ new Map();
+  return {
+    async record(item, burst) {
+      const mine = [...items.values()].filter((i) => i.accountId === item.accountId);
+      if (item.dedupeKey !== null && mine.some((i) => i.dedupeKey === item.dedupeKey)) return { duplicate: true, capped: false };
+      const recent = mine.filter((i) => i.category === item.category && i.createdAt >= burst.since).length;
+      items.set(item.id, copy(item));
+      return { duplicate: false, capped: recent >= burst.max };
+    },
+    async preferences(accountId) {
+      return [...prefs.entries()].filter(([key]) => key.startsWith(`${accountId}|`)).map(([, row]) => copy(row));
+    },
+    async setPreference(accountId, category, channel, enabled) {
+      prefs.set(`${accountId}|${category}|${channel}`, { category, channel, enabled });
+    },
+    async list(accountId, { unreadOnly, limit, before }) {
+      return [...items.values()].filter((i) => i.accountId === accountId && i.inBell && (!unreadOnly || i.readAt === null)).sort(newestFirst).filter((i) => !before || i.createdAt < before.createdAt || i.createdAt.valueOf() === before.createdAt.valueOf() && i.id < before.id).slice(0, limit).map(copy);
+    },
+    async unreadCount(accountId) {
+      return [...items.values()].filter((i) => i.accountId === accountId && i.inBell && i.readAt === null).length;
+    },
+    async markRead(accountId, ids, now) {
+      let n = 0;
+      for (const item of items.values()) {
+        if (item.accountId !== accountId || !item.inBell || item.readAt !== null || ids !== null && !ids.includes(item.id)) continue;
+        item.readAt = now;
+        n += 1;
+      }
+      return n;
+    },
+    async upsertDevice(device) {
+      const known = devices.get(device.token);
+      devices.set(device.token, { ...device, id: known?.id ?? device.id, createdAt: known?.createdAt ?? device.createdAt, revokedAt: null });
+    },
+    async devices(accountId) {
+      return [...devices.values()].filter((d) => d.accountId === accountId && d.revokedAt === null).map(({ revokedAt: _revoked, ...d }) => d);
+    },
+    async revokeDevice(token, now) {
+      const d = devices.get(token);
+      if (!d || d.revokedAt !== null) return false;
+      d.revokedAt = now;
+      return true;
+    },
+    async purgeBefore(before) {
+      let n = 0;
+      for (const [id, item] of items) {
+        if (item.createdAt >= before) continue;
+        items.delete(id);
+        n += 1;
+      }
+      return n;
+    },
+    async erase(accountId) {
+      let n = 0;
+      for (const [id, item] of items) if (item.accountId === accountId && items.delete(id)) n += 1;
+      for (const key of [...prefs.keys()]) if (key.startsWith(`${accountId}|`) && prefs.delete(key)) n += 1;
+      for (const [token, d] of devices) if (d.accountId === accountId && devices.delete(token)) n += 1;
+      return n;
+    }
+  };
+}
+
+// src/notifications.ts
+import { randomUUID } from "crypto";
+import { subHours, subSeconds } from "@krizaka/time";
+
+// src/persistence.ts
+import { ident } from "@krizaka/db";
+var toItem = (r) => ({ id: r.id, accountId: r.account_id, category: r.category, template: r.template, payload: r.payload, dedupeKey: r.dedupe_key, inBell: r.in_bell, createdAt: r.created_at, readAt: r.read_at });
+var toDevice = (r) => ({ id: r.id, accountId: r.account_id, platform: r.platform, token: r.token, createdAt: r.created_at, lastSeenAt: r.last_seen_at });
+function dbNotificationStore(query, schema = "notifications") {
+  const s = ident(schema);
+  return {
+    async record(item, burst) {
+      await query(`SELECT pg_advisory_xact_lock(hashtextextended($1, 0))`, [`${s}:${item.accountId}:${item.category}`]);
+      const [seen] = await query(`SELECT count(*)::int AS n FROM ${s}.item WHERE account_id = $1 AND category = $2 AND created_at >= $3`, [item.accountId, item.category, burst.since]);
+      const inserted = await query(
+        `INSERT INTO ${s}.item (id, account_id, category, template, payload, dedupe_key, in_bell, created_at) VALUES ($1,$2,$3,$4,$5,$6,$7,$8)
+         ON CONFLICT (account_id, dedupe_key) WHERE dedupe_key IS NOT NULL DO NOTHING RETURNING 1`,
+        [item.id, item.accountId, item.category, item.template, JSON.stringify(item.payload), item.dedupeKey, item.inBell, item.createdAt]
+      );
+      return inserted.length === 0 ? { duplicate: true, capped: false } : { duplicate: false, capped: (seen?.n ?? 0) >= burst.max };
+    },
+    async preferences(accountId) {
+      return query(`SELECT category, channel, enabled FROM ${s}.preference WHERE account_id = $1`, [accountId]);
+    },
+    async setPreference(accountId, category, channel, enabled, now) {
+      await query(`INSERT INTO ${s}.preference (account_id, category, channel, enabled, updated_at) VALUES ($1,$2,$3,$4,$5) ON CONFLICT (account_id, category, channel) DO UPDATE SET enabled = $4, updated_at = $5`, [accountId, category, channel, enabled, now]);
+    },
+    async list(accountId, { unreadOnly, limit, before }) {
+      const rows = await query(
+        `SELECT * FROM ${s}.item WHERE account_id = $1 AND in_bell AND ($2::boolean = false OR read_at IS NULL)
+           AND ($3::timestamptz IS NULL OR (created_at, id) < ($3::timestamptz, $4::uuid))
+         ORDER BY created_at DESC, id DESC LIMIT $5`,
+        [accountId, unreadOnly, before?.createdAt ?? null, before?.id ?? null, limit]
+      );
+      return rows.map(toItem);
+    },
+    async unreadCount(accountId) {
+      const [row] = await query(`SELECT count(*)::int AS n FROM ${s}.item WHERE account_id = $1 AND in_bell AND read_at IS NULL`, [accountId]);
+      return row?.n ?? 0;
+    },
+    async markRead(accountId, ids, now) {
+      const rows = await query(`UPDATE ${s}.item SET read_at = $3 WHERE account_id = $1 AND in_bell AND read_at IS NULL AND ($2::uuid[] IS NULL OR id = ANY($2::uuid[])) RETURNING 1`, [accountId, ids ? [...ids] : null, now]);
+      return rows.length;
+    },
+    async upsertDevice(d) {
+      await query(
+        `INSERT INTO ${s}.device (id, account_id, platform, token, created_at, last_seen_at) VALUES ($1,$2,$3,$4,$5,$6)
+         ON CONFLICT (token) DO UPDATE SET account_id = $2, platform = $3, last_seen_at = $6, revoked_at = NULL`,
+        [d.id, d.accountId, d.platform, d.token, d.createdAt, d.lastSeenAt]
+      );
+    },
+    async devices(accountId) {
+      return (await query(`SELECT id, account_id, platform, token, created_at, last_seen_at FROM ${s}.device WHERE account_id = $1 AND revoked_at IS NULL ORDER BY created_at, id`, [accountId])).map(toDevice);
+    },
+    async revokeDevice(token, now) {
+      return (await query(`UPDATE ${s}.device SET revoked_at = $2 WHERE token = $1 AND revoked_at IS NULL RETURNING 1`, [token, now])).length > 0;
+    },
+    async purgeBefore(before) {
+      return (await query(`DELETE FROM ${s}.item WHERE created_at < $1 RETURNING 1`, [before])).length;
+    },
+    async erase(accountId) {
+      const items = await query(`DELETE FROM ${s}.item WHERE account_id = $1 RETURNING 1`, [accountId]);
+      const prefs = await query(`DELETE FROM ${s}.preference WHERE account_id = $1 RETURNING 1`, [accountId]);
+      const devs = await query(`DELETE FROM ${s}.device WHERE account_id = $1 RETURNING 1`, [accountId]);
+      return items.length + prefs.length + devs.length;
+    }
+  };
+}
+
+// src/notifications.ts
+var NOTIFICATION_EVENT = { requested: "evt.notification.requested.v1" };
+var NOTIFICATION_TOPIC = { [DELIVERY.email]: "notifications.email", [DELIVERY.push]: "notifications.push", [DELIVERY.live]: "notifications.live" };
+var platforms = new Set(Object.values(PLATFORM));
+function createNotifications(deps) {
+  const storeFor = deps.storeFor ?? ((query) => dbNotificationStore(query, deps.schema ?? "notifications"));
+  const config = async () => checkConfig(typeof deps.config === "function" ? await deps.config() : deps.config);
+  const asMap = (rows, category) => new Map(rows.filter((r) => r.category === category).map((r) => [r.channel, r.enabled]));
+  return {
+    async notify(tx, input) {
+      checkInput(input);
+      const cfg = await config();
+      const category = categoryOf(cfg, input.category);
+      const now = deps.clock.now();
+      const store = storeFor(tx);
+      const channels = resolveChannels(category, asMap(await store.preferences(input.accountId), input.category));
+      const item = { id: randomUUID(), accountId: input.accountId, category: input.category, template: input.template, payload: { variables: input.variables ?? {}, ...input.payload ?? {} }, dedupeKey: input.dedupeKey ?? null, inBell: channels.app, createdAt: now, readAt: null };
+      const { duplicate, capped } = await store.record(item, { max: category.burstMax, since: subSeconds(now, category.burstWindowSeconds) });
+      if (duplicate) return { notificationId: null, duplicate: true, capped: false, channels: [] };
+      const used = [];
+      if (!capped) {
+        const base = { template: input.template, locale: input.locale ?? null, variables: input.variables ?? {}, notificationId: item.id, accountId: input.accountId, category: input.category };
+        const send = async (request) => {
+          await deps.outbox.append(tx, { topic: NOTIFICATION_TOPIC[request.channel], type: NOTIFICATION_EVENT.requested, payload: request, id: uuidOf(`${item.id}:${request.channel}:${request.recipient}`) });
+          if (!used.includes(request.channel)) used.push(request.channel);
+        };
+        if (channels.app) await send({ ...base, channel: DELIVERY.live, recipient: input.accountId });
+        if (channels.email && input.email) await send({ ...base, channel: DELIVERY.email, recipient: input.email });
+        if (channels.push) for (const device of await store.devices(input.accountId)) await send({ ...base, channel: DELIVERY.push, recipient: device.token, platform: device.platform });
+      }
+      return { notificationId: item.id, duplicate: false, capped, channels: used };
+    },
+    list: (query, accountId, options = {}) => storeFor(query).list(accountId, { unreadOnly: options.unreadOnly ?? false, limit: options.limit ?? 30, ...options.before ? { before: options.before } : {} }),
+    unreadCount: (query, accountId) => storeFor(query).unreadCount(accountId),
+    markRead: (query, accountId, ids) => storeFor(query).markRead(accountId, ids ?? null, deps.clock.now()),
+    async preferences(query, accountId) {
+      return viewOf(await config(), await storeFor(query).preferences(accountId));
+    },
+    async setPreference(query, accountId, category, channel, enabled) {
+      const def = categoryOf(await config(), category);
+      if (def.locked) throw new NotificationError(NOTIFICATION_CODE.locked, `category \xAB ${category} \xBB cannot be switched off`);
+      if (!Object.values(CHANNEL).includes(channel)) throw new NotificationError(NOTIFICATION_CODE.badInput, `unknown channel \xAB ${channel} \xBB`);
+      await storeFor(query).setPreference(accountId, category, channel, enabled, deps.clock.now());
+    },
+    async setMatrix(query, accountId, matrix) {
+      const cfg = await config();
+      for (const category of Object.keys(matrix)) categoryOf(cfg, category);
+      const store = storeFor(query);
+      for (const [category, row] of Object.entries(matrix)) {
+        if (cfg.categories[category].locked) continue;
+        for (const [channel, enabled] of Object.entries(row)) {
+          if (!Object.values(CHANNEL).includes(channel)) throw new NotificationError(NOTIFICATION_CODE.badInput, `unknown channel \xAB ${channel} \xBB`);
+          if (typeof enabled === "boolean") await store.setPreference(accountId, category, channel, enabled, deps.clock.now());
+        }
+      }
+    },
+    async registerDevice(query, accountId, device) {
+      if (!platforms.has(device.platform) || device.token.trim() === "" || device.token.length > 4096) throw new NotificationError(NOTIFICATION_CODE.badInput, "a device is a platform (ios, android, web) and a token");
+      const now = deps.clock.now();
+      await storeFor(query).upsertDevice({ id: randomUUID(), accountId, platform: device.platform, token: device.token, createdAt: now, lastSeenAt: now });
+    },
+    revokeDevice: (query, token) => storeFor(query).revokeDevice(token, deps.clock.now()),
+    devices: (query, accountId) => storeFor(query).devices(accountId),
+    async purge(query) {
+      const cfg = await config();
+      return storeFor(query).purgeBefore(subHours(deps.clock.now(), cfg.retentionDays * 24));
+    },
+    erase: (query, accountId) => storeFor(query).erase(accountId)
+  };
+}
+
+// src/schema.ts
+import { defineModule } from "@krizaka/db";
+var notificationsSchema = defineModule({
+  module: "notifications",
+  tables: ["owner"],
+  migrations: [
+    {
+      version: 1,
+      name: "items, preferences and devices",
+      sql: (c) => `
+CREATE TABLE ${c.schema}.item (
+  id         uuid PRIMARY KEY,
+  account_id uuid NOT NULL REFERENCES ${c.tables.owner}(id) ON DELETE CASCADE,
+  category   text NOT NULL CHECK (category ~ '^[a-z][a-zA-Z0-9]{0,39}$'),
+  template   text NOT NULL CHECK (template ~ '^[a-z0-9]+(-[a-z0-9]+)*$'),
+  payload    jsonb NOT NULL,
+  dedupe_key text CHECK (dedupe_key IS NULL OR char_length(dedupe_key) BETWEEN 1 AND 200),
+  in_bell    boolean NOT NULL,
+  created_at timestamptz NOT NULL,
+  read_at    timestamptz
+);
+CREATE UNIQUE INDEX item_dedupe ON ${c.schema}.item (account_id, dedupe_key) WHERE dedupe_key IS NOT NULL;
+CREATE INDEX item_bell ON ${c.schema}.item (account_id, created_at DESC, id DESC) WHERE in_bell;
+CREATE INDEX item_burst ON ${c.schema}.item (account_id, category, created_at);
+CREATE INDEX item_created ON ${c.schema}.item (created_at);
+CREATE TABLE ${c.schema}.preference (
+  account_id uuid NOT NULL REFERENCES ${c.tables.owner}(id) ON DELETE CASCADE,
+  category   text NOT NULL CHECK (category ~ '^[a-z][a-zA-Z0-9]{0,39}$'),
+  channel    text NOT NULL CHECK (channel IN ('app', 'push', 'email')),
+  enabled    boolean NOT NULL,
+  updated_at timestamptz NOT NULL,
+  PRIMARY KEY (account_id, category, channel)
+);
+CREATE TABLE ${c.schema}.device (
+  id           uuid PRIMARY KEY,
+  account_id   uuid NOT NULL REFERENCES ${c.tables.owner}(id) ON DELETE CASCADE,
+  platform     text NOT NULL CHECK (platform IN ('ios', 'android', 'web')),
+  token        text NOT NULL UNIQUE CHECK (char_length(token) BETWEEN 1 AND 4096),
+  created_at   timestamptz NOT NULL,
+  last_seen_at timestamptz NOT NULL,
+  revoked_at   timestamptz
+);
+CREATE INDEX device_account ON ${c.schema}.device (account_id) WHERE revoked_at IS NULL;`
+    }
+  ]
+});
+export {
+  CHANNEL,
+  CHANNELS,
+  DELIVERY,
+  NOTIFICATION_BOUNDS,
+  NOTIFICATION_CODE,
+  NOTIFICATION_DEFAULTS,
+  NOTIFICATION_EVENT,
+  NOTIFICATION_TOPIC,
+  NotificationError,
+  PLATFORM,
+  categoryOf,
+  checkConfig,
+  checkInput,
+  createNotifications,
+  dbNotificationStore,
+  memoryNotificationStore,
+  notificationsSchema,
+  resolveChannels,
+  uuidOf,
+  viewOf
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/memory.ts","../src/notifications.ts","../src/persistence.ts","../src/schema.ts"],"sourcesContent":["import type { Channel, Device, Item, NotificationStore } from \"./port\";\n\nconst copy = <T extends object>(v: T): T => ({ ...v });\nconst newestFirst = (a: Item, b: Item) => b.createdAt.valueOf() - a.createdAt.valueOf() || b.id.localeCompare(a.id);\n\n/** An in-memory store, for unit tests and demos: the behaviour of the database's (the contract kit runs on both). `record` is one synchronous step, so it is atomic. */\nexport function memoryNotificationStore(): NotificationStore {\n  const items = new Map<string, Item>();\n  const prefs = new Map<string, { category: string; channel: Channel; enabled: boolean }>();\n  const devices = new Map<string, Device & { revokedAt: Date | null }>();\n  return {\n    async record(item, burst) {\n      const mine = [...items.values()].filter((i) => i.accountId === item.accountId);\n      if (item.dedupeKey !== null && mine.some((i) => i.dedupeKey === item.dedupeKey)) return { duplicate: true, capped: false };\n      const recent = mine.filter((i) => i.category === item.category && i.createdAt >= burst.since).length;\n      items.set(item.id, copy(item));\n      return { duplicate: false, capped: recent >= burst.max };\n    },\n    async preferences(accountId) {\n      return [...prefs.entries()].filter(([key]) => key.startsWith(`${accountId}|`)).map(([, row]) => copy(row));\n    },\n    async setPreference(accountId, category, channel, enabled) {\n      prefs.set(`${accountId}|${category}|${channel}`, { category, channel, enabled });\n    },\n    async list(accountId, { unreadOnly, limit, before }) {\n      return [...items.values()]\n        .filter((i) => i.accountId === accountId && i.inBell && (!unreadOnly || i.readAt === null))\n        .sort(newestFirst)\n        .filter((i) => !before || i.createdAt < before.createdAt || (i.createdAt.valueOf() === before.createdAt.valueOf() && i.id < before.id))\n        .slice(0, limit)\n        .map(copy);\n    },\n    async unreadCount(accountId) {\n      return [...items.values()].filter((i) => i.accountId === accountId && i.inBell && i.readAt === null).length;\n    },\n    async markRead(accountId, ids, now) {\n      let n = 0;\n      for (const item of items.values()) {\n        if (item.accountId !== accountId || !item.inBell || item.readAt !== null || (ids !== null && !ids.includes(item.id))) continue;\n        item.readAt = now;\n        n += 1;\n      }\n      return n;\n    },\n    async upsertDevice(device) {\n      const known = devices.get(device.token);\n      devices.set(device.token, { ...device, id: known?.id ?? device.id, createdAt: known?.createdAt ?? device.createdAt, revokedAt: null });\n    },\n    async devices(accountId) {\n      return [...devices.values()].filter((d) => d.accountId === accountId && d.revokedAt === null).map(({ revokedAt: _revoked, ...d }) => d);\n    },\n    async revokeDevice(token, now) {\n      const d = devices.get(token);\n      if (!d || d.revokedAt !== null) return false;\n      d.revokedAt = now;\n      return true;\n    },\n    async purgeBefore(before) {\n      let n = 0;\n      for (const [id, item] of items) {\n        if (item.createdAt >= before) continue;\n        items.delete(id);\n        n += 1;\n      }\n      return n;\n    },\n    async erase(accountId) {\n      let n = 0;\n      for (const [id, item] of items) if (item.accountId === accountId && items.delete(id)) n += 1;\n      for (const key of [...prefs.keys()]) if (key.startsWith(`${accountId}|`) && prefs.delete(key)) n += 1;\n      for (const [token, d] of devices) if (d.accountId === accountId && devices.delete(token)) n += 1;\n      return n;\n    },\n  };\n}\n","import { randomUUID } from \"node:crypto\";\n\nimport { subHours, subSeconds } from \"@krizaka/time\";\n\nimport { dbNotificationStore } from \"./persistence\";\nimport { CHANNEL, type Channel, type Clock, DELIVERY, type Delivery, type Device, type Item, NOTIFICATION_CODE, type NotificationConfig, NotificationError, type NotificationStore, PLATFORM, type Platform, type Query } from \"./port\";\nimport { categoryOf, checkConfig, checkInput, type NotifyInput, type PreferenceView, resolveChannels, uuidOf, viewOf } from \"./rules\";\n\n/** The event the outbox carries, the name Java's `krizaka-notifications-api` gives its request. */\nexport const NOTIFICATION_EVENT = { requested: \"evt.notification.requested.v1\" } as const;\n\n/** One topic per delivery, so a worker claims only what it delivers (`notifications.email`, `notifications.push`, `notifications.live`). */\nexport const NOTIFICATION_TOPIC: Record<Delivery, string> = { [DELIVERY.email]: \"notifications.email\", [DELIVERY.push]: \"notifications.push\", [DELIVERY.live]: \"notifications.live\" };\n\n/** What the module needs of `@krizaka/outbox` (its `Outbox` satisfies it): append in the caller's transaction. */\nexport interface NotificationOutbox {\n  append(tx: Query, message: { topic: string; type: string; payload: unknown; id: string }): Promise<{ id: string; appended: boolean }>;\n}\n\nexport interface NotificationDeps {\n  clock: Clock;\n  outbox: NotificationOutbox;\n  /** The categories and the retention, read at each call so the admin's change applies at once. */\n  config: NotificationConfig | (() => NotificationConfig | Promise<NotificationConfig>);\n  /** The store over a query (a transaction or a pool). Default: the PostgreSQL store on schema `notifications`. */\n  storeFor?: (query: Query) => NotificationStore;\n  /** The Postgres schema, when the product renamed the module's (used by the default store). */\n  schema?: string;\n}\n\n/** The request one delivery worker receives: Java's `NotificationRequest` (channel, recipient, template, locale, variables) plus the ids. */\nexport interface NotificationRequest {\n  channel: Delivery;\n  /** An e-mail address (EMAIL), a device token (PUSH) or an account id (LIVE). */\n  recipient: string;\n  template: string;\n  locale: string | null;\n  variables: Record<string, string>;\n  notificationId: string;\n  accountId: string;\n  category: string;\n  /** PUSH only. */\n  platform?: Platform;\n}\n\nexport interface Notified {\n  /** `null` for a duplicate (same `dedupeKey`): nothing was written or appended. */\n  notificationId: string | null;\n  duplicate: boolean;\n  /** Past the category's burst cap: the item is kept, the channels were not used. */\n  capped: boolean;\n  /** The channels that were used. */\n  channels: Delivery[];\n}\n\nexport interface Notifications {\n  /**\n   * Writes the bell item and appends one outbox message per enabled channel, in `tx` (use the caller's transaction: it is what makes\n   * the burst cap hold under concurrency, and the messages leave only if the work commits).\n   */\n  notify(tx: Query, input: NotifyInput): Promise<Notified>;\n  /** The bell, newest first. */\n  list(query: Query, accountId: string, options?: { unreadOnly?: boolean; limit?: number; before?: { createdAt: Date; id: string } }): Promise<Item[]>;\n  unreadCount(query: Query, accountId: string): Promise<number>;\n  /** Marks the account's own unread items read (those in `ids`, or all). Returns how many. */\n  markRead(query: Query, accountId: string, ids?: readonly string[]): Promise<number>;\n  /** The account's matrix: every category, every channel, and whether it is the default, the account's choice or locked. */\n  preferences(query: Query, accountId: string): Promise<PreferenceView[]>;\n  /** @throws NotificationError `NOTIFICATIONS_LOCKED` for a locked category, `NOTIFICATIONS_BAD_CATEGORY` for an unknown one. */\n  setPreference(query: Query, accountId: string, category: string, channel: Channel, enabled: boolean): Promise<void>;\n  /** The whole matrix at once (a preset applied): the locked categories are left as they are. */\n  setMatrix(query: Query, accountId: string, matrix: Record<string, Partial<Record<Channel, boolean>>>): Promise<void>;\n  registerDevice(query: Query, accountId: string, device: { platform: Platform; token: string }): Promise<void>;\n  /** The push service refused the token: it is never used again until registered anew. */\n  revokeDevice(query: Query, token: string): Promise<boolean>;\n  devices(query: Query, accountId: string): Promise<Device[]>;\n  /** Removes the items older than the retention. */\n  purge(query: Query): Promise<number>;\n  /** Erasure (Loi 25): everything held about the account. */\n  erase(query: Query, accountId: string): Promise<number>;\n}\n\nconst platforms = new Set<string>(Object.values(PLATFORM));\n\n/**\n * The notifications of a product.\n * @param deps the clock, the outbox, the configuration, and optionally the store and schema\n * @returns the notification functions\n */\nexport function createNotifications(deps: NotificationDeps): Notifications {\n  const storeFor = deps.storeFor ?? ((query: Query) => dbNotificationStore(query, deps.schema ?? \"notifications\"));\n  const config = async () => checkConfig(typeof deps.config === \"function\" ? await deps.config() : deps.config);\n  const asMap = (rows: { category: string; channel: Channel; enabled: boolean }[], category: string) => new Map(rows.filter((r) => r.category === category).map((r) => [r.channel, r.enabled] as const));\n  return {\n    async notify(tx, input) {\n      checkInput(input);\n      const cfg = await config();\n      const category = categoryOf(cfg, input.category);\n      const now = deps.clock.now();\n      const store = storeFor(tx);\n      const channels = resolveChannels(category, asMap(await store.preferences(input.accountId), input.category));\n      const item: Item = { id: randomUUID(), accountId: input.accountId, category: input.category, template: input.template, payload: { variables: input.variables ?? {}, ...(input.payload ?? {}) }, dedupeKey: input.dedupeKey ?? null, inBell: channels.app, createdAt: now, readAt: null };\n      const { duplicate, capped } = await store.record(item, { max: category.burstMax, since: subSeconds(now, category.burstWindowSeconds) });\n      if (duplicate) return { notificationId: null, duplicate: true, capped: false, channels: [] };\n      const used: Delivery[] = [];\n      if (!capped) {\n        const base = { template: input.template, locale: input.locale ?? null, variables: input.variables ?? {}, notificationId: item.id, accountId: input.accountId, category: input.category };\n        const send = async (request: NotificationRequest) => {\n          await deps.outbox.append(tx, { topic: NOTIFICATION_TOPIC[request.channel], type: NOTIFICATION_EVENT.requested, payload: request, id: uuidOf(`${item.id}:${request.channel}:${request.recipient}`) });\n          if (!used.includes(request.channel)) used.push(request.channel);\n        };\n        if (channels.app) await send({ ...base, channel: DELIVERY.live, recipient: input.accountId });\n        if (channels.email && input.email) await send({ ...base, channel: DELIVERY.email, recipient: input.email });\n        if (channels.push) for (const device of await store.devices(input.accountId)) await send({ ...base, channel: DELIVERY.push, recipient: device.token, platform: device.platform });\n      }\n      return { notificationId: item.id, duplicate: false, capped, channels: used };\n    },\n    list: (query, accountId, options = {}) => storeFor(query).list(accountId, { unreadOnly: options.unreadOnly ?? false, limit: options.limit ?? 30, ...(options.before ? { before: options.before } : {}) }),\n    unreadCount: (query, accountId) => storeFor(query).unreadCount(accountId),\n    markRead: (query, accountId, ids) => storeFor(query).markRead(accountId, ids ?? null, deps.clock.now()),\n    async preferences(query, accountId) {\n      return viewOf(await config(), await storeFor(query).preferences(accountId));\n    },\n    async setPreference(query, accountId, category, channel, enabled) {\n      const def = categoryOf(await config(), category);\n      if (def.locked) throw new NotificationError(NOTIFICATION_CODE.locked, `category « ${category} » cannot be switched off`);\n      if (!Object.values(CHANNEL).includes(channel)) throw new NotificationError(NOTIFICATION_CODE.badInput, `unknown channel « ${channel} »`);\n      await storeFor(query).setPreference(accountId, category, channel, enabled, deps.clock.now());\n    },\n    async setMatrix(query, accountId, matrix) {\n      const cfg = await config();\n      for (const category of Object.keys(matrix)) categoryOf(cfg, category);\n      const store = storeFor(query);\n      for (const [category, row] of Object.entries(matrix)) {\n        if (cfg.categories[category]!.locked) continue;\n        for (const [channel, enabled] of Object.entries(row)) {\n          if (!Object.values(CHANNEL).includes(channel as Channel)) throw new NotificationError(NOTIFICATION_CODE.badInput, `unknown channel « ${channel} »`);\n          if (typeof enabled === \"boolean\") await store.setPreference(accountId, category, channel as Channel, enabled, deps.clock.now());\n        }\n      }\n    },\n    async registerDevice(query, accountId, device) {\n      if (!platforms.has(device.platform) || device.token.trim() === \"\" || device.token.length > 4096) throw new NotificationError(NOTIFICATION_CODE.badInput, \"a device is a platform (ios, android, web) and a token\");\n      const now = deps.clock.now();\n      await storeFor(query).upsertDevice({ id: randomUUID(), accountId, platform: device.platform, token: device.token, createdAt: now, lastSeenAt: now });\n    },\n    revokeDevice: (query, token) => storeFor(query).revokeDevice(token, deps.clock.now()),\n    devices: (query, accountId) => storeFor(query).devices(accountId),\n    async purge(query) {\n      const cfg = await config();\n      return storeFor(query).purgeBefore(subHours(deps.clock.now(), cfg.retentionDays * 24));\n    },\n    erase: (query, accountId) => storeFor(query).erase(accountId),\n  };\n}\n","import { ident, type Query } from \"@krizaka/db\";\n\nimport type { Channel, Device, Item, NotificationStore, Platform } from \"./port\";\n\ninterface ItemRow {\n  id: string;\n  account_id: string;\n  category: string;\n  template: string;\n  payload: Record<string, unknown>;\n  dedupe_key: string | null;\n  in_bell: boolean;\n  created_at: Date;\n  read_at: Date | null;\n}\ninterface DeviceRow {\n  id: string;\n  account_id: string;\n  platform: Platform;\n  token: string;\n  created_at: Date;\n  last_seen_at: Date;\n}\n\nconst toItem = (r: ItemRow): Item => ({ id: r.id, accountId: r.account_id, category: r.category, template: r.template, payload: r.payload, dedupeKey: r.dedupe_key, inBell: r.in_bell, createdAt: r.created_at, readAt: r.read_at });\nconst toDevice = (r: DeviceRow): Device => ({ id: r.id, accountId: r.account_id, platform: r.platform, token: r.token, createdAt: r.created_at, lastSeenAt: r.last_seen_at });\n\n/**\n * The PostgreSQL store of « notifications » over a `Query`, in schema `notifications` (or the one the product renamed it to).\n * `record` takes a transaction-level advisory lock per account and category, so the burst cap holds under concurrency ONLY inside the\n * caller's transaction: pass `tx`.\n */\nexport function dbNotificationStore(query: Query, schema = \"notifications\"): NotificationStore {\n  const s = ident(schema);\n  return {\n    async record(item, burst) {\n      await query(`SELECT pg_advisory_xact_lock(hashtextextended($1, 0))`, [`${s}:${item.accountId}:${item.category}`]);\n      const [seen] = await query<{ n: number }>(`SELECT count(*)::int AS n FROM ${s}.item WHERE account_id = $1 AND category = $2 AND created_at >= $3`, [item.accountId, item.category, burst.since]);\n      const inserted = await query(\n        `INSERT INTO ${s}.item (id, account_id, category, template, payload, dedupe_key, in_bell, created_at) VALUES ($1,$2,$3,$4,$5,$6,$7,$8)\n         ON CONFLICT (account_id, dedupe_key) WHERE dedupe_key IS NOT NULL DO NOTHING RETURNING 1`,\n        [item.id, item.accountId, item.category, item.template, JSON.stringify(item.payload), item.dedupeKey, item.inBell, item.createdAt],\n      );\n      return inserted.length === 0 ? { duplicate: true, capped: false } : { duplicate: false, capped: (seen?.n ?? 0) >= burst.max };\n    },\n    async preferences(accountId) {\n      return query<{ category: string; channel: Channel; enabled: boolean }>(`SELECT category, channel, enabled FROM ${s}.preference WHERE account_id = $1`, [accountId]);\n    },\n    async setPreference(accountId, category, channel, enabled, now) {\n      await query(`INSERT INTO ${s}.preference (account_id, category, channel, enabled, updated_at) VALUES ($1,$2,$3,$4,$5) ON CONFLICT (account_id, category, channel) DO UPDATE SET enabled = $4, updated_at = $5`, [accountId, category, channel, enabled, now]);\n    },\n    async list(accountId, { unreadOnly, limit, before }) {\n      const rows = await query<ItemRow>(\n        `SELECT * FROM ${s}.item WHERE account_id = $1 AND in_bell AND ($2::boolean = false OR read_at IS NULL)\n           AND ($3::timestamptz IS NULL OR (created_at, id) < ($3::timestamptz, $4::uuid))\n         ORDER BY created_at DESC, id DESC LIMIT $5`,\n        [accountId, unreadOnly, before?.createdAt ?? null, before?.id ?? null, limit],\n      );\n      return rows.map(toItem);\n    },\n    async unreadCount(accountId) {\n      const [row] = await query<{ n: number }>(`SELECT count(*)::int AS n FROM ${s}.item WHERE account_id = $1 AND in_bell AND read_at IS NULL`, [accountId]);\n      return row?.n ?? 0;\n    },\n    async markRead(accountId, ids, now) {\n      const rows = await query(`UPDATE ${s}.item SET read_at = $3 WHERE account_id = $1 AND in_bell AND read_at IS NULL AND ($2::uuid[] IS NULL OR id = ANY($2::uuid[])) RETURNING 1`, [accountId, ids ? [...ids] : null, now]);\n      return rows.length;\n    },\n    async upsertDevice(d) {\n      await query(\n        `INSERT INTO ${s}.device (id, account_id, platform, token, created_at, last_seen_at) VALUES ($1,$2,$3,$4,$5,$6)\n         ON CONFLICT (token) DO UPDATE SET account_id = $2, platform = $3, last_seen_at = $6, revoked_at = NULL`,\n        [d.id, d.accountId, d.platform, d.token, d.createdAt, d.lastSeenAt],\n      );\n    },\n    async devices(accountId) {\n      return (await query<DeviceRow>(`SELECT id, account_id, platform, token, created_at, last_seen_at FROM ${s}.device WHERE account_id = $1 AND revoked_at IS NULL ORDER BY created_at, id`, [accountId])).map(toDevice);\n    },\n    async revokeDevice(token, now) {\n      return (await query(`UPDATE ${s}.device SET revoked_at = $2 WHERE token = $1 AND revoked_at IS NULL RETURNING 1`, [token, now])).length > 0;\n    },\n    async purgeBefore(before) {\n      return (await query(`DELETE FROM ${s}.item WHERE created_at < $1 RETURNING 1`, [before])).length;\n    },\n    async erase(accountId) {\n      const items = await query(`DELETE FROM ${s}.item WHERE account_id = $1 RETURNING 1`, [accountId]);\n      const prefs = await query(`DELETE FROM ${s}.preference WHERE account_id = $1 RETURNING 1`, [accountId]);\n      const devs = await query(`DELETE FROM ${s}.device WHERE account_id = $1 RETURNING 1`, [accountId]);\n      return items.length + prefs.length + devs.length;\n    },\n  };\n}\n","import { defineModule } from \"@krizaka/db\";\n\n/**\n * The tables of « notifications », in their own Postgres schema: `item` (the bell, and the history the burst caps count), `preference`\n * (the account's explicit choices: account by category by channel) and `device` (the push tokens). The one product table referenced is\n * the owner (`owner`, the account table): a deleted account takes its rows with it. Version 1 is frozen once released: a change is version 2.\n */\nexport const notificationsSchema = defineModule({\n  module: \"notifications\",\n  tables: [\"owner\"],\n  migrations: [\n    {\n      version: 1,\n      name: \"items, preferences and devices\",\n      sql: (c) => `\nCREATE TABLE ${c.schema}.item (\n  id         uuid PRIMARY KEY,\n  account_id uuid NOT NULL REFERENCES ${c.tables.owner}(id) ON DELETE CASCADE,\n  category   text NOT NULL CHECK (category ~ '^[a-z][a-zA-Z0-9]{0,39}$'),\n  template   text NOT NULL CHECK (template ~ '^[a-z0-9]+(-[a-z0-9]+)*$'),\n  payload    jsonb NOT NULL,\n  dedupe_key text CHECK (dedupe_key IS NULL OR char_length(dedupe_key) BETWEEN 1 AND 200),\n  in_bell    boolean NOT NULL,\n  created_at timestamptz NOT NULL,\n  read_at    timestamptz\n);\nCREATE UNIQUE INDEX item_dedupe ON ${c.schema}.item (account_id, dedupe_key) WHERE dedupe_key IS NOT NULL;\nCREATE INDEX item_bell ON ${c.schema}.item (account_id, created_at DESC, id DESC) WHERE in_bell;\nCREATE INDEX item_burst ON ${c.schema}.item (account_id, category, created_at);\nCREATE INDEX item_created ON ${c.schema}.item (created_at);\nCREATE TABLE ${c.schema}.preference (\n  account_id uuid NOT NULL REFERENCES ${c.tables.owner}(id) ON DELETE CASCADE,\n  category   text NOT NULL CHECK (category ~ '^[a-z][a-zA-Z0-9]{0,39}$'),\n  channel    text NOT NULL CHECK (channel IN ('app', 'push', 'email')),\n  enabled    boolean NOT NULL,\n  updated_at timestamptz NOT NULL,\n  PRIMARY KEY (account_id, category, channel)\n);\nCREATE TABLE ${c.schema}.device (\n  id           uuid PRIMARY KEY,\n  account_id   uuid NOT NULL REFERENCES ${c.tables.owner}(id) ON DELETE CASCADE,\n  platform     text NOT NULL CHECK (platform IN ('ios', 'android', 'web')),\n  token        text NOT NULL UNIQUE CHECK (char_length(token) BETWEEN 1 AND 4096),\n  created_at   timestamptz NOT NULL,\n  last_seen_at timestamptz NOT NULL,\n  revoked_at   timestamptz\n);\nCREATE INDEX device_account ON ${c.schema}.device (account_id) WHERE revoked_at IS NULL;`,\n    },\n  ],\n});\n"],"mappings":"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","names":[]}

package/dist/port-DptCmYwy.d.ts

@@ -0,0 +1,122 @@
+/**
+ * The ports of « notifications »: the bell (an item per notification), the account's preferences (a matrix of categories by
+ * channels), the phones registered for push, and one outbox message per enabled channel. Generic: no push or realtime import (the
+ * workers that deliver a channel are the product's, or the Java service's for e-mail), no database client, no wall clock.
+ */
+
+/**
+ * The channels an account switches. `app` is the bell and the live event of the open pages (one switch, like Orochia's matrix);
+ * `push` goes to the account's registered phones; `email` to its address.
+ */
+declare const CHANNEL: {
+    readonly app: "app";
+    readonly push: "push";
+    readonly email: "email";
+};
+type Channel = (typeof CHANNEL)[keyof typeof CHANNEL];
+declare const CHANNELS: readonly Channel[];
+/** What the outbox carries: the `channel` of Java's `evt.notification.requested.v1` (EMAIL) and two more for the web (PUSH, LIVE). */
+declare const DELIVERY: {
+    readonly email: "EMAIL";
+    readonly push: "PUSH";
+    readonly live: "LIVE";
+};
+type Delivery = (typeof DELIVERY)[keyof typeof DELIVERY];
+declare const PLATFORM: {
+    readonly ios: "ios";
+    readonly android: "android";
+    readonly web: "web";
+};
+type Platform = (typeof PLATFORM)[keyof typeof PLATFORM];
+/** A category as the product declares it. */
+interface CategoryDefaults {
+    /** Cannot be switched off (security, the account): its channels follow `defaults`, whatever the account chose. */
+    locked: boolean;
+    /** Which channels are on until the account chooses. */
+    defaults: Record<Channel, boolean>;
+    /** After `burstMax` notifications of this category to one account within `burstWindowSeconds`, the next ones are bell-only. */
+    burstMax: number;
+    burstWindowSeconds: number;
+}
+/** The categories (declared by the product, tuned by the admin) and the retention. Read from the settings at each call. */
+interface NotificationConfig {
+    categories: Record<string, CategoryDefaults>;
+    /** Days an item is kept before `purge`. */
+    retentionDays: number;
+}
+/** One line of the bell. */
+interface Item {
+    id: string;
+    accountId: string;
+    category: string;
+    template: string;
+    payload: Record<string, unknown>;
+    dedupeKey: string | null;
+    /** Shown in the bell. An item whose app channel was off is kept (the burst count and the history) but not shown. */
+    inBell: boolean;
+    createdAt: Date;
+    readAt: Date | null;
+}
+interface Device {
+    id: string;
+    accountId: string;
+    platform: Platform;
+    token: string;
+    createdAt: Date;
+    lastSeenAt: Date;
+}
+/** Where the state lives. Every adapter runs `notificationStoreContract` (`@krizaka/notifications/testkit`). */
+interface NotificationStore {
+    /**
+     * Writes the item and says whether it exceeds the burst cap, ATOMICALLY per account and category (the database serialises
+     * concurrent callers with a transaction-level advisory lock, so the cap holds under concurrency: pass the caller's `tx`).
+     * `duplicate` when the account already has an item with this `dedupeKey`: nothing is written.
+     */
+    record(item: Item, burst: {
+        max: number;
+        since: Date;
+    }): Promise<{
+        duplicate: boolean;
+        capped: boolean;
+    }>;
+    /** The account's explicit choices. */
+    preferences(accountId: string): Promise<{
+        category: string;
+        channel: Channel;
+        enabled: boolean;
+    }[]>;
+    setPreference(accountId: string, category: string, channel: Channel, enabled: boolean, now: Date): Promise<void>;
+    /** Items shown in the bell, newest first; `before` is the cursor (the last item of the previous page). */
+    list(accountId: string, options: {
+        unreadOnly: boolean;
+        limit: number;
+        before?: {
+            createdAt: Date;
+            id: string;
+        };
+    }): Promise<Item[]>;
+    unreadCount(accountId: string): Promise<number>;
+    /** 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. */
+    markRead(accountId: string, ids: readonly string[] | null, now: Date): Promise<number>;
+    /** A token belongs to one account: registering it again moves it, and brings back a revoked one. */
+    upsertDevice(device: Device): Promise<void>;
+    devices(accountId: string): Promise<Device[]>;
+    /** The push service said the token is dead. */
+    revokeDevice(token: string, now: Date): Promise<boolean>;
+    purgeBefore(before: Date): Promise<number>;
+    /** Removes everything held about the account. Returns how many rows. */
+    erase(accountId: string): Promise<number>;
+}
+declare const NOTIFICATION_CODE: {
+    readonly badCategory: "NOTIFICATIONS_BAD_CATEGORY";
+    readonly badInput: "NOTIFICATIONS_BAD_INPUT";
+    readonly locked: "NOTIFICATIONS_LOCKED";
+    readonly badConfig: "NOTIFICATIONS_BAD_CONFIG";
+};
+type NotificationCode = (typeof NOTIFICATION_CODE)[keyof typeof NOTIFICATION_CODE];
+declare class NotificationError extends Error {
+    readonly code: NotificationCode;
+    constructor(code: NotificationCode, message: string);
+}
+
+export { type Channel as C, type Delivery as D, type Item as I, type NotificationStore as N, type Platform as P, type NotificationConfig as a, type CategoryDefaults as b, type Device as c, CHANNEL as d, CHANNELS as e, DELIVERY as f, NOTIFICATION_CODE as g, type NotificationCode as h, NotificationError as i, PLATFORM as j };

package/dist/settings.d.ts

@@ -0,0 +1,30 @@
+import { Registry } from '@krizaka/settings';
+import { C as Channel, a as NotificationConfig } from './port-DptCmYwy.js';
+
+/** What a product declares for a category; the admin tunes the values (except `locked`, which is code). */
+interface CategoryDeclaration {
+    /** Cannot be switched off by the account or the admin (security, the account). Its channels are exactly `defaults`. */
+    locked?: boolean;
+    defaults: Record<Channel, boolean>;
+    burst?: {
+        max: number;
+        windowSeconds: number;
+    };
+}
+type Declared = Record<string, CategoryDeclaration>;
+/**
+ * The settings of « notifications » for the categories a product declares, a fragment it adds to its registry
+ * (`@krizaka/notifications/settings`): for each category the channels on by default (`notifications.<category>.<channel>`, not for a
+ * locked category) and its burst cap (`notifications.<category>.burstMax`, `burstWindowSeconds`), plus `notifications.retentionDays`.
+ * The admin changes them without a redeploy.
+ * @throws NotificationError when a category name is not a camel-case word
+ */
+declare function notificationSettings(declared: Declared): Registry;
+type Reader = (key: string) => boolean | number | undefined | Promise<boolean | number | undefined>;
+/**
+ * The module's configuration as `createNotifications` takes it, from the product's accessor (`(key) => service.get(key, ctx)`).
+ * A key the accessor does not know falls back to what the product declared.
+ */
+declare function readNotificationConfig(declared: Declared, read: Reader): Promise<NotificationConfig>;
+
+export { type CategoryDeclaration, type Declared, notificationSettings, readNotificationConfig };

package/dist/settings.js

@@ -0,0 +1,52 @@
+import {
+  CATEGORY_NAME,
+  NOTIFICATION_BOUNDS,
+  NOTIFICATION_DEFAULTS
+} from "./chunk-2MH7PZDT.js";
+import {
+  CHANNELS,
+  NOTIFICATION_CODE,
+  NotificationError
+} from "./chunk-FQYNUK64.js";
+
+// src/settings.ts
+import { flag, integer } from "@krizaka/settings";
+var burstOf = (d) => d.burst ?? { max: NOTIFICATION_DEFAULTS.burstMax, windowSeconds: NOTIFICATION_DEFAULTS.burstWindowSeconds };
+function notificationSettings(declared) {
+  const registry = {
+    "notifications.retentionDays": integer("notifications", NOTIFICATION_DEFAULTS.retentionDays, { min: NOTIFICATION_BOUNDS.retentionDays[0], max: NOTIFICATION_BOUNDS.retentionDays[1], unit: "days" })
+  };
+  for (const [name, d] of Object.entries(declared)) {
+    if (!CATEGORY_NAME.test(name)) throw new NotificationError(NOTIFICATION_CODE.badConfig, `category \xAB ${name} \xBB must be a camel-case word`);
+    const group = `notifications.${name}`;
+    if (!d.locked) for (const channel of CHANNELS) registry[`notifications.${name}.${channel}`] = flag(group, d.defaults[channel]);
+    const burst = burstOf(d);
+    registry[`notifications.${name}.burstMax`] = integer(group, burst.max, { min: NOTIFICATION_BOUNDS.burstMax[0], max: NOTIFICATION_BOUNDS.burstMax[1], unit: "notifications" });
+    registry[`notifications.${name}.burstWindowSeconds`] = integer(group, burst.windowSeconds, { min: NOTIFICATION_BOUNDS.burstWindowSeconds[0], max: NOTIFICATION_BOUNDS.burstWindowSeconds[1], unit: "seconds" });
+  }
+  return registry;
+}
+async function readNotificationConfig(declared, read) {
+  const number = async (key, fallback) => {
+    const value = await read(key);
+    return typeof value === "number" ? value : fallback;
+  };
+  const categories = {};
+  for (const [name, d] of Object.entries(declared)) {
+    const defaults = { ...d.defaults };
+    if (!d.locked) {
+      for (const channel of CHANNELS) {
+        const value = await read(`notifications.${name}.${channel}`);
+        if (typeof value === "boolean") defaults[channel] = value;
+      }
+    }
+    const burst = burstOf(d);
+    categories[name] = { locked: d.locked ?? false, defaults, burstMax: await number(`notifications.${name}.burstMax`, burst.max), burstWindowSeconds: await number(`notifications.${name}.burstWindowSeconds`, burst.windowSeconds) };
+  }
+  return { categories, retentionDays: await number("notifications.retentionDays", NOTIFICATION_DEFAULTS.retentionDays) };
+}
+export {
+  notificationSettings,
+  readNotificationConfig
+};
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/settings.ts"],"sourcesContent":["import { flag, integer, type Registry } from \"@krizaka/settings\";\n\nimport { CHANNELS, type NotificationConfig } from \"./port\";\nimport { type Channel, NOTIFICATION_CODE, NotificationError } from \"./port\";\nimport { CATEGORY_NAME, NOTIFICATION_BOUNDS, NOTIFICATION_DEFAULTS } from \"./rules\";\n\n/** What a product declares for a category; the admin tunes the values (except `locked`, which is code). */\nexport interface CategoryDeclaration {\n  /** Cannot be switched off by the account or the admin (security, the account). Its channels are exactly `defaults`. */\n  locked?: boolean;\n  defaults: Record<Channel, boolean>;\n  burst?: { max: number; windowSeconds: number };\n}\n\nexport type Declared = Record<string, CategoryDeclaration>;\n\nconst burstOf = (d: CategoryDeclaration) => d.burst ?? { max: NOTIFICATION_DEFAULTS.burstMax, windowSeconds: NOTIFICATION_DEFAULTS.burstWindowSeconds };\n\n/**\n * The settings of « notifications » for the categories a product declares, a fragment it adds to its registry\n * (`@krizaka/notifications/settings`): for each category the channels on by default (`notifications.<category>.<channel>`, not for a\n * locked category) and its burst cap (`notifications.<category>.burstMax`, `burstWindowSeconds`), plus `notifications.retentionDays`.\n * The admin changes them without a redeploy.\n * @throws NotificationError when a category name is not a camel-case word\n */\nexport function notificationSettings(declared: Declared): Registry {\n  const registry: Registry = {\n    \"notifications.retentionDays\": integer(\"notifications\", NOTIFICATION_DEFAULTS.retentionDays, { min: NOTIFICATION_BOUNDS.retentionDays[0], max: NOTIFICATION_BOUNDS.retentionDays[1], unit: \"days\" }),\n  };\n  for (const [name, d] of Object.entries(declared)) {\n    if (!CATEGORY_NAME.test(name)) throw new NotificationError(NOTIFICATION_CODE.badConfig, `category « ${name} » must be a camel-case word`);\n    const group = `notifications.${name}`;\n    if (!d.locked) for (const channel of CHANNELS) registry[`notifications.${name}.${channel}`] = flag(group, d.defaults[channel]);\n    const burst = burstOf(d);\n    registry[`notifications.${name}.burstMax`] = integer(group, burst.max, { min: NOTIFICATION_BOUNDS.burstMax[0], max: NOTIFICATION_BOUNDS.burstMax[1], unit: \"notifications\" });\n    registry[`notifications.${name}.burstWindowSeconds`] = integer(group, burst.windowSeconds, { min: NOTIFICATION_BOUNDS.burstWindowSeconds[0], max: NOTIFICATION_BOUNDS.burstWindowSeconds[1], unit: \"seconds\" });\n  }\n  return registry;\n}\n\ntype Reader = (key: string) => boolean | number | undefined | Promise<boolean | number | undefined>;\n\n/**\n * The module's configuration as `createNotifications` takes it, from the product's accessor (`(key) => service.get(key, ctx)`).\n * A key the accessor does not know falls back to what the product declared.\n */\nexport async function readNotificationConfig(declared: Declared, read: Reader): Promise<NotificationConfig> {\n  const number = async (key: string, fallback: number) => {\n    const value = await read(key);\n    return typeof value === \"number\" ? value : fallback;\n  };\n  const categories: NotificationConfig[\"categories\"] = {};\n  for (const [name, d] of Object.entries(declared)) {\n    const defaults = { ...d.defaults };\n    if (!d.locked) {\n      for (const channel of CHANNELS) {\n        const value = await read(`notifications.${name}.${channel}`);\n        if (typeof value === \"boolean\") defaults[channel] = value;\n      }\n    }\n    const burst = burstOf(d);\n    categories[name] = { locked: d.locked ?? false, defaults, burstMax: await number(`notifications.${name}.burstMax`, burst.max), burstWindowSeconds: await number(`notifications.${name}.burstWindowSeconds`, burst.windowSeconds) };\n  }\n  return { categories, retentionDays: await number(\"notifications.retentionDays\", NOTIFICATION_DEFAULTS.retentionDays) };\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,MAAM,eAA8B;AAgB7C,IAAM,UAAU,CAAC,MAA2B,EAAE,SAAS,EAAE,KAAK,sBAAsB,UAAU,eAAe,sBAAsB,mBAAmB;AAS/I,SAAS,qBAAqB,UAA8B;AACjE,QAAM,WAAqB;AAAA,IACzB,+BAA+B,QAAQ,iBAAiB,sBAAsB,eAAe,EAAE,KAAK,oBAAoB,cAAc,CAAC,GAAG,KAAK,oBAAoB,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC;AAAA,EACrM;AACA,aAAW,CAAC,MAAM,CAAC,KAAK,OAAO,QAAQ,QAAQ,GAAG;AAChD,QAAI,CAAC,cAAc,KAAK,IAAI,EAAG,OAAM,IAAI,kBAAkB,kBAAkB,WAAW,iBAAc,IAAI,iCAA8B;AACxI,UAAM,QAAQ,iBAAiB,IAAI;AACnC,QAAI,CAAC,EAAE,OAAQ,YAAW,WAAW,SAAU,UAAS,iBAAiB,IAAI,IAAI,OAAO,EAAE,IAAI,KAAK,OAAO,EAAE,SAAS,OAAO,CAAC;AAC7H,UAAM,QAAQ,QAAQ,CAAC;AACvB,aAAS,iBAAiB,IAAI,WAAW,IAAI,QAAQ,OAAO,MAAM,KAAK,EAAE,KAAK,oBAAoB,SAAS,CAAC,GAAG,KAAK,oBAAoB,SAAS,CAAC,GAAG,MAAM,gBAAgB,CAAC;AAC5K,aAAS,iBAAiB,IAAI,qBAAqB,IAAI,QAAQ,OAAO,MAAM,eAAe,EAAE,KAAK,oBAAoB,mBAAmB,CAAC,GAAG,KAAK,oBAAoB,mBAAmB,CAAC,GAAG,MAAM,UAAU,CAAC;AAAA,EAChN;AACA,SAAO;AACT;AAQA,eAAsB,uBAAuB,UAAoB,MAA2C;AAC1G,QAAM,SAAS,OAAO,KAAa,aAAqB;AACtD,UAAM,QAAQ,MAAM,KAAK,GAAG;AAC5B,WAAO,OAAO,UAAU,WAAW,QAAQ;AAAA,EAC7C;AACA,QAAM,aAA+C,CAAC;AACtD,aAAW,CAAC,MAAM,CAAC,KAAK,OAAO,QAAQ,QAAQ,GAAG;AAChD,UAAM,WAAW,EAAE,GAAG,EAAE,SAAS;AACjC,QAAI,CAAC,EAAE,QAAQ;AACb,iBAAW,WAAW,UAAU;AAC9B,cAAM,QAAQ,MAAM,KAAK,iBAAiB,IAAI,IAAI,OAAO,EAAE;AAC3D,YAAI,OAAO,UAAU,UAAW,UAAS,OAAO,IAAI;AAAA,MACtD;AAAA,IACF;AACA,UAAM,QAAQ,QAAQ,CAAC;AACvB,eAAW,IAAI,IAAI,EAAE,QAAQ,EAAE,UAAU,OAAO,UAAU,UAAU,MAAM,OAAO,iBAAiB,IAAI,aAAa,MAAM,GAAG,GAAG,oBAAoB,MAAM,OAAO,iBAAiB,IAAI,uBAAuB,MAAM,aAAa,EAAE;AAAA,EACnO;AACA,SAAO,EAAE,YAAY,eAAe,MAAM,OAAO,+BAA+B,sBAAsB,aAAa,EAAE;AACvH;","names":[]}

package/dist/testkit.d.ts

@@ -0,0 +1,10 @@
+import { I as Item, N as NotificationStore } from './port-DptCmYwy.js';
+
+declare const T0: Date;
+declare const at: (seconds: number) => Date;
+/** An item for tests; the account ids are UUIDs because the database's are. */
+declare const itemOf: (accountId: string, over?: Partial<Item>) => Item;
+/** What every `NotificationStore` adapter must do: the same behaviour behind the same port. `make` gives an empty store whose accounts exist. */
+declare function notificationStoreContract(name: string, make: () => NotificationStore | Promise<NotificationStore>, accountId: () => string | Promise<string>): void;
+
+export { T0, at, itemOf, notificationStoreContract };