@nubisco/openbridge 1.5.2 → 1.7.0

package/dist/notification-routes.js

@@ -0,0 +1,37 @@
+import { readSession } from './auth.js';
+import { LOCAL_USER } from './notifications.js';
+export function notificationUser(authConfig, req) {
+    if (!authConfig)
+        return LOCAL_USER;
+    return readSession(authConfig, req)?.userId ?? LOCAL_USER;
+}
+export function registerNotificationRoutes(app, store, authConfig) {
+    app.get('/api/notifications', async (req) => {
+        const limit = Number(req.query.limit ?? 50);
+        return store.list(notificationUser(authConfig, req), Number.isFinite(limit) ? limit : 50);
+    });
+    app.post('/api/notifications/read', async (req) => {
+        const raw = req.body?.ids;
+        const ids = Array.isArray(raw) ? raw.filter((id) => typeof id === 'string') : undefined;
+        return { unread: store.markRead(notificationUser(authConfig, req), ids) };
+    });
+    app.get('/ws/notifications', { websocket: true }, (ws, req) => {
+        const userId = notificationUser(authConfig, req);
+        const unsubscribe = store.subscribe((event) => {
+            // A row added reaches everybody. Somebody reading reaches only their
+            // own other tabs, whose badge just went stale.
+            if (event.type === 'read' && event.userId !== userId)
+                return;
+            if (ws.readyState !== ws.OPEN)
+                return;
+            try {
+                ws.send(JSON.stringify({ type: 'changed' }));
+            }
+            catch {
+                /* disconnected */
+            }
+        });
+        ws.on('close', unsubscribe);
+    });
+}
+//# sourceMappingURL=notification-routes.js.map

package/dist/notification-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-routes.js","sourceRoot":"","sources":["../src/notification-routes.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,WAAW,EAAoB,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,UAAU,EAA0B,MAAM,oBAAoB,CAAA;AAEvE,MAAM,UAAU,gBAAgB,CAAC,UAA8B,EAAE,GAAmB;IAClF,IAAI,CAAC,UAAU;QAAE,OAAO,UAAU,CAAA;IAClC,OAAO,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,IAAI,UAAU,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,GAAoB,EACpB,KAAwB,EACxB,UAA8B;IAE9B,GAAG,CAAC,GAAG,CAAsC,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC3F,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,IAAI,CAA0C,yBAAyB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACzF,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,CAAA;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACrG,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,EAAa,EAAE,GAAG,EAAE,EAAE;QACvE,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QAChD,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5C,qEAAqE;YACrE,+CAA+C;YAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;gBAAE,OAAM;YAC5D,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,IAAI;gBAAE,OAAM;YACrC,IAAI,CAAC;gBACH,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC,CAAC,CAAA;QACF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/notifications.d.ts

@@ -0,0 +1,157 @@
+import type { DeviceHealth, PluginStatus } from '@nubisco/openbridge-core';
+/** Newest rows kept. Older ones fall off the end. */
+export declare const MAX_NOTIFICATIONS = 200;
+/**
+ * How long a device must be silent, continuously, before the bell rings.
+ *
+ * Ten minutes, set by Jose. Long enough that a router reboot or a slow poll
+ * never rings, short enough that a gate that has fallen off the network is
+ * noticed the same evening rather than from HomeKit a day later.
+ */
+export declare const OFFLINE_AFTER_SECONDS: number;
+/** The person whose read state is kept when sign-in is off. */
+export declare const LOCAL_USER = "local";
+export type NotificationKind = 'device.offline' | 'device.online' | 'plugin.failed' | 'update.openbridge' | 'update.plugin';
+/** Colour by consequence: warning needs doing, success is relief, info is news. */
+export type NotificationVariant = 'warning' | 'success' | 'info';
+/** Where a row opens. Null makes the row honestly inert. */
+export type NotificationTarget = {
+    kind: 'device';
+    id: string;
+} | {
+    kind: 'plugin';
+    id: string;
+} | {
+    kind: 'settings';
+} | {
+    kind: 'config';
+};
+export interface StoredNotification {
+    id: string;
+    kind: NotificationKind;
+    title: string;
+    body: string;
+    variant: NotificationVariant;
+    target: NotificationTarget | null;
+    createdAt: string;
+}
+export interface NotificationView extends StoredNotification {
+    read: boolean;
+}
+export interface NotificationInput {
+    /** The thing and the state that justified it. Announced at most once. */
+    key: string;
+    kind: NotificationKind;
+    title: string;
+    body: string;
+    variant: NotificationVariant;
+    target: NotificationTarget | null;
+}
+interface Outage {
+    /** When the device last answered, which is when the outage began. */
+    since: string;
+}
+export declare class NotificationStore {
+    private readonly path;
+    private readonly clock;
+    private state;
+    private listeners;
+    constructor(path: string, clock?: () => number);
+    /**
+     * Add a row, unless its key has been announced before.
+     *
+     * Returns the row, or null when nothing was written. Never throws: the bell
+     * is a report about the bridge, and failing to write one must not take down
+     * the thing it reports on.
+     */
+    add(input: NotificationInput): StoredNotification | null;
+    /** The newest rows as one person sees them, and their unread count over every row. */
+    list(userId: string, limit?: number): {
+        notifications: NotificationView[];
+        unread: number;
+    };
+    /**
+     * The badge. Counted over every stored row, never over the page the client
+     * happened to load, which is how Acta's badge came to understate.
+     */
+    unreadCount(userId: string): number;
+    /** Mark some rows read for one person, or all of them when no ids are given. */
+    markRead(userId: string, ids?: string[]): number;
+    /** Told about every write, for live delivery to open tabs. */
+    subscribe(listener: (event: {
+        type: 'added' | 'read';
+        userId?: string;
+    }) => void): () => void;
+    outage(deviceId: string): Outage | undefined;
+    setOutage(deviceId: string, outage: Outage | null): void;
+    failing(key: string): string | undefined;
+    setFailing(key: string, error: string | null): void;
+    private pruneReadState;
+    private emit;
+    private load;
+    private save;
+}
+export interface ObservedDevice {
+    id: string;
+    name: string;
+    pluginStatus: string;
+    health: DeviceHealth;
+}
+/**
+ * Turn device health, read on every tick, into one row when a device crosses
+ * the line and one when it comes back.
+ *
+ * Health is derived from the `_updatedAt` stamp `reportTelemetry` writes for
+ * every device of every native plugin (see device-health.ts), so this needs no
+ * cooperation from plugins. A device of a plugin that is not running is
+ * skipped: the plugin's own failure explains all of its devices at once, and
+ * thirty rows saying "not responding" would bury the one that says why.
+ */
+export declare function observeDevices(store: NotificationStore, devices: ObservedDevice[], now: number): void;
+export interface ObservedPlugin {
+    id: string;
+    name: string;
+    status: PluginStatus;
+    error?: string;
+    disabled?: boolean;
+}
+/**
+ * One row when a plugin enters the error state, and none while it stays
+ * there or is retried and fails the same way again.
+ *
+ * Cleared once the plugin runs, so a crash after a recovery is news again.
+ * The failing set is stored, so a plugin that fails the same way at every
+ * start does not ring again on every restart of the daemon.
+ */
+export declare function observePlugins(store: NotificationStore, plugins: ObservedPlugin[], now: number): void;
+/**
+ * A plugin that could not be loaded at all.
+ *
+ * Distinct from the error state above: a module that throws on import never
+ * reaches the registry as a running plugin, so there is no status to watch.
+ * The daemon calls this from the places it catches the failure.
+ */
+export declare function pluginLoadFailed(store: NotificationStore, plugin: {
+    key: string;
+    name: string;
+    target: NotificationTarget | null;
+}, err: unknown, now: number): void;
+/** The counterpart: a plugin that loaded is no longer failing to. */
+export declare function pluginLoaded(store: NotificationStore, pluginKey: string): void;
+/**
+ * Whether `latest` is newer than `current`, by numeric dotted version.
+ *
+ * Not `!==`: a development build ahead of npm would otherwise be told to
+ * "update" to an older release.
+ */
+export declare function isNewer(latest: string, current: string): boolean;
+/** One row per new OpenBridge version, however often the check runs. */
+export declare function openBridgeUpdate(store: NotificationStore, current: string, latest: string | null): void;
+/** One row per new plugin version, however often the check runs. */
+export declare function pluginUpdate(store: NotificationStore, plugin: {
+    id: string;
+    name: string;
+    current: string;
+}, latest: string): void;
+export {};
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

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

package/dist/notifications.js

@@ -0,0 +1,364 @@
+/**
+ * The bell: things that happened to the bridge that a person should hear about.
+ *
+ * A household bridge produces a great deal of chatter (every poll, every
+ * reading) and a handful of events. Only events reach the bell: a device that
+ * has stopped answering for long enough to matter, the same device coming
+ * back, a plugin that failed, and an update worth installing. Everything else
+ * stays in the device timeline and the log, where it already is.
+ *
+ * Follows "Notifications: Acta's system is the fleet standard" in the
+ * workspace AGENTS.md, adapted to a bridge:
+ *
+ * - Rows are about the house, not about one person, so every row reaches
+ *   everybody who signs in. What is per person is whether they have read it.
+ * - A write that changes nothing tells nobody. Every row carries a key built
+ *   from the thing and the state that justified it, and a key is announced
+ *   once, ever. Re-checking for updates every six hours finds the same
+ *   version and rings for nobody.
+ * - The chasing half (reminder email) does not apply. OpenBridge has no email
+ *   channel, and with nothing configured the queue is left alone.
+ *
+ * Stored as one small JSON file, capped, because the whole history a person
+ * scrolls through is a few hundred rows and a database would be heavier than
+ * the feature.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+import { randomUUID } from 'crypto';
+/** Newest rows kept. Older ones fall off the end. */
+export const MAX_NOTIFICATIONS = 200;
+/** Most announced keys remembered, so the file stays bounded too. */
+const MAX_ANNOUNCED = 2000;
+/**
+ * How long a device must be silent, continuously, before the bell rings.
+ *
+ * Ten minutes, set by Jose. Long enough that a router reboot or a slow poll
+ * never rings, short enough that a gate that has fallen off the network is
+ * noticed the same evening rather than from HomeKit a day later.
+ */
+export const OFFLINE_AFTER_SECONDS = 10 * 60;
+/** The person whose read state is kept when sign-in is off. */
+export const LOCAL_USER = 'local';
+function empty() {
+    return { notifications: [], readBy: {}, announced: [], outages: {}, failing: {} };
+}
+export class NotificationStore {
+    path;
+    clock;
+    state;
+    listeners = new Set();
+    constructor(path, clock = Date.now) {
+        this.path = path;
+        this.clock = clock;
+        this.state = this.load();
+    }
+    /**
+     * Add a row, unless its key has been announced before.
+     *
+     * Returns the row, or null when nothing was written. Never throws: the bell
+     * is a report about the bridge, and failing to write one must not take down
+     * the thing it reports on.
+     */
+    add(input) {
+        if (this.state.announced.includes(input.key))
+            return null;
+        const row = {
+            id: randomUUID(),
+            kind: input.kind,
+            title: input.title,
+            body: input.body,
+            variant: input.variant,
+            target: input.target,
+            createdAt: new Date(this.clock()).toISOString(),
+        };
+        this.state.notifications.unshift(row);
+        this.state.notifications.length = Math.min(this.state.notifications.length, MAX_NOTIFICATIONS);
+        this.state.announced.push(input.key);
+        if (this.state.announced.length > MAX_ANNOUNCED) {
+            this.state.announced.splice(0, this.state.announced.length - MAX_ANNOUNCED);
+        }
+        this.pruneReadState();
+        this.save();
+        this.emit({ type: 'added' });
+        return row;
+    }
+    /** The newest rows as one person sees them, and their unread count over every row. */
+    list(userId, limit = 50) {
+        const read = new Set(this.state.readBy[userId] ?? []);
+        const capped = Math.min(Math.max(1, Math.floor(limit) || 50), MAX_NOTIFICATIONS);
+        const notifications = this.state.notifications.slice(0, capped).map((n) => ({ ...n, read: read.has(n.id) }));
+        return { notifications, unread: this.unreadCount(userId) };
+    }
+    /**
+     * The badge. Counted over every stored row, never over the page the client
+     * happened to load, which is how Acta's badge came to understate.
+     */
+    unreadCount(userId) {
+        const read = new Set(this.state.readBy[userId] ?? []);
+        return this.state.notifications.filter((n) => !read.has(n.id)).length;
+    }
+    /** Mark some rows read for one person, or all of them when no ids are given. */
+    markRead(userId, ids) {
+        const known = new Set(this.state.notifications.map((n) => n.id));
+        const read = new Set(this.state.readBy[userId] ?? []);
+        const before = read.size;
+        for (const id of ids ?? known)
+            if (known.has(id))
+                read.add(id);
+        if (read.size !== before) {
+            this.state.readBy[userId] = [...read];
+            this.save();
+            this.emit({ type: 'read', userId });
+        }
+        return this.unreadCount(userId);
+    }
+    /** Told about every write, for live delivery to open tabs. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    // ─── State the watchers keep across restarts ─────────────────────────────
+    outage(deviceId) {
+        return this.state.outages[deviceId];
+    }
+    setOutage(deviceId, outage) {
+        if (outage)
+            this.state.outages[deviceId] = outage;
+        else
+            delete this.state.outages[deviceId];
+        this.save();
+    }
+    failing(key) {
+        return this.state.failing[key];
+    }
+    setFailing(key, error) {
+        if (error === null) {
+            if (!(key in this.state.failing))
+                return;
+            delete this.state.failing[key];
+        }
+        else {
+            this.state.failing[key] = error;
+        }
+        this.save();
+    }
+    pruneReadState() {
+        const known = new Set(this.state.notifications.map((n) => n.id));
+        for (const [user, ids] of Object.entries(this.state.readBy)) {
+            this.state.readBy[user] = ids.filter((id) => known.has(id));
+        }
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                /* one closed tab must not stop the others hearing */
+            }
+        }
+    }
+    load() {
+        try {
+            if (!existsSync(this.path))
+                return empty();
+            const raw = JSON.parse(readFileSync(this.path, 'utf8'));
+            return {
+                notifications: Array.isArray(raw.notifications) ? raw.notifications : [],
+                readBy: raw.readBy && typeof raw.readBy === 'object' ? raw.readBy : {},
+                announced: Array.isArray(raw.announced) ? raw.announced : [],
+                outages: raw.outages && typeof raw.outages === 'object' ? raw.outages : {},
+                failing: raw.failing && typeof raw.failing === 'object' ? raw.failing : {},
+            };
+        }
+        catch {
+            // A corrupt file costs the history, not the bridge.
+            return empty();
+        }
+    }
+    save() {
+        try {
+            mkdirSync(dirname(this.path), { recursive: true });
+            // Written aside and renamed, so a power cut mid-write leaves the old
+            // file rather than half of a new one.
+            const tmp = `${this.path}.tmp`;
+            writeFileSync(tmp, JSON.stringify(this.state));
+            renameSync(tmp, this.path);
+        }
+        catch {
+            /* the bell must not break the bridge it reports on */
+        }
+    }
+}
+function humanDuration(seconds) {
+    if (seconds < 90)
+        return `${Math.round(seconds)} seconds`;
+    const minutes = seconds / 60;
+    if (minutes < 90)
+        return `${Math.round(minutes)} minutes`;
+    const hours = minutes / 60;
+    if (hours < 48)
+        return `${Math.round(hours)} hours`;
+    return `${Math.round(hours / 24)} days`;
+}
+/**
+ * Turn device health, read on every tick, into one row when a device crosses
+ * the line and one when it comes back.
+ *
+ * Health is derived from the `_updatedAt` stamp `reportTelemetry` writes for
+ * every device of every native plugin (see device-health.ts), so this needs no
+ * cooperation from plugins. A device of a plugin that is not running is
+ * skipped: the plugin's own failure explains all of its devices at once, and
+ * thirty rows saying "not responding" would bury the one that says why.
+ */
+export function observeDevices(store, devices, now) {
+    for (const device of devices) {
+        if (device.pluginStatus !== 'running')
+            continue;
+        const { health } = device;
+        const open = store.outage(device.id);
+        if (!open) {
+            // Stale already allows for the device's own interval, so a device that
+            // reports every five minutes is not accused at ten. The ten minutes are
+            // a floor on top of that, not a replacement for it.
+            const silent = health.silentForSeconds ?? 0;
+            if (health.status !== 'stale' || !health.lastSeen || silent < OFFLINE_AFTER_SECONDS)
+                continue;
+            store.setOutage(device.id, { since: health.lastSeen });
+            store.add({
+                key: `device.offline:${device.id}:${health.lastSeen}`,
+                kind: 'device.offline',
+                title: `${device.name} is not responding`,
+                body: `No response for ${humanDuration(silent)}. It may be powered off, or its address may have changed.`,
+                variant: 'warning',
+                target: { kind: 'device', id: device.id },
+            });
+            continue;
+        }
+        if (health.status === 'ok') {
+            store.setOutage(device.id, null);
+            const back = health.lastSeen ? Date.parse(health.lastSeen) : now;
+            const outageSeconds = Math.max(0, (back - Date.parse(open.since)) / 1000);
+            store.add({
+                key: `device.online:${device.id}:${open.since}`,
+                kind: 'device.online',
+                title: `${device.name} is back online`,
+                body: `It answered again after ${humanDuration(outageSeconds)} without a response.`,
+                variant: 'success',
+                target: { kind: 'device', id: device.id },
+            });
+        }
+    }
+}
+/**
+ * One row when a plugin enters the error state, and none while it stays
+ * there or is retried and fails the same way again.
+ *
+ * Cleared once the plugin runs, so a crash after a recovery is news again.
+ * The failing set is stored, so a plugin that fails the same way at every
+ * start does not ring again on every restart of the daemon.
+ */
+export function observePlugins(store, plugins, now) {
+    for (const plugin of plugins) {
+        const key = `plugin:${plugin.id}`;
+        if (plugin.status === 'running') {
+            store.setFailing(key, null);
+            continue;
+        }
+        if (plugin.status !== 'error' || plugin.disabled)
+            continue;
+        const error = plugin.error?.trim() || 'It stopped with an error.';
+        if (store.failing(key) !== undefined)
+            continue;
+        store.setFailing(key, error);
+        store.add({
+            key: `plugin.failed:${plugin.id}:${now}`,
+            kind: 'plugin.failed',
+            title: `${plugin.name} stopped working`,
+            body: firstLine(error),
+            variant: 'warning',
+            target: { kind: 'plugin', id: plugin.id },
+        });
+    }
+}
+/**
+ * A plugin that could not be loaded at all.
+ *
+ * Distinct from the error state above: a module that throws on import never
+ * reaches the registry as a running plugin, so there is no status to watch.
+ * The daemon calls this from the places it catches the failure.
+ */
+export function pluginLoadFailed(store, plugin, err, now) {
+    const error = firstLine(err instanceof Error ? err.message : String(err));
+    const key = `load:${plugin.key}`;
+    if (store.failing(key) === error)
+        return;
+    store.setFailing(key, error);
+    store.add({
+        key: `plugin.failed:${key}:${now}`,
+        kind: 'plugin.failed',
+        title: `${plugin.name} could not be loaded`,
+        body: error,
+        variant: 'warning',
+        target: plugin.target,
+    });
+}
+/** The counterpart: a plugin that loaded is no longer failing to. */
+export function pluginLoaded(store, pluginKey) {
+    store.setFailing(`load:${pluginKey}`, null);
+}
+function firstLine(text) {
+    const line = text.split('\n')[0]?.trim() ?? '';
+    return line.length > 300 ? `${line.slice(0, 297)}...` : line;
+}
+// ─── Updates ────────────────────────────────────────────────────────────────
+/**
+ * Whether `latest` is newer than `current`, by numeric dotted version.
+ *
+ * Not `!==`: a development build ahead of npm would otherwise be told to
+ * "update" to an older release.
+ */
+export function isNewer(latest, current) {
+    const parse = (v) => v
+        .replace(/^v/, '')
+        .split('-')[0]
+        .split('.')
+        .map((part) => Number.parseInt(part, 10) || 0);
+    const a = parse(latest);
+    const b = parse(current);
+    for (let i = 0; i < Math.max(a.length, b.length); i++) {
+        const x = a[i] ?? 0;
+        const y = b[i] ?? 0;
+        if (x !== y)
+            return x > y;
+    }
+    return false;
+}
+/** One row per new OpenBridge version, however often the check runs. */
+export function openBridgeUpdate(store, current, latest) {
+    if (!latest || !isNewer(latest, current))
+        return;
+    store.add({
+        key: `update.openbridge:${latest}`,
+        kind: 'update.openbridge',
+        title: `OpenBridge v${latest} is available`,
+        body: `You are on v${current}.`,
+        variant: 'info',
+        target: { kind: 'settings' },
+    });
+}
+/** One row per new plugin version, however often the check runs. */
+export function pluginUpdate(store, plugin, latest) {
+    if (!isNewer(latest, plugin.current))
+        return;
+    store.add({
+        key: `update.plugin:${plugin.name}:${latest}`,
+        kind: 'update.plugin',
+        title: `${plugin.name} v${latest} is available`,
+        body: `You are on v${plugin.current}.`,
+        variant: 'info',
+        target: { kind: 'plugin', id: plugin.id },
+    });
+}
+//# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

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

package/dist/server.d.ts

@@ -1,6 +1,7 @@
 import Fastify from 'fastify';
 import type { PluginRegistry } from '@nubisco/openbridge-core';
 import type { HomebridgeAPI } from '@nubisco/openbridge-compatibility-homebridge';
+import { type NotificationStore } from './notifications.js';
 import { OPENBRIDGE_VERSION } from './version.js';
 export { OPENBRIDGE_VERSION };
 import { DeviceEventLog } from './device-events.js';
@@ -42,5 +43,7 @@ observations?: ObservationStore | null,
  * radiators on a sunny afternoon and one the heating worked to reach are the
  * same number and opposite evidence.
  */
-observationContext?: ((deviceId: string) => Record<string, unknown> | undefined) | null): Promise<Fastify.FastifyInstance<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, Fastify.FastifyBaseLogger, Fastify.FastifyTypeProviderDefault>>;
+observationContext?: ((deviceId: string) => Record<string, unknown> | undefined) | null, 
+/** The bell. Absent in tests that do not exercise it, and then no routes are added. */
+notifications?: NotificationStore | null): Promise<Fastify.FastifyInstance<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, Fastify.FastifyBaseLogger, Fastify.FastifyTypeProviderDefault>>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAA;AAa7B,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,0BAA0B,CAAA;AAGtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAA;AAuBjF,OAAO,EAA4B,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAwC7B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAuB,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,2BAA2B,CAAA;AAElC,MAAM,WAAW,OAAO;IACtB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,aAAa,GAAG,IAAW,EACnC,OAAO,GAAE,OAAO,GAAG,IAAW,EAC9B,kBAAkB,GAAE,MAAM,EAAO,EACjC,mBAAmB,GAAE,GAAG,CAAC,MAAM,CAAa,EAC5C,QAAQ,GAAE,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAa,EAC3E,kBAAkB,GAAE,GAAG,CAAC,MAAM,CAAa,EAC3C,iBAAiB,GAAE,iBAAiB,GAAG,IAAW,EAClD,mBAAmB,GAAE,mBAAmB,GAAG,IAAW;AACtD;;;;GAIG;AACH,sBAAsB,GAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC,GAAG,IAAW;AAC5E,4EAA4E;AAC5E,mBAAmB,GAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAW;AACxE,6EAA6E;AAC7E,YAAY,GAAE,cAAc,GAAG,IAAW;AAC1C,+EAA+E;AAC/E,YAAY,GAAE,gBAAgB,GAAG,IAAW;AAC5C;;;;;GAKG;AACH,kBAAkB,GAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GAAG,IAAW,sSAwwD9F"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAA;AAa7B,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,0BAA0B,CAAA;AAGtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAA;AAgBjF,OAAO,EAAkC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAS3F,OAAO,EAA4B,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAwC7B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAuB,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,2BAA2B,CAAA;AAElC,MAAM,WAAW,OAAO;IACtB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,aAAa,GAAG,IAAW,EACnC,OAAO,GAAE,OAAO,GAAG,IAAW,EAC9B,kBAAkB,GAAE,MAAM,EAAO,EACjC,mBAAmB,GAAE,GAAG,CAAC,MAAM,CAAa,EAC5C,QAAQ,GAAE,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAa,EAC3E,kBAAkB,GAAE,GAAG,CAAC,MAAM,CAAa,EAC3C,iBAAiB,GAAE,iBAAiB,GAAG,IAAW,EAClD,mBAAmB,GAAE,mBAAmB,GAAG,IAAW;AACtD;;;;GAIG;AACH,sBAAsB,GAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC,GAAG,IAAW;AAC5E,4EAA4E;AAC5E,mBAAmB,GAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAW;AACxE,6EAA6E;AAC7E,YAAY,GAAE,cAAc,GAAG,IAAW;AAC1C,+EAA+E;AAC/E,YAAY,GAAE,gBAAgB,GAAG,IAAW;AAC5C;;;;;GAKG;AACH,kBAAkB,GAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GAAG,IAAW;AAC7F,uFAAuF;AACvF,aAAa,GAAE,iBAAiB,GAAG,IAAW,sSA4xD/C"}