@12-apps/notifications 4.9.0 → 4.10.0

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export { D as DeliveryStatus, a as NOTIFICATION_CHANNELS, b as NotificationCategory, c as NotificationChannel, d as NotificationContent, e as NotificationEvent, f as NotificationGenerateContext, N as NotificationGenerator, g as NotificationLogger, h as NotificationRecipient, i as NotificationTaxonomy, j as NotificationTransport, T as TransportRecipient, t as taxonomyOf } from './types-BFmAY0P5.js';
-export { N as NotificationGeneratorRegistry, c as createGeneratorRegistry } from './generators-BsuXe8Mp.js';
-export { C as ChannelMatrix, a as ChannelRow, D as DEFAULT_CHANNEL_ROW, I as InboxNotification, L as ListNotificationsResult, N as NotificationMessages, b as NotificationRow, c as NotificationWireMessages, d as defaultChannelMatrix, e as enabledChannelsOf, i as inboxWire, m as mergeChoices, f as mergeStoredRow, g as messagesOf } from './wire-_coV3tJk.js';
+export { D as DeliveryStatus, a as NOTIFICATION_CHANNELS, b as NotificationCategory, c as NotificationChannel, d as NotificationContent, e as NotificationEvent, f as NotificationGenerateContext, N as NotificationGenerator, g as NotificationLogger, h as NotificationRecipient, i as NotificationTaxonomy, j as NotificationTransport, T as TransportRecipient, t as taxonomyOf } from './types-BlqZkCWZ.js';
+export { N as NotificationGeneratorRegistry, c as createGeneratorRegistry } from './generators-qAD4fNPq.js';
+export { C as ChannelMatrix, a as ChannelRow, D as DEFAULT_CHANNEL_ROW, I as InboxNotification, L as ListNotificationsResult, N as NotificationMessages, b as NotificationRow, c as NotificationWireMessages, d as defaultChannelMatrix, e as enabledChannelsOf, i as inboxWire, m as mergeChoices, f as mergeStoredRow, g as messagesOf } from './wire-BG1kuoXX.js';
+export { L as LIVE_PUSH_TAG_PREFIX, a as LIVE_SUBJECT_KEY, b as LiveActivity, c as LiveActivityLane, d as LiveActivityStep, l as liveActivityLane, e as livePushTag } from './live-DYxEFO49.js';
 
 /** Thrown by `notify` when no generator is registered for the event type. */
 declare class UnknownNotificationTypeError extends Error {

package/dist/index.js

@@ -9,17 +9,25 @@ import {
   mergeChoices,
   mergeStoredRow,
   normalizePhoneE164
-} from "./chunk-GGAZOLNN.js";
+} from "./chunk-SWOWHIFE.js";
 import {
   messagesOf
 } from "./chunk-M2TVBVH2.js";
+import {
+  LIVE_PUSH_TAG_PREFIX,
+  LIVE_SUBJECT_KEY,
+  liveActivityLane,
+  livePushTag
+} from "./chunk-RTURLH5U.js";
 import {
   NOTIFICATION_CHANNELS,
   taxonomyOf
-} from "./chunk-BGI4BQ66.js";
+} from "./chunk-6W7INOYQ.js";
 import "./chunk-7QVYU63E.js";
 export {
   DEFAULT_CHANNEL_ROW,
+  LIVE_PUSH_TAG_PREFIX,
+  LIVE_SUBJECT_KEY,
   NOTIFICATION_CHANNELS,
   UnknownNotificationRecipientError,
   UnknownNotificationTypeError,
@@ -27,6 +35,8 @@ export {
   defaultChannelMatrix,
   enabledChannelsOf,
   inboxWire,
+  liveActivityLane,
+  livePushTag,
   mergeChoices,
   mergeStoredRow,
   messagesOf,

package/dist/{jobs-D64B_bg7.d.ts → jobs--fex87-q.d.ts}

@@ -1,5 +1,5 @@
 import { WireJobBlueprint } from '@12-apps/wiring';
-import { A as ApiNotifications } from './create-api-notifications-B-VMezVB.js';
+import { A as ApiNotifications } from './create-api-notifications-CcPYrM3p.js';
 
 /**
  * The two background jobs getting a message out actually needs.

package/dist/live-DYxEFO49.d.ts

@@ -0,0 +1,158 @@
+/**
+ * LIVE ACTIVITIES — the notification centre's second kind of entry.
+ *
+ * An inbox notification is an EVENT: it happened, it is stamped, it is read or
+ * unread, and it is still there tomorrow saying the same thing. A live activity
+ * is ONGOING STATE: it is pinned above the list, it has no read/unread, nobody
+ * deletes it, it updates itself, and it is GONE the moment the thing it tracks
+ * finishes.
+ *
+ * The distinction is not cosmetic. A row that says "your order is on its way",
+ * read an hour later, is a claim about the past presented as news — and the
+ * more reliable the inbox is, the more of those a person accumulates. Somewhere
+ * in that list is the one question they actually have, which is *where is it
+ * now*. A live activity answers that question and then removes itself, which is
+ * the property no amount of better event copy can buy.
+ *
+ * ## This file is domain-free, and that is the whole design
+ *
+ * Nothing here knows what is being tracked. A host publishes activities through
+ * `LiveActivitiesConfig.useActivities` (see `./react/live-config`) and this
+ * package owns the contract, the placement, the rendering and the OS-level
+ * collapse. The package that raises an alert has never been this package's
+ * business — see the `generators` seam — and the thing an alert is ABOUT is not
+ * either.
+ *
+ * ## The lane
+ *
+ * `steps` + `activeStepId` describe a progress lane, because "how far along is
+ * this" is the shape almost every ongoing subject has. Both are optional in
+ * effect: an activity with no lane (`steps: []`, `activeStepId: null`) is a
+ * perfectly good live entry — a heading, a sentence and a timestamp that keeps
+ * moving.
+ */
+/** One stop on a live activity's lane. */
+interface LiveActivityStep {
+    /** Stable across updates — the id is what `activeStepId` names. */
+    id: string;
+    /** What the reader sees under the dot. The HOST's word, in the reader's language. */
+    label: string;
+}
+/** One thing that is happening right now, as the notification centre shows it. */
+interface LiveActivity {
+    /**
+     * Stable for the whole life of the subject.
+     *
+     * The SAME id on every update, because it is the identity of the thing being
+     * tracked and not of the message: the panel keys on it so a stage change
+     * re-renders one card rather than swapping two, and it is what
+     * {@link livePushTag} collapses an OS notification onto.
+     *
+     * **Unique among the activities live at one moment**, for the same reason:
+     * it is the React key and the card's test id. Two activities sharing one
+     * gives a duplicate-key warning and a card that silently shows the wrong
+     * subject.
+     */
+    id: string;
+    /**
+     * Which host concern this belongs to, e.g. `order`, `delivery`, `import`.
+     *
+     * Free-form and never rendered — it exists so a host publishing from two
+     * sources can tell its own activities apart in a test or a log without
+     * parsing `id`.
+     */
+    kind: string;
+    /** The heading — what is happening. */
+    title: string;
+    /** The line under it: the detail that makes the heading actionable, or none. */
+    body: string | null;
+    /** Where tapping the card goes, as a same-origin path. `null` renders no link. */
+    link: string | null;
+    /** The lane, in the order it is walked. Empty when this subject has no lane. */
+    steps: readonly LiveActivityStep[];
+    /**
+     * The stop the subject is AT — one of `steps`, or `null` for a laneless entry.
+     *
+     * An id that names no step is neither, and it is handled rather than trusted:
+     * see {@link liveActivityLane}.
+     */
+    activeStepId: string | null;
+    /**
+     * ISO-8601 — when the subject last MOVED, not when it was last polled.
+     *
+     * A timestamp that advances on every read would render "just now" forever,
+     * which is the one thing a live entry must not say when nothing is happening.
+     */
+    updatedAt: string;
+}
+/** A live activity's lane, resolved for rendering. */
+interface LiveActivityLane {
+    steps: readonly LiveActivityStep[];
+    activeStepId: string;
+    /** Every stop BEFORE the active one — never the active one itself. */
+    completed: ReadonlySet<string>;
+}
+/**
+ * The lane to draw, or `null` when this activity has none to draw.
+ *
+ * Three cases collapse to `null`, and the third is the one worth writing down:
+ * no steps, no active step, and **an active step the lane does not contain**.
+ * That last one is not a theoretical defect — it is what a host produces the
+ * first time a subject reaches a stage the lane was filtered to exclude, and
+ * the symptom is a row of dots with NONE of them lit, which reads as a process
+ * that has stopped. A card with no lane still says what is happening and when
+ * it last moved; a dead lane says the tracking is broken.
+ *
+ * `completed` deliberately stops short of the active stop: a completed step
+ * draws a tick, and ticking the stop the subject is sitting in claims it has
+ * already left.
+ */
+declare function liveActivityLane(activity: LiveActivity): LiveActivityLane | null;
+/**
+ * The reserved `data` key that ties a NOTIFICATION to a live subject.
+ *
+ * A notification and a live activity are different objects with different
+ * lifetimes, and this is the only thing that joins them: a generator whose
+ * event is about something also tracked live puts the activity's id here, and
+ * every channel that can collapse gets to.
+ *
+ *     data: { [LIVE_SUBJECT_KEY]: `order:${orderId}` }
+ *
+ * A plain string on purpose. An object here would grow a second wire contract
+ * inside a column this package stores verbatim.
+ */
+declare const LIVE_SUBJECT_KEY = "liveSubject";
+/**
+ * Namespaces the tray tag, so a live tag does not collide with the ones a host
+ * already uses.
+ *
+ * A convention rather than an enforcement — nothing stops a host emitting its
+ * own `live:`-prefixed tags — but it means the two id spaces have to be made to
+ * meet rather than meeting by accident.
+ */
+declare const LIVE_PUSH_TAG_PREFIX = "live:";
+/**
+ * The OS notification tag for a push about a live subject, or `null` for an
+ * ordinary event.
+ *
+ * ## What the tag buys, and why it is the PWA half of this feature
+ *
+ * A `tag` makes a new notification REPLACE the one already in the tray instead
+ * of stacking under it, and — unless the sender asks otherwise — replace it
+ * *silently*. So a subject that moves through four stages costs one tray entry
+ * and one buzz, and the entry that remains is the CURRENT one. Without it a
+ * phone accumulates one alert per stage, all of them still asserting a stage
+ * the subject has since left; the freshest is at the top and the reader has to
+ * work out that the three below it are history.
+ *
+ * That is as close as the web platform gets to an ongoing/live notification,
+ * and it is the half that reaches a person who does not have the app open —
+ * which is most of the time a live activity is live.
+ *
+ * The id is passed through unchanged: it is the host's, it is already unique
+ * per subject, and a hash would make the tray impossible to reason about from a
+ * log line.
+ */
+declare function livePushTag(data: Readonly<Record<string, unknown>> | null | undefined): string | null;
+
+export { LIVE_PUSH_TAG_PREFIX as L, LIVE_SUBJECT_KEY as a, type LiveActivity as b, type LiveActivityLane as c, type LiveActivityStep as d, livePushTag as e, liveActivityLane as l };

package/dist/manifest/server.d.ts

@@ -1,13 +1,13 @@
 import { EmailPreviewRoute } from '../email/previews/index.js';
 import * as _12_apps_wiring from '@12-apps/wiring';
 import { WireRequest } from '@12-apps/wiring';
-import { N as NotificationsServerConfig, A as ApiNotifications, b as NotificationsRoute } from '../create-api-notifications-B-VMezVB.js';
-import { N as NotificationsJobDeps } from '../jobs-D64B_bg7.js';
+import { N as NotificationsServerConfig, A as ApiNotifications, b as NotificationsRoute } from '../create-api-notifications-CcPYrM3p.js';
+import { N as NotificationsJobDeps } from '../jobs--fex87-q.js';
 import { E as EmailPreviewsConfig } from '../catalog-BOVZ2b-b.js';
-import '../generators-BsuXe8Mp.js';
-import '../types-BFmAY0P5.js';
-import '../wire-_coV3tJk.js';
-import '../web-push-D-ysQd5h.js';
+import '../generators-qAD4fNPq.js';
+import '../types-BlqZkCWZ.js';
+import '../wire-BG1kuoXX.js';
+import '../web-push-Dnyaha2z.js';
 import '../template-Dlt5S54z.js';
 
 /** One `NotificationsRoute` as the wiring contract reads it. */

package/dist/manifest/server.js

@@ -3,13 +3,14 @@ import {
 } from "../chunk-FTFLU6KH.js";
 import {
   NOTIFICATIONS_JOBS
-} from "../chunk-KU4FVOFA.js";
+} from "../chunk-ZIR3ILFH.js";
 import {
   createApiNotifications
-} from "../chunk-KZG7QGFA.js";
-import "../chunk-GGAZOLNN.js";
+} from "../chunk-WVRODNXQ.js";
+import "../chunk-SWOWHIFE.js";
 import "../chunk-M2TVBVH2.js";
-import "../chunk-BGI4BQ66.js";
+import "../chunk-RTURLH5U.js";
+import "../chunk-6W7INOYQ.js";
 import "../chunk-EKUSNUBT.js";
 import {
   __name

package/dist/manifest/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/manifest/server.ts"],"sourcesContent":["/**\n * `@12-apps/notifications/manifest/server` — the server capabilities.\n *\n * `http.create` wraps `createApiNotifications` in a WIRE VIEW, and the reason\n * is one field. `NotificationsRequest` carries `headers` — the contract's\n * `WireRequest` does not, because headers are the adapter's business\n * everywhere else — and exactly one descriptor reads it: push-subscribe takes\n * `user-agent` as the DEVICE HINT it labels a subscription with. Without the\n * view the field would simply be absent at runtime while still type-checking,\n * and every saved device would come back unnamed: a silent quality loss, the\n * failure mode the wiring contract exists to convert into a loud one.\n *\n * So the view derives `headers` from the raw request the contract already\n * carries for the handlers `params`/`query`/`body` cannot serve. A host whose\n * adapter leaves `request` unset still gets a working surface — every route\n * answers, the subscription saves — with an unnamed device, which is the\n * honest degradation for a hint. `@12-apps/notifications/hono` populates it.\n *\n * Everything else rides beside the mapped routes on the aggregate unchanged:\n * `notify`, `notifyByPermission`, `dispatchDeliveries`, `drainPending`, the\n * three stores, `registerGenerator` and the transports registry. A host still\n * calls those directly — being mounted does not make the emit front door stop\n * being a library.\n */\n\nimport type { AnyServerManifest, WireRequest } from '@12-apps/wiring';\n\nimport { emailPreviewRoutes } from '../email/previews/routes';\nimport type { EmailPreviewsConfig } from '../email/previews/catalog';\nimport {\n  createApiNotifications,\n  NOTIFICATIONS_JOBS,\n  type ApiNotifications,\n  type NotificationsRoute,\n  type NotificationsServerConfig,\n} from '../server';\n\n/** The header names this surface reads — the device hint, and nothing else. */\nconst READ_HEADERS = ['user-agent'] as const;\n\n/** The headers the package expects, taken off the raw request when there is one. */\nfunction headersOf(request: WireRequest<never>): Record<string, string | undefined> {\n  const raw = request.request;\n  if (!raw) return {};\n  return Object.fromEntries(\n    READ_HEADERS.map((name) => [name, raw.headers.get(name) ?? undefined]),\n  );\n}\n\n/** One `NotificationsRoute` as the wiring contract reads it. */\nfunction asWireRoute(route: NotificationsRoute): {\n  method: NotificationsRoute['method'];\n  path: string;\n  handle(request: WireRequest<never>): Promise<{ status: number; body: unknown }>;\n} {\n  return {\n    method: route.method,\n    path: route.path,\n    handle: (request) =>\n      route.handle({\n        actor: request.actor,\n        params: request.params,\n        query: request.query,\n        body: request.body,\n        headers: headersOf(request),\n      }),\n  };\n}\n\n/** `createApiNotifications`, its routes re-shaped for the aggregate. */\nexport function createWireApiNotifications(\n  config: NotificationsServerConfig,\n): Omit<ApiNotifications, 'routes'> & { routes: ReturnType<typeof asWireRoute>[] } {\n  const api = createApiNotifications(config);\n  return { ...api, routes: api.routes.map(asWireRoute) };\n}\n\nexport const notificationsServerManifest = {\n  name: '@12-apps/notifications',\n  http: { create: createWireApiNotifications },\n  /**\n   * The dispatch fast path and the retry sweep, with their cadence. The host\n   * binds `{ dispatchDeliveries, drainPending }` off its own mount — the two\n   * methods the aggregate already hands it — and deletes the hand-rolled\n   * copies. See `../server/jobs` for why the numbers are the package's.\n   */\n  jobs: NOTIFICATIONS_JOBS,\n} as const satisfies AnyServerManifest;\n\n/**\n * The preview console's server half — the two endpoints over the catalogue.\n *\n * A CONSTANT, not a factory. `http.create(config)` receives whatever the host\n * bound at adoption, and \"which messages exist\" is precisely a host's binding:\n * a package cannot know that a product sends a \"your quota is exhausted\"\n * notice, let alone what data it renders from. Writing `EmailPreviewsConfig`\n * as a factory argument instead would move that decision out of\n * `bindings.http`, where `assemble()` can report on it, into a call the report\n * never sees.\n *\n * The routes carry `kind: 'authenticated'` — see `../email/previews/routes`\n * for why the descriptor states a posture it cannot itself enforce.\n */\nexport const notificationEmailPreviewsServerManifest = {\n  name: '@12-apps/notifications-email-previews',\n  http: {\n    create: (config: EmailPreviewsConfig) => ({ routes: emailPreviewRoutes(config) }),\n  },\n} as const satisfies AnyServerManifest;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsCA,IAAM,eAAe,CAAC,YAAY;AAGlC,SAAS,UAAU,SAAiE;AAClF,QAAM,MAAM,QAAQ;AACpB,MAAI,CAAC,IAAK,QAAO,CAAC;AAClB,SAAO,OAAO;AAAA,IACZ,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,QAAQ,IAAI,IAAI,KAAK,MAAS,CAAC;AAAA,EACvE;AACF;AANS;AAST,SAAS,YAAY,OAInB;AACA,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,MAAM,MAAM;AAAA,IACZ,QAAQ,wBAAC,YACP,MAAM,OAAO;AAAA,MACX,OAAO,QAAQ;AAAA,MACf,QAAQ,QAAQ;AAAA,MAChB,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ;AAAA,MACd,SAAS,UAAU,OAAO;AAAA,IAC5B,CAAC,GAPK;AAAA,EAQV;AACF;AAjBS;AAoBF,SAAS,2BACd,QACiF;AACjF,QAAM,MAAM,uBAAuB,MAAM;AACzC,SAAO,EAAE,GAAG,KAAK,QAAQ,IAAI,OAAO,IAAI,WAAW,EAAE;AACvD;AALgB;AAOT,IAAM,8BAA8B;AAAA,EACzC,MAAM;AAAA,EACN,MAAM,EAAE,QAAQ,2BAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO3C,MAAM;AACR;AAgBO,IAAM,0CAA0C;AAAA,EACrD,MAAM;AAAA,EACN,MAAM;AAAA,IACJ,QAAQ,wBAAC,YAAiC,EAAE,QAAQ,mBAAmB,MAAM,EAAE,IAAvE;AAAA,EACV;AACF;","names":[]}
+{"version":3,"sources":["../../src/manifest/server.ts"],"sourcesContent":["/**\n * `@12-apps/notifications/manifest/server` — the server capabilities.\n *\n * `http.create` wraps `createApiNotifications` in a WIRE VIEW, and the reason\n * is one field. `NotificationsRequest` carries `headers` — the contract's\n * `WireRequest` does not, because headers are the adapter's business\n * everywhere else — and exactly one descriptor reads it: push-subscribe takes\n * `user-agent` as the DEVICE HINT it labels a subscription with. Without the\n * view the field would simply be absent at runtime while still type-checking,\n * and every saved device would come back unnamed: a silent quality loss, the\n * failure mode the wiring contract exists to convert into a loud one.\n *\n * So the view derives `headers` from the raw request the contract already\n * carries for the handlers `params`/`query`/`body` cannot serve. A host whose\n * adapter leaves `request` unset still gets a working surface — every route\n * answers, the subscription saves — with an unnamed device, which is the\n * honest degradation for a hint. `@12-apps/notifications/hono` populates it.\n *\n * Everything else rides beside the mapped routes on the aggregate unchanged:\n * `notify`, `notifyByPermission`, `dispatchDeliveries`, `drainPending`, the\n * three stores, `registerGenerator` and the transports registry. A host still\n * calls those directly — being mounted does not make the emit front door stop\n * being a library.\n */\n\nimport type { AnyServerManifest, WireRequest } from '@12-apps/wiring';\n\nimport { emailPreviewRoutes } from '../email/previews/routes';\nimport type { EmailPreviewsConfig } from '../email/previews/catalog';\nimport {\n  createApiNotifications,\n  NOTIFICATIONS_JOBS,\n  type ApiNotifications,\n  type NotificationsRoute,\n  type NotificationsServerConfig,\n} from '../server';\n\n/** The header names this surface reads — the device hint, and nothing else. */\nconst READ_HEADERS = ['user-agent'] as const;\n\n/** The headers the package expects, taken off the raw request when there is one. */\nfunction headersOf(request: WireRequest<never>): Record<string, string | undefined> {\n  const raw = request.request;\n  if (!raw) return {};\n  return Object.fromEntries(\n    READ_HEADERS.map((name) => [name, raw.headers.get(name) ?? undefined]),\n  );\n}\n\n/** One `NotificationsRoute` as the wiring contract reads it. */\nfunction asWireRoute(route: NotificationsRoute): {\n  method: NotificationsRoute['method'];\n  path: string;\n  handle(request: WireRequest<never>): Promise<{ status: number; body: unknown }>;\n} {\n  return {\n    method: route.method,\n    path: route.path,\n    handle: (request) =>\n      route.handle({\n        actor: request.actor,\n        params: request.params,\n        query: request.query,\n        body: request.body,\n        headers: headersOf(request),\n      }),\n  };\n}\n\n/** `createApiNotifications`, its routes re-shaped for the aggregate. */\nexport function createWireApiNotifications(\n  config: NotificationsServerConfig,\n): Omit<ApiNotifications, 'routes'> & { routes: ReturnType<typeof asWireRoute>[] } {\n  const api = createApiNotifications(config);\n  return { ...api, routes: api.routes.map(asWireRoute) };\n}\n\nexport const notificationsServerManifest = {\n  name: '@12-apps/notifications',\n  http: { create: createWireApiNotifications },\n  /**\n   * The dispatch fast path and the retry sweep, with their cadence. The host\n   * binds `{ dispatchDeliveries, drainPending }` off its own mount — the two\n   * methods the aggregate already hands it — and deletes the hand-rolled\n   * copies. See `../server/jobs` for why the numbers are the package's.\n   */\n  jobs: NOTIFICATIONS_JOBS,\n} as const satisfies AnyServerManifest;\n\n/**\n * The preview console's server half — the two endpoints over the catalogue.\n *\n * A CONSTANT, not a factory. `http.create(config)` receives whatever the host\n * bound at adoption, and \"which messages exist\" is precisely a host's binding:\n * a package cannot know that a product sends a \"your quota is exhausted\"\n * notice, let alone what data it renders from. Writing `EmailPreviewsConfig`\n * as a factory argument instead would move that decision out of\n * `bindings.http`, where `assemble()` can report on it, into a call the report\n * never sees.\n *\n * The routes carry `kind: 'authenticated'` — see `../email/previews/routes`\n * for why the descriptor states a posture it cannot itself enforce.\n */\nexport const notificationEmailPreviewsServerManifest = {\n  name: '@12-apps/notifications-email-previews',\n  http: {\n    create: (config: EmailPreviewsConfig) => ({ routes: emailPreviewRoutes(config) }),\n  },\n} as const satisfies AnyServerManifest;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsCA,IAAM,eAAe,CAAC,YAAY;AAGlC,SAAS,UAAU,SAAiE;AAClF,QAAM,MAAM,QAAQ;AACpB,MAAI,CAAC,IAAK,QAAO,CAAC;AAClB,SAAO,OAAO;AAAA,IACZ,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,QAAQ,IAAI,IAAI,KAAK,MAAS,CAAC;AAAA,EACvE;AACF;AANS;AAST,SAAS,YAAY,OAInB;AACA,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,MAAM,MAAM;AAAA,IACZ,QAAQ,wBAAC,YACP,MAAM,OAAO;AAAA,MACX,OAAO,QAAQ;AAAA,MACf,QAAQ,QAAQ;AAAA,MAChB,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ;AAAA,MACd,SAAS,UAAU,OAAO;AAAA,IAC5B,CAAC,GAPK;AAAA,EAQV;AACF;AAjBS;AAoBF,SAAS,2BACd,QACiF;AACjF,QAAM,MAAM,uBAAuB,MAAM;AACzC,SAAO,EAAE,GAAG,KAAK,QAAQ,IAAI,OAAO,IAAI,WAAW,EAAE;AACvD;AALgB;AAOT,IAAM,8BAA8B;AAAA,EACzC,MAAM;AAAA,EACN,MAAM,EAAE,QAAQ,2BAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO3C,MAAM;AACR;AAgBO,IAAM,0CAA0C;AAAA,EACrD,MAAM;AAAA,EACN,MAAM;AAAA,IACJ,QAAQ,wBAAC,YAAiC,EAAE,QAAQ,mBAAmB,MAAM,EAAE,IAAvE;AAAA,EACV;AACF;","names":[]}

package/dist/manifest/web.d.ts

@@ -1,8 +1,9 @@
 import { c as createEmailPreviewScreen } from '../preview-screen-DYJRAnAY.js';
-import { c as createWebNotifications } from '../create-web-notifications-B-xQ6R0B.js';
+import { c as createWebNotifications } from '../create-web-notifications-_NVYmlvy.js';
 import 'react';
-import '../wire-_coV3tJk.js';
-import '../types-BFmAY0P5.js';
+import '../wire-BG1kuoXX.js';
+import '../types-BlqZkCWZ.js';
+import '../live-DYxEFO49.js';
 
 /**
  * `@12-apps/notifications/manifest/web` — the web capabilities.

package/dist/manifest/web.js

@@ -1,6 +1,6 @@
 import {
   createWebNotifications
-} from "../chunk-M5XTROYM.js";
+} from "../chunk-5Y7QRORV.js";
 import "../chunk-BW723CX2.js";
 import {
   createEmailPreviewScreen

package/dist/{panel-UFXNO4AF.js → panel-T36JEMO3.js}

@@ -1,10 +1,12 @@
 import {
+  LiveSection,
   relativeTime
-} from "./chunk-O5BVUXPO.js";
+} from "./chunk-JCVRQ42B.js";
 import {
   BellIcon,
   useInboxList
 } from "./chunk-BW723CX2.js";
+import "./chunk-RTURLH5U.js";
 import {
   __name
 } from "./chunk-7QVYU63E.js";
@@ -176,26 +178,39 @@ function PanelBody({
   ] });
 }
 __name(PanelBody, "PanelBody");
+function usePanelOpeners(store, onClose, onNavigate) {
+  const follow = useCallback(
+    (link) => {
+      if (!link || !onNavigate) return;
+      onClose();
+      onNavigate(link);
+    },
+    [onClose, onNavigate]
+  );
+  return {
+    openNotification: useCallback(
+      (notification) => {
+        if (notification.readAt === null) store.markRead([notification.id]);
+        follow(notification.link);
+      },
+      [store, follow]
+    ),
+    openLive: useCallback((activity) => follow(activity.link), [follow])
+  };
+}
+__name(usePanelOpeners, "usePanelOpeners");
 function NotificationsPanel({
   open,
   onClose,
   onNavigate,
   store,
-  messages
+  messages,
+  live
 }) {
   const theme = useTheme();
   const isMobile = useMediaQuery(theme.breakpoints.down("sm"));
   const state = useInboxList(store, open);
-  const openNotification = useCallback(
-    (notification) => {
-      if (notification.readAt === null) store.markRead([notification.id]);
-      if (notification.link && onNavigate) {
-        onClose();
-        onNavigate(notification.link);
-      }
-    },
-    [store, onClose, onNavigate]
-  );
+  const { openNotification, openLive } = usePanelOpeners(store, onClose, onNavigate);
   const hasUnread = state.items.some((item) => item.readAt === null);
   return /* @__PURE__ */ jsxs2(
     Drawer,
@@ -209,6 +224,15 @@ function NotificationsPanel({
       children: [
         /* @__PURE__ */ jsx2(DrawerHeader, { onClose, children: messages.panelTitle }),
         /* @__PURE__ */ jsxs2(DrawerContent, { children: [
+          live ? /* @__PURE__ */ jsx2(
+            LiveSection,
+            {
+              config: live,
+              messages,
+              active: open,
+              ...onNavigate ? { onOpen: openLive } : {}
+            }
+          ) : null,
           hasUnread ? /* @__PURE__ */ jsx2(Box2, { sx: { display: "flex", justifyContent: "flex-end", pb: 1 }, children: /* @__PURE__ */ jsx2(
             Button2,
             {
@@ -240,4 +264,4 @@ __name(NotificationsPanel, "NotificationsPanel");
 export {
   NotificationsPanel
 };
-//# sourceMappingURL=panel-UFXNO4AF.js.map
+//# sourceMappingURL=panel-T36JEMO3.js.map

package/dist/panel-T36JEMO3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/panel.tsx","../src/react/row.tsx"],"sourcesContent":["/**\n * The notification-centre slide-over: newest-first list with unread styling,\n * per-item open (marks read + deep-links), soft delete, mark-all, empty /\n * loading / error states and a \"load more\" cursor pager.\n *\n * Rendering is app-agnostic — the host passes `onNavigate` (its router's\n * navigate) for deep links. Without one a link is simply not followed, which is\n * what lets the panel mount in a host that has no router at all.\n */\nimport { useCallback, type JSX } from 'react';\n\nimport { EmptyState } from '@12-apps/ui/data-display/EmptyState';\nimport { LoadingState } from '@12-apps/ui/data-display/LoadingState';\nimport { Button } from '@12-apps/ui/form/Button';\nimport { Drawer, DrawerContent, DrawerHeader } from '@12-apps/ui/layout/Drawer';\nimport { Box } from '@12-apps/ui/mui/Box';\nimport { useMediaQuery } from '@12-apps/ui/mui/useMediaQuery';\nimport { useTheme } from '@12-apps/ui/mui/styles';\n\nimport type { LiveActivity } from '../live';\nimport type { NotificationMessages } from '../messages';\nimport type { InboxNotification } from '../wire';\n\nimport { BellIcon } from './bell-icon';\nimport { useInboxList } from './hooks';\nimport type { InboxState, InboxStore } from './inbox-state';\nimport type { LiveActivitiesConfig } from './live-config';\nimport { LiveSection } from './live-section';\nimport { NotificationRow } from './row';\n\ninterface PanelBodyProps {\n  state: InboxState;\n  messages: NotificationMessages;\n  onRetry: () => void;\n  onLoadMore: () => void;\n  onOpen: (notification: InboxNotification) => void;\n  onDelete: (id: string) => void;\n}\n\n/** The scrollable panel body: loading / error / empty / the list + pager. */\nfunction PanelBody({\n  state,\n  messages,\n  onRetry,\n  onLoadMore,\n  onOpen,\n  onDelete,\n}: PanelBodyProps): JSX.Element {\n  if (state.status === 'pending' || state.status === 'idle') {\n    return (\n      <LoadingState\n        variant=\"spinner\"\n        message={messages.loading}\n        size=\"md\"\n        dataTestId=\"notifications-loading\"\n      />\n    );\n  }\n  if (state.status === 'error') {\n    return (\n      <EmptyState\n        variant=\"minimal\"\n        title={messages.loadFailedTitle}\n        description={messages.loadFailedBody}\n        onRefresh={onRetry}\n        refreshLabel={messages.retry}\n        dataTestId=\"notifications-error\"\n      />\n    );\n  }\n  if (state.items.length === 0) {\n    return (\n      <EmptyState\n        variant=\"illustrated\"\n        illustration={<BellIcon size={44} dim />}\n        title={messages.emptyTitle}\n        description={messages.emptyBody}\n        dataTestId=\"notifications-empty\"\n      />\n    );\n  }\n  return (\n    <Box>\n      {state.items.map((notification) => (\n        <NotificationRow\n          key={notification.id}\n          notification={notification}\n          messages={messages}\n          onOpen={onOpen}\n          onDelete={onDelete}\n        />\n      ))}\n      {state.nextCursor ? (\n        <Box sx={{ display: 'flex', justifyContent: 'center', py: 1.5 }}>\n          <Button\n            variant=\"outline\"\n            color=\"neutral\"\n            size=\"sm\"\n            disabled={state.loadingMore}\n            onClick={onLoadMore}\n            dataTestId=\"notifications-load-more\"\n          >\n            {state.loadingMore ? messages.loadingMore : messages.loadMore}\n          </Button>\n        </Box>\n      ) : null}\n    </Box>\n  );\n}\n\n/**\n * The two open gestures, which are ONE deep-link path with a mark-read in front\n * of half of it.\n *\n * Lifted out of the component because both kinds of entry follow a link the\n * same way and a host with no router follows neither — one rule, stated once,\n * rather than the same three lines written twice.\n */\nfunction usePanelOpeners(\n  store: InboxStore,\n  onClose: () => void,\n  onNavigate?: (link: string) => void,\n): {\n  openNotification: (notification: InboxNotification) => void;\n  openLive: (activity: LiveActivity) => void;\n} {\n  const follow = useCallback(\n    (link: string | null) => {\n      if (!link || !onNavigate) return;\n      onClose();\n      onNavigate(link);\n    },\n    [onClose, onNavigate],\n  );\n\n  return {\n    openNotification: useCallback(\n      (notification: InboxNotification) => {\n        if (notification.readAt === null) store.markRead([notification.id]);\n        follow(notification.link);\n      },\n      [store, follow],\n    ),\n    openLive: useCallback((activity: LiveActivity) => follow(activity.link), [follow]),\n  };\n}\n\nexport interface NotificationsPanelProps {\n  open: boolean;\n  onClose: () => void;\n  /** Navigate to a notification's in-app link (the host's router). */\n  onNavigate?: (link: string) => void;\n}\n\nexport function NotificationsPanel({\n  open,\n  onClose,\n  onNavigate,\n  store,\n  messages,\n  live,\n}: NotificationsPanelProps & {\n  store: InboxStore;\n  messages: NotificationMessages;\n  live?: LiveActivitiesConfig;\n}): JSX.Element {\n  // `useTheme` from @mui/material/styles falls back to the DEFAULT theme when\n  // no provider is mounted, where the callback form of `useMediaQuery` would\n  // hand the callback a null theme and throw. A published component must render\n  // in a host that has not wrapped it yet.\n  const theme = useTheme();\n  const isMobile = useMediaQuery(theme.breakpoints.down('sm'));\n  const state = useInboxList(store, open);\n\n  const { openNotification, openLive } = usePanelOpeners(store, onClose, onNavigate);\n\n  const hasUnread = state.items.some((item) => item.readAt === null);\n\n  return (\n    <Drawer\n      open={open}\n      onClose={onClose}\n      anchor=\"right\"\n      variant=\"right\"\n      width={isMobile ? '100vw' : 400}\n      dataTestId=\"notifications-panel\"\n    >\n      <DrawerHeader onClose={onClose}>{messages.panelTitle}</DrawerHeader>\n      <DrawerContent>\n        {/*\n          Above the mark-all control as well as above the list, deliberately:\n          \"marcar todas como lidas\" belongs to the INBOX, and a live entry has\n          nothing to mark. A control between the two blocks would read as\n          applying to both.\n        */}\n        {live ? (\n          <LiveSection\n            config={live}\n            messages={messages}\n            active={open}\n            {...(onNavigate ? { onOpen: openLive } : {})}\n          />\n        ) : null}\n        {hasUnread ? (\n          <Box sx={{ display: 'flex', justifyContent: 'flex-end', pb: 1 }}>\n            <Button\n              variant=\"ghost\"\n              color=\"primary\"\n              size=\"xs\"\n              onClick={() => store.markAllRead()}\n              dataTestId=\"notifications-mark-all-read\"\n            >\n              {messages.markAllRead}\n            </Button>\n          </Box>\n        ) : null}\n        <PanelBody\n          state={state}\n          messages={messages}\n          onRetry={() => store.invalidate()}\n          onLoadMore={() => store.loadMore()}\n          onOpen={openNotification}\n          onDelete={(id) => store.remove(id)}\n        />\n      </DrawerContent>\n    </Drawer>\n  );\n}\n","/** One inbox row: unread accent, content (opens/marks read), timestamp, delete. */\nimport type { JSX } from 'react';\n\nimport { Button } from '@12-apps/ui/form/Button';\nimport { Box } from '@12-apps/ui/mui/Box';\nimport { alpha, type Theme } from '@12-apps/ui/mui/styles';\nimport { Text } from '@12-apps/ui/typography/Text';\n\nimport type { NotificationMessages } from '../messages';\nimport type { InboxNotification } from '../wire';\n\nimport { relativeTime } from './relative-time';\n\nconst contentButtonSx = {\n  flex: 1,\n  minWidth: 0,\n  display: 'flex',\n  flexDirection: 'column',\n  gap: 0.25,\n  textAlign: 'left',\n  border: 'none',\n  background: 'none',\n  p: 0,\n  cursor: 'pointer',\n  color: 'text.primary',\n  fontFamily: 'inherit',\n} as const;\n\nconst unreadDotSx = {\n  width: 8,\n  height: 8,\n  borderRadius: '50%',\n  bgcolor: 'primary.main',\n  flex: '0 0 auto',\n} as const;\n\nexport function NotificationRow({\n  notification,\n  messages,\n  onOpen,\n  onDelete,\n}: {\n  notification: InboxNotification;\n  messages: NotificationMessages;\n  onOpen: (notification: InboxNotification) => void;\n  onDelete: (id: string) => void;\n}): JSX.Element {\n  const unread = notification.readAt === null;\n  return (\n    <Box\n      data-testid={`notification-${notification.id}`}\n      sx={{\n        display: 'flex',\n        alignItems: 'flex-start',\n        gap: 1,\n        py: 1.5,\n        px: 1,\n        borderBottom: '1px solid',\n        borderColor: 'divider',\n        bgcolor: unread ? (t: Theme) => alpha(t.palette.primary.main, 0.06) : 'transparent',\n      }}\n    >\n      <Box\n        component=\"button\"\n        type=\"button\"\n        onClick={() => onOpen(notification)}\n        aria-label={\n          unread ? `${notification.title} (${messages.unreadSuffix})` : notification.title\n        }\n        sx={contentButtonSx}\n      >\n        <Box sx={{ display: 'flex', alignItems: 'center', gap: 0.75 }}>\n          {unread ? <Box aria-hidden sx={unreadDotSx} /> : null}\n          <Text variant=\"body\" size=\"sm\" weight={unread ? 'bold' : 'medium'} as=\"span\">\n            {notification.title}\n          </Text>\n        </Box>\n        <Text variant=\"caption\" size=\"xs\" color=\"secondary\" as=\"span\">\n          {notification.body}\n        </Text>\n        <Text variant=\"caption\" size=\"xs\" color=\"secondary\" as=\"span\" italic>\n          {relativeTime(notification.createdAt, messages)}\n        </Text>\n      </Box>\n\n      <Button\n        variant=\"ghost\"\n        color=\"neutral\"\n        size=\"xs\"\n        aria-label={messages.deleteOne(notification.title)}\n        onClick={() => onDelete(notification.id)}\n        dataTestId={`notification-delete-${notification.id}`}\n      >\n        ✕\n      </Button>\n    </Box>\n  );\n}\n"],"mappings":"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","names":["Button","Box","jsx","jsxs","Box","Button"]}

package/dist/{preferences-screen-V3ZBWP7A.js → preferences-screen-SXUIGECY.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-CQZMTFPY.js";
 import {
   NOTIFICATION_CHANNELS
-} from "./chunk-BGI4BQ66.js";
+} from "./chunk-6W7INOYQ.js";
 import {
   __name
 } from "./chunk-7QVYU63E.js";
@@ -291,4 +291,4 @@ __name(PreferencesScreen, "PreferencesScreen");
 export {
   PreferencesScreen
 };
-//# sourceMappingURL=preferences-screen-V3ZBWP7A.js.map
+//# sourceMappingURL=preferences-screen-SXUIGECY.js.map

package/dist/react/index.d.ts

@@ -1,8 +1,10 @@
-import { N as NotificationsApiClient } from '../create-web-notifications-B-xQ6R0B.js';
-export { B as BADGE_POLL_MS, a as BADGE_RECONCILE_MS, b as BellButtonProps, I as InboxListStatus, d as InboxState, e as InboxStore, f as NotificationsHttpError, g as NotificationsPanelProps, h as NotificationsResult, i as NotificationsSignalHook, j as NotificationsSubscribe, k as NotificationsTransport, l as NotificationsWebConfig, P as PAGE_SIZE, m as PreferencesPayload, n as PreferencesScreenProps, o as PushRegistrationPayload, W as WebNotifications, p as WebPushPlatformHint, q as WebPushSetupConfig, r as createInboxStore, s as createNotificationsApiClient, c as createWebNotifications, t as httpNotificationsTransport, u as useInboxList, v as useInboxState, w as useUnreadCount } from '../create-web-notifications-B-xQ6R0B.js';
+import { L as LiveActivitiesConfig, N as NotificationsApiClient } from '../create-web-notifications-_NVYmlvy.js';
+export { B as BADGE_POLL_MS, a as BADGE_RECONCILE_MS, b as BellButtonProps, I as InboxListStatus, d as InboxState, e as InboxStore, f as LiveActivitiesHook, g as LiveActivityMessages, h as NotificationsHttpError, i as NotificationsPanelProps, j as NotificationsResult, k as NotificationsSignalHook, l as NotificationsSubscribe, m as NotificationsTransport, n as NotificationsWebConfig, P as PAGE_SIZE, o as PreferencesPayload, p as PreferencesScreenProps, q as PushRegistrationPayload, W as WebNotifications, r as WebPushPlatformHint, s as WebPushSetupConfig, t as createInboxStore, u as createNotificationsApiClient, c as createWebNotifications, v as httpNotificationsTransport, w as useInboxList, x as useInboxState, y as useUnreadCount } from '../create-web-notifications-_NVYmlvy.js';
 import { JSX } from 'react';
-import { N as NotificationMessages } from '../wire-_coV3tJk.js';
-import '../types-BFmAY0P5.js';
+import { b as LiveActivity } from '../live-DYxEFO49.js';
+export { c as LiveActivityLane, d as LiveActivityStep, l as liveActivityLane } from '../live-DYxEFO49.js';
+import { N as NotificationMessages } from '../wire-BG1kuoXX.js';
+import '../types-BlqZkCWZ.js';
 
 /** Inline SVG bell (no icon-library dependency in this package). */
 
@@ -11,12 +13,59 @@ declare function BellIcon({ size, dim, }: {
     dim?: boolean;
 }): JSX.Element;
 
+/**
+ * The pinned block at the top of the panel: everything that is happening NOW,
+ * above everything that has already happened.
+ *
+ * ## Why it is here and not a second surface
+ *
+ * The notification centre is where a person goes to find out what they missed.
+ * Splitting "happening" into its own bell would make them check two places to
+ * answer one question, and the half they would stop checking is the one that
+ * only has something in it occasionally — which is this one. Above the list,
+ * inside the same drawer, it is on the path they already walk.
+ *
+ * ## What it deliberately does NOT do
+ *
+ * - It does not touch `unread`. A live entry is not news; counting it would put
+ *   a number on the bell that no amount of reading can clear.
+ * - It renders nothing at all when there is nothing live — no heading, no empty
+ *   state, no reserved space. A panel with one permanent empty section in it is
+ *   a panel that has taught its reader to skip the top.
+ * - It does not fetch. `useActivities` is the host's, and `active` tells it
+ *   whether anyone is looking.
+ */
+
+interface LiveSectionProps {
+    config: LiveActivitiesConfig;
+    messages: NotificationMessages;
+    /** Whether the panel is open — passed straight through to the host's hook. */
+    active: boolean;
+    /**
+     * Follow a card's link.
+     *
+     * Optional, and the panel omits it for a host with no router: a card that
+     * cannot go anywhere renders as text rather than as a named control that
+     * does nothing.
+     */
+    onOpen?: (activity: LiveActivity) => void;
+}
+declare function LiveSection({ config, messages, active, onOpen, }: LiveSectionProps): JSX.Element | null;
+
 /**
  * "há 5 min"-style relative timestamp, falling back to an absolute date for
  * anything older than a week. Every word comes from the messages table, so a
  * host in another locale changes the copy and the locale together.
+ *
+ * `now` is a parameter rather than a read, and the live section is why. A
+ * relative phrase is only true for the instant it was computed, so something
+ * has to CAUSE the render that recomputes it — and the live entries' own data
+ * cannot: a host backed by react-query gets the previous object back whenever a
+ * poll is deep-equal (`structuralSharing`, on by default), which within one
+ * stage it always is. The section therefore ticks a clock and hands it down.
+ * Defaulted, so every existing caller reads the wall clock exactly as before.
  */
-declare function relativeTime(iso: string, messages: NotificationMessages): string;
+declare function relativeTime(iso: string, messages: NotificationMessages, now?: number): string;
 
 /**
  * The browser half of Web Push: register the service worker, ask permission,
@@ -44,4 +93,4 @@ declare function enableWebPush(api: NotificationsApiClient, swPath?: string): Pr
 /** Disable flow: unsubscribe the browser and drop the server-side row. */
 declare function disableWebPush(api: NotificationsApiClient): Promise<void>;
 
-export { BellIcon, NotificationsApiClient, type PushSetupResult, disableWebPush, enableWebPush, getExistingPushSubscription, pushSupported, relativeTime };
+export { BellIcon, LiveActivitiesConfig, LiveActivity, LiveSection, type LiveSectionProps, NotificationsApiClient, type PushSetupResult, disableWebPush, enableWebPush, getExistingPushSubscription, pushSupported, relativeTime };

package/dist/react/index.js

@@ -3,10 +3,11 @@ import {
   createNotificationsApiClient,
   createWebNotifications,
   httpNotificationsTransport
-} from "../chunk-M5XTROYM.js";
+} from "../chunk-5Y7QRORV.js";
 import {
+  LiveSection,
   relativeTime
-} from "../chunk-O5BVUXPO.js";
+} from "../chunk-JCVRQ42B.js";
 import {
   BADGE_POLL_MS,
   BADGE_RECONCILE_MS,
@@ -24,11 +25,15 @@ import {
   pushSupported
 } from "../chunk-CQZMTFPY.js";
 import "../chunk-M2TVBVH2.js";
+import {
+  liveActivityLane
+} from "../chunk-RTURLH5U.js";
 import "../chunk-7QVYU63E.js";
 export {
   BADGE_POLL_MS,
   BADGE_RECONCILE_MS,
   BellIcon,
+  LiveSection,
   NotificationsHttpError,
   PAGE_SIZE,
   createInboxStore,
@@ -38,6 +43,7 @@ export {
   enableWebPush,
   getExistingPushSubscription,
   httpNotificationsTransport,
+  liveActivityLane,
   pushSupported,
   relativeTime,
   useInboxList,

package/dist/server/index.d.ts

@@ -1,11 +1,11 @@
-import { A as ApiNotifications } from '../create-api-notifications-B-VMezVB.js';
-export { C as CommittedNotification, E as EMAIL_DRIVERS, c as EmailDriver, d as EmailDriverDeclaration, e as EmailMessage, f as ExtraDrivers, L as ListNotificationsInput, g as NotificationAudienceDirectory, h as NotificationChannelPolicy, i as NotificationCommittedListener, j as NotificationContactDirectory, k as NotificationCreateData, l as NotificationDelegate, m as NotificationDeliveryDelegate, n as NotificationDeliveryRow, o as NotificationDeliveryWhere, p as NotificationDispatchScheduler, q as NotificationInboxStore, r as NotificationPageAfter, s as NotificationPreferenceDelegate, t as NotificationPreferenceRow, u as NotificationPreferenceStore, v as NotificationRouter, w as NotificationWhere, a as NotificationsActor, x as NotificationsApiError, y as NotificationsDb, z as NotificationsDbClient, B as NotificationsDbProvider, D as NotificationsRequest, F as NotificationsResponse, b as NotificationsRoute, N as NotificationsServerConfig, G as NotifyByPermission, H as NotifyOptions, I as NotifyResult, P as PermissionNotificationResult, J as PermissionNotificationSkip, K as PushSubscriptionDelegate, M as PushSubscriptionInput, O as PushSubscriptionRow, Q as PushSubscriptionStore, S as SMS_DRIVERS, R as SmsDriver, T as SmsDriverDeclaration, U as SmsMessage, V as TransportDeclaration, W as TransportRegistry, X as WHATSAPP_DRIVERS, Y as WhatsAppDriver, Z as WhatsAppDriverDeclaration, _ as WhatsAppMessage, $ as createApiNotifications, a0 as createTransportRegistry, a1 as emailTransport, a2 as foldApiError, a3 as formatEmail, a4 as formatSms, a5 as formatWhatsApp, a6 as ok, a7 as smsTransport, a8 as whatsAppTransport } from '../create-api-notifications-B-VMezVB.js';
-export { D as DriverDeclarationBase, F as FetchImpl, N as NotificationProviderError, W as WEB_PUSH_DRIVERS, a as WebPushDriverDeclaration, b as WebPushMessage, c as WebPushSender, d as WebPushSubscription, e as WebPushSubscriptionSource, f as absoluteLink, g as formatWebPush, w as webPushTransport } from '../web-push-D-ysQd5h.js';
+import { A as ApiNotifications } from '../create-api-notifications-CcPYrM3p.js';
+export { C as CommittedNotification, E as EMAIL_DRIVERS, c as EmailDriver, d as EmailDriverDeclaration, e as EmailMessage, f as ExtraDrivers, L as ListNotificationsInput, g as NotificationAudienceDirectory, h as NotificationChannelPolicy, i as NotificationCommittedListener, j as NotificationContactDirectory, k as NotificationCreateData, l as NotificationDelegate, m as NotificationDeliveryDelegate, n as NotificationDeliveryRow, o as NotificationDeliveryWhere, p as NotificationDispatchScheduler, q as NotificationInboxStore, r as NotificationPageAfter, s as NotificationPreferenceDelegate, t as NotificationPreferenceRow, u as NotificationPreferenceStore, v as NotificationRouter, w as NotificationWhere, a as NotificationsActor, x as NotificationsApiError, y as NotificationsDb, z as NotificationsDbClient, B as NotificationsDbProvider, D as NotificationsRequest, F as NotificationsResponse, b as NotificationsRoute, N as NotificationsServerConfig, G as NotifyByPermission, H as NotifyOptions, I as NotifyResult, P as PermissionNotificationResult, J as PermissionNotificationSkip, K as PushSubscriptionDelegate, M as PushSubscriptionInput, O as PushSubscriptionRow, Q as PushSubscriptionStore, S as SMS_DRIVERS, R as SmsDriver, T as SmsDriverDeclaration, U as SmsMessage, V as TransportDeclaration, W as TransportRegistry, X as WHATSAPP_DRIVERS, Y as WhatsAppDriver, Z as WhatsAppDriverDeclaration, _ as WhatsAppMessage, $ as createApiNotifications, a0 as createTransportRegistry, a1 as emailTransport, a2 as foldApiError, a3 as formatEmail, a4 as formatSms, a5 as formatWhatsApp, a6 as ok, a7 as smsTransport, a8 as whatsAppTransport } from '../create-api-notifications-CcPYrM3p.js';
+export { D as DriverDeclarationBase, F as FetchImpl, N as NotificationProviderError, W as WEB_PUSH_DRIVERS, a as WebPushDriverDeclaration, b as WebPushMessage, c as WebPushSender, d as WebPushSubscription, e as WebPushSubscriptionSource, f as absoluteLink, g as formatWebPush, w as webPushTransport } from '../web-push-Dnyaha2z.js';
 import { NotifyPort } from '@12-apps/wiring/ports';
-export { a as NOTIFICATIONS_DRAIN_CRON, b as NOTIFICATIONS_DRAIN_LEASE_MS, c as NOTIFICATIONS_JOBS, d as NOTIFICATIONS_SWEEP_QUEUE, N as NotificationsJobDeps } from '../jobs-D64B_bg7.js';
-import '../generators-BsuXe8Mp.js';
-import '../types-BFmAY0P5.js';
-import '../wire-_coV3tJk.js';
+export { a as NOTIFICATIONS_DRAIN_CRON, b as NOTIFICATIONS_DRAIN_LEASE_MS, c as NOTIFICATIONS_JOBS, d as NOTIFICATIONS_SWEEP_QUEUE, N as NotificationsJobDeps } from '../jobs--fex87-q.js';
+import '../generators-qAD4fNPq.js';
+import '../types-BlqZkCWZ.js';
+import '../wire-BG1kuoXX.js';
 import '../template-Dlt5S54z.js';
 import '@12-apps/wiring';
 

package/dist/server/index.js

@@ -4,7 +4,7 @@ import {
   NOTIFICATIONS_JOBS,
   NOTIFICATIONS_SWEEP_QUEUE,
   wireNotifyPort
-} from "../chunk-KU4FVOFA.js";
+} from "../chunk-ZIR3ILFH.js";
 import {
   EMAIL_DRIVERS,
   NotificationProviderError,
@@ -25,10 +25,11 @@ import {
   smsTransport,
   webPushTransport,
   whatsAppTransport
-} from "../chunk-KZG7QGFA.js";
-import "../chunk-GGAZOLNN.js";
+} from "../chunk-WVRODNXQ.js";
+import "../chunk-SWOWHIFE.js";
 import "../chunk-M2TVBVH2.js";
-import "../chunk-BGI4BQ66.js";
+import "../chunk-RTURLH5U.js";
+import "../chunk-6W7INOYQ.js";
 import "../chunk-EKUSNUBT.js";
 import "../chunk-7QVYU63E.js";
 export {

package/dist/{types-BFmAY0P5.d.ts → types-BlqZkCWZ.d.ts}

@@ -60,7 +60,16 @@ interface NotificationContent {
     body: string;
     /** In-app deep link (a same-origin path such as `/orders/123`). */
     link?: string;
-    /** Structured extras for consumers that want more than text. */
+    /**
+     * Structured extras for consumers that want more than text.
+     *
+     * ONE KEY IS RESERVED: `liveSubject` (`LIVE_SUBJECT_KEY` in `./live`) ties
+     * this notification to a live activity, and the WEB_PUSH transport turns it
+     * into the tray `tag` that collapses every push about one subject onto a
+     * single entry. A host already using that name for something else acquires
+     * that behaviour without asking for it — so it is named here, on the field a
+     * generator actually writes, and not only where the feature is documented.
+     */
     data?: Record<string, unknown>;
 }
 /** Who receives a notification. `clientId` scopes it to a tenant when set. */