@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.5

package/dist/notifications/ui/broadcastsTable.js

@@ -0,0 +1,312 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Admin → Operations → Broadcasts: the DataTable column contract (issue #325,
+ * epic #319).
+ *
+ * A sibling module rather than columns inlined in `BroadcastsPage.tsx`, for the
+ * reason every table in this repo follows (`jobsTable.tsx` and
+ * `buildUserColumns` of `@marinoscar/platform-web/identity/ui` are the models): the column list is
+ * the table's PUBLIC shape — what a test, a CSV export and both renderers read
+ * — while the page is the state that feeds it. Keeping them apart lets a test
+ * assert the contract without mounting a page and mocking its fetch layer.
+ *
+ * =============================================================================
+ * WHAT `GET /api/admin/broadcasts` ACTUALLY HONOURS
+ * =============================================================================
+ *
+ * Read off `apps/api/src/notifications/broadcasts/dto/broadcast-list-query.dto.ts`
+ * and `broadcasts.service.ts`'s `list`:
+ *
+ *   | query param       | accepts                                  | column here    |
+ *   | ----------------- | ---------------------------------------- | -------------- |
+ *   | `status`          | draft/scheduled/sending/sent/canceled/failed | `status`, `is` |
+ *   | `page`/`pageSize` | 1-based, pageSize max 100                | pagination     |
+ *
+ * That is the whole query surface. NO COLUMN IS `sortable`: the service orders
+ * by `createdAt DESC` and offers no `sortBy`, so a sortable header would either
+ * silently do nothing or 400 — the same reasoning `jobsTable.tsx` gives at
+ * length. There is no quick search either, for the same reason: no free-text
+ * parameter exists, and a search box that filters only the current page is a
+ * control that lies about its scope.
+ *
+ * =============================================================================
+ * `draft` IS OFFERED AS A FILTER EVEN THOUGH THE API NEVER WRITES ONE
+ * =============================================================================
+ *
+ * `create` stamps `scheduled` unconditionally; nothing in this epic produces a
+ * `draft` row. It is still in the enum because the STATUS COLUMN can render one
+ * — the database column allows it, and a future compose-and-save-for-later
+ * would populate it — and a filter that omits a status the table can display is
+ * a filter that silently cannot reach some of its own rows.
+ *
+ * =============================================================================
+ * IMPORTANCE IS DERIVED FROM `eventKey`, BECAUSE THERE IS NO `critical` COLUMN
+ * =============================================================================
+ *
+ * The API takes `critical: boolean` on create and DERIVES the event key from
+ * it (`admin.broadcast` vs `admin.broadcast_critical`), then stores only the
+ * key. So "can recipients mute this?" is answered by reading the key back, and
+ * `isCriticalBroadcast` below is the single place that reading happens — the
+ * page, the detail dialog and this table all call it rather than each writing
+ * their own `=== 'admin.broadcast_critical'`.
+ */
+import { Chip, Stack, Tooltip, Typography } from '@mui/material';
+import { BROADCAST_STATUSES } from '../headless/broadcasts.js';
+/**
+ * Persistence key for `user_settings.dataTables`. A constant, never derived
+ * from the route or the heading: it is a storage key and must survive a rename.
+ */
+export const TABLE_ID = 'broadcasts';
+/** Column ids the page reads filters out of. Named so a typo cannot drift. */
+export const TITLE_COLUMN_ID = 'title';
+export const STATUS_COLUMN_ID = 'status';
+/**
+ * The event key the API derives for a broadcast recipients may not mute.
+ * `admin.broadcast_critical` in `notifications/broadcasts/broadcasts.service.ts`.
+ */
+export const CRITICAL_EVENT_KEY = 'admin.broadcast_critical';
+/** Whether recipients can mute this broadcast. See the module header. */
+export function isCriticalBroadcast(broadcast) {
+    return broadcast.eventKey === CRITICAL_EVENT_KEY;
+}
+const STATUS_ENUM_VALUES = [
+    { value: 'draft', label: 'Draft' },
+    { value: 'scheduled', label: 'Scheduled' },
+    { value: 'sending', label: 'Sending' },
+    { value: 'sent', label: 'Sent' },
+    { value: 'canceled', label: 'Canceled' },
+    { value: 'failed', label: 'Failed' },
+];
+/**
+ * MUI `Chip` colours per status.
+ *
+ * `default` for `draft` and `canceled` — neither is a state to alarm anyone,
+ * and a canceled announcement is a decision that was taken deliberately rather
+ * than a fault. `warning` for `sending` because it is the one status during
+ * which an operator's options are shrinking by the second.
+ */
+export const STATUS_CHIP_COLOR = {
+    draft: 'default',
+    scheduled: 'info',
+    sending: 'warning',
+    sent: 'success',
+    canceled: 'default',
+    failed: 'error',
+};
+/**
+ * How an administrator calls the platform's own channels where it differs from
+ * the registry's label (`browser` is "In-app" here). Every other channel is
+ * called what the API's channel registry calls it (`labels`, from
+ * `GET /api/notifications/channels`).
+ */
+const CHANNEL_LABELS = {
+    browser: 'In-app',
+    email: 'Email',
+    push: 'Push',
+};
+/**
+ * `browser` is labelled "In-app", everywhere.
+ *
+ * The API's channel is named for the mechanism; the administrator's question is
+ * about the destination. In this application the `browser` channel is what
+ * writes the durable `notifications` row the bell renders — the OS toast is a
+ * secondary effect of the same channel. Turning browser notifications off
+ * deployment-wide mutes the toast for a critical (mandatory) broadcast while
+ * its row is still written; for a non-critical broadcast it drops the in-app
+ * delivery too (#521). The label names what the admin is choosing — a place in
+ * the app — not the OS mechanism.
+ */
+export function channelLabel(channel, labels) {
+    return CHANNEL_LABELS[channel] ?? labels?.get(channel) ?? channel;
+}
+/** A timestamp in the viewer's locale, or an em dash when the API sent `null`. */
+export function formatDateTime(value) {
+    return value ? new Date(value).toLocaleString() : '—';
+}
+/** The first 8 characters of a UUID — enough to tell two rows apart by eye. */
+export function shortId(id) {
+    return id.slice(0, 8);
+}
+/**
+ * `dispatched / targeted`, as a scalar.
+ *
+ * The denominator is `—` until the fan-out freezes the audience and counts it,
+ * because until then there genuinely is no target: `recipientsTargeted` is
+ * `null` on every `scheduled` row. Printing `0 / 0` would state a measurement
+ * that was never taken, and — worse here than on the jobs page — would read as
+ * "this broadcast reaches nobody".
+ */
+export function formatProgress(broadcast) {
+    const targeted = broadcast.recipientsTargeted;
+    return `${broadcast.recipientsDispatched} / ${targeted === null ? '—' : targeted}`;
+}
+/**
+ * Read a single-operand `is` filter out of the model as a plain STRING.
+ *
+ * Returning a scalar (not the filter object) is what lets a refetch effect
+ * depend on it directly — an effect keyed on the filter array would refetch
+ * forever, since the array is rebuilt on every change. Lifted from
+ * `jobsTable.tsx`, which explains the same trap.
+ */
+export function readIsFilter(filters, columnId) {
+    const found = filters.find((filter) => filter.columnId === columnId && filter.operator === 'is');
+    return typeof found?.value === 'string' && found.value ? found.value : undefined;
+}
+/** Narrow a stored/URL-supplied filter value to a status the endpoint accepts. */
+export function asBroadcastStatus(value) {
+    return BROADCAST_STATUSES.find((candidate) => candidate === value);
+}
+// =============================================================================
+// The columns
+// =============================================================================
+export function buildBroadcastColumns(labels) {
+    return [
+        {
+            /**
+             * The row-unique `primary` column, and therefore the row's ACCESSIBLE
+             * NAME: `rowAccessibleName()` takes the first visible `primary` column's
+             * scalar and names every row-action button and every card after it.
+             *
+             * THE SHORT ID IS IN THE SCALAR FOR THAT REASON, exactly as
+             * `jobsTable.tsx` does it. A title alone is NOT row-unique — "Planned
+             * maintenance tonight" is precisely the announcement an operator sends
+             * three weeks running — so a scalar of the title alone would name several
+             * "Cancel Planned maintenance tonight" buttons on one screen with no way
+             * to tell which is which. `hideable: false` for the same reason: hiding
+             * this column would rename every control on the page after whichever
+             * column happened to be `primary` next.
+             */
+            id: TITLE_COLUMN_ID,
+            label: 'Title',
+            priority: 'primary',
+            hideable: false,
+            minWidth: 240,
+            flex: 1.4,
+            value: (broadcast) => `${broadcast.title} (${shortId(broadcast.id)})`,
+            render: (broadcast) => (_jsxs(Stack, { sx: { minWidth: 0 }, children: [_jsx(Typography, { variant: "body2", noWrap: true, children: broadcast.title }), _jsx(Typography, { variant: "caption", color: "text.secondary", noWrap: true, children: shortId(broadcast.id) })] })),
+        },
+        {
+            id: STATUS_COLUMN_ID,
+            label: 'Status',
+            priority: 'primary',
+            filterable: ['is'], // ?status=
+            filterType: 'enum',
+            enumValues: STATUS_ENUM_VALUES,
+            width: 130,
+            value: (broadcast) => broadcast.status,
+            render: (broadcast) => (_jsx(Chip, { label: broadcast.status, size: "small", color: STATUS_CHIP_COLOR[broadcast.status] })),
+        },
+        {
+            /**
+             * Two words, not a boolean. "Cannot be muted" is the fact an operator
+             * actually needs — a `true` under a header reading "Critical" makes them
+             * work out what critical means to this system, and the answer ("the
+             * recipient's own preference is bypassed") is the whole difference
+             * between the two event keys.
+             */
+            id: 'importance',
+            label: 'Importance',
+            priority: 'secondary',
+            width: 150,
+            value: (broadcast) => (isCriticalBroadcast(broadcast) ? 'Cannot be muted' : 'Normal'),
+            render: (broadcast) => isCriticalBroadcast(broadcast) ? (_jsx(Tooltip, { title: "Sent as admin.broadcast_critical \u2014 recipients' notification preferences are bypassed.", children: _jsx(Chip, { label: "Cannot be muted", size: "small", color: "warning", variant: "outlined" }) })) : (_jsx(Typography, { variant: "body2", color: "text.secondary", children: "Normal" })),
+        },
+        {
+            /**
+             * The channels this send was NARROWED to, which is not the same as the
+             * channels each recipient got: the API intersects this set with the admin
+             * policy and then with each user's preferences. So this column says what
+             * was asked for, and the detail dialog's approximate breakdown says what
+             * was attempted.
+             */
+            id: 'channels',
+            label: 'Channels',
+            priority: 'secondary',
+            minWidth: 180,
+            value: (broadcast) => broadcast.channels.map((channel) => channelLabel(channel, labels)).join(', '),
+            render: (broadcast) => (_jsx(Stack, { direction: "row", spacing: 0.5, useFlexGap: true, sx: { flexWrap: 'wrap' }, children: broadcast.channels.map((channel) => (_jsx(Chip, { label: channelLabel(channel, labels), size: "small", variant: "outlined" }, channel))) })),
+        },
+        {
+            id: 'scheduledFor',
+            label: 'Scheduled for',
+            priority: 'secondary',
+            minWidth: 180,
+            // `null` means "immediately" rather than "unknown", and an em dash would
+            // be read as the latter. The two are genuinely different intentions and
+            // the column is the only place either is visible.
+            value: (broadcast) => broadcast.scheduledFor ? formatDateTime(broadcast.scheduledFor) : 'Immediately',
+        },
+        {
+            id: 'progress',
+            label: 'Progress',
+            priority: 'secondary',
+            align: 'right',
+            width: 140,
+            value: (broadcast) => formatProgress(broadcast),
+        },
+        {
+            id: 'finishedAt',
+            label: 'Sent at',
+            priority: 'secondary',
+            minWidth: 180,
+            value: (broadcast) => formatDateTime(broadcast.finishedAt),
+        },
+        {
+            /**
+             * The API returns `createdById` and nothing else — there is no join to a
+             * user on this response — so this column prints the id it was given
+             * rather than inventing a name. `System` for `null`, which is what a row
+             * created by something other than a signed-in administrator would carry.
+             */
+            id: 'createdById',
+            label: 'Created by',
+            priority: 'detail',
+            minWidth: 160,
+            value: (broadcast) => broadcast.createdById ? shortId(broadcast.createdById) : 'System',
+            render: (broadcast) => broadcast.createdById ? (_jsx(Tooltip, { title: broadcast.createdById, children: _jsx(Typography, { variant: "body2", noWrap: true, children: shortId(broadcast.createdById) }) })) : (_jsx(Typography, { variant: "body2", color: "text.secondary", children: "System" })),
+        },
+        {
+            id: 'createdAt',
+            label: 'Created',
+            priority: 'secondary',
+            minWidth: 180,
+            value: (broadcast) => formatDateTime(broadcast.createdAt),
+        },
+        {
+            id: 'startedAt',
+            label: 'Started',
+            priority: 'detail',
+            minWidth: 180,
+            value: (broadcast) => formatDateTime(broadcast.startedAt),
+        },
+        {
+            id: 'canceledAt',
+            label: 'Canceled',
+            priority: 'detail',
+            minWidth: 180,
+            value: (broadcast) => formatDateTime(broadcast.canceledAt),
+        },
+        {
+            /**
+             * `truncate`, because a fan-out failure carries a handler's message and
+             * would otherwise make one failed row taller than the rest of the page.
+             * The full text is in the detail dialog and in the CSV.
+             */
+            id: 'lastError',
+            label: 'Last error',
+            priority: 'detail',
+            truncate: true,
+            minWidth: 240,
+            value: (broadcast) => broadcast.lastError ?? '',
+        },
+        {
+            id: 'id',
+            label: 'ID',
+            priority: 'detail',
+            truncate: true,
+            minWidth: 200,
+            value: (broadcast) => broadcast.id,
+        },
+    ];
+}
+//# sourceMappingURL=broadcastsTable.js.map

package/dist/notifications/ui/broadcastsTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcastsTable.js","sourceRoot":"","sources":["../../../src/notifications/ui/broadcastsTable.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAErC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAE7D,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,SAAsC;IACxE,OAAO,SAAS,CAAC,QAAQ,KAAK,kBAAkB,CAAC;AACnD,CAAC;AAED,MAAM,kBAAkB,GAAG;IACzB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;IAC1C,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAChC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IACxC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;CACqB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAG1B;IACF,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,cAAc,GAA2B;IAC7C,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAoC;IAChF,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AACpE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,KAAgC;IAC7D,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACxD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,SAAyE;IACtG,MAAM,QAAQ,GAAG,SAAS,CAAC,kBAAkB,CAAC;IAC9C,OAAO,GAAG,SAAS,CAAC,oBAAoB,MAAM,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AACrF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA6B,EAC7B,QAAgB;IAEhB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CACxB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CACrE,CAAC;IACF,OAAO,OAAO,KAAK,EAAE,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,MAAM,UAAU,qBAAqB,CAAC,MAAoC;IACxE,OAAO;QACL;YACE;;;;;;;;;;;;;eAaG;YACH,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,GAAG;YACT,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG;YACrE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CACrB,MAAC,KAAK,IAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,aACxB,KAAC,UAAU,IAAC,OAAO,EAAC,OAAO,EAAC,MAAM,kBAC/B,SAAS,CAAC,KAAK,GACL,EACb,KAAC,UAAU,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,gBAAgB,EAAC,MAAM,kBACxD,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,GACX,IACP,CACT;SACF;QACD;YACE,EAAE,EAAE,gBAAgB;YACpB,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW;YAC/B,UAAU,EAAE,MAAM;YAClB,UAAU,EAAE,kBAAkB;YAC9B,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM;YACtC,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CACrB,KAAC,IAAI,IACH,KAAK,EAAE,SAAS,CAAC,MAAM,EACvB,IAAI,EAAC,OAAO,EACZ,KAAK,EAAE,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,GAC1C,CACH;SACF;QACD;YACE;;;;;;eAMG;YACH,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC;YACrF,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CACpB,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC/B,KAAC,OAAO,IAAC,KAAK,EAAC,4FAAuF,YACpG,KAAC,IAAI,IAAC,KAAK,EAAC,iBAAiB,EAAC,IAAI,EAAC,OAAO,EAAC,KAAK,EAAC,SAAS,EAAC,OAAO,EAAC,UAAU,GAAG,GACxE,CACX,CAAC,CAAC,CAAC,CACF,KAAC,UAAU,IAAC,OAAO,EAAC,OAAO,EAAC,KAAK,EAAC,gBAAgB,uBAErC,CACd;SACJ;QACD;YACE;;;;;;eAMG;YACH,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACnG,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CACrB,KAAC,KAAK,IAAC,SAAS,EAAC,KAAK,EAAC,OAAO,EAAE,GAAG,EAAE,UAAU,QAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YACrE,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACnC,KAAC,IAAI,IAAe,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,EAAC,OAAO,EAAC,OAAO,EAAC,UAAU,IAA9E,OAAO,CAA0E,CAC7F,CAAC,GACI,CACT;SACF;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,GAAG;YACb,yEAAyE;YACzE,wEAAwE;YACxE,kDAAkD;YAClD,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CACnB,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,aAAa;SAClF;QACD;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;SAChD;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC;SAC3D;QACD;YACE;;;;;eAKG;YACH,EAAE,EAAE,aAAa;YACjB,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CACnB,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ;YACnE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CACpB,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CACtB,KAAC,OAAO,IAAC,KAAK,EAAE,SAAS,CAAC,WAAW,YACnC,KAAC,UAAU,IAAC,OAAO,EAAC,OAAO,EAAC,MAAM,kBAC/B,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,GACpB,GACL,CACX,CAAC,CAAC,CAAC,CACF,KAAC,UAAU,IAAC,OAAO,EAAC,OAAO,EAAC,KAAK,EAAC,gBAAgB,uBAErC,CACd;SACJ;QACD;YACE,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC;SAC1D;QACD;YACE,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC;SAC1D;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC;SAC3D;QACD;YACE;;;;eAIG;YACH,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE;SAChD;QACD;YACE,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE;SACnC;KACF,CAAC;AACJ,CAAC"}

package/dist/notifications/ui/datatable.d.ts

@@ -0,0 +1,14 @@
+export { IdentityTable as DataTable } from '../../identity/index.js';
+export type { IdentityTableRowAction as DataTableRowAction } from '../../identity/index.js';
+import type { IdentityTableColumn, IdentityTableFilter } from '../../identity/index.js';
+/**
+ * One column. The identity column contract plus `align`, which the reference
+ * app's `DataTable` honours (cell and header) and the fallback table ignores.
+ */
+export type DataTableColumn<Row> = IdentityTableColumn<Row> & {
+    /** Cell and header alignment. Default `'left'`. */
+    align?: 'left' | 'center' | 'right';
+};
+/** The table's filter model: one entry per active column filter. */
+export type DataTableFilterModel = IdentityTableFilter[];
+//# sourceMappingURL=datatable.d.ts.map

package/dist/notifications/ui/datatable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datatable.d.ts","sourceRoot":"","sources":["../../../src/notifications/ui/datatable.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,IAAI,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,sBAAsB,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG;IAC5D,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACrC,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,EAAE,CAAC"}

package/dist/notifications/ui/datatable.js

@@ -0,0 +1,8 @@
+// The table the broadcasts page renders through (issue #738): the identity
+// slice's table seam, reused rather than copied. The reference app's
+// responsive `DataTable` arrives through the identity web adapters
+// (`IdentityWebAdaptersProvider`), and a plain MUI table stands in without
+// one. The column, filter and row-action shapes are the same contract.
+// Slice-internal.
+export { IdentityTable as DataTable } from '../../identity/index.js';
+//# sourceMappingURL=datatable.js.map

package/dist/notifications/ui/datatable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datatable.js","sourceRoot":"","sources":["../../../src/notifications/ui/datatable.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AACrE,mEAAmE;AACnE,2EAA2E;AAC3E,uEAAuE;AACvE,kBAAkB;AAElB,OAAO,EAAE,aAAa,IAAI,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/notifications/ui/index.d.ts

@@ -0,0 +1,14 @@
+export { NotificationBell } from './NotificationBell.js';
+export type { NotificationBellProps, NotificationBellSlots } from './NotificationBell.js';
+export { NotificationPermissionBanner } from './NotificationPermissionBanner.js';
+export type { NotificationPermissionBannerProps } from './NotificationPermissionBanner.js';
+export { default as BroadcastsPage } from './BroadcastsPage.js';
+export type { BroadcastsPageProps, BroadcastsPageSlots } from './BroadcastsPage.js';
+export { default as NotificationSettingsPage } from './NotificationSettingsPage.js';
+export type { NotificationSettingsPageProps, NotificationSettingsPageSlots } from './NotificationSettingsPage.js';
+export { default as PushConfigPage } from './PushConfigPage.js';
+export type { PushConfigPageProps, PushConfigPageSlots } from './PushConfigPage.js';
+export { default as UserNotificationsPage } from './UserNotificationsPage.js';
+export type { UserNotificationsPageProps, UserNotificationsPageSlots } from './UserNotificationsPage.js';
+export type { ChannelAlert, ChannelState } from './NotificationSettings.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/notifications/ui/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,YAAY,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACpF,YAAY,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAClH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACzG,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/notifications/ui/index.js

@@ -0,0 +1,13 @@
+// `@marinoscar/platform-web/notifications/ui`: the notifications web slice's
+// components and pages (issue #738, PP-8.5). The app places the bell in its
+// own AppBar and the banner in its own layout (the package never imports the
+// app shell), and lazy-loads the pages by name:
+// `lazy(() => import('@marinoscar/platform-web/notifications/ui').then((m) => ({ default: m.BroadcastsPage })))`.
+// Documented in ../README.md.
+export { NotificationBell } from './NotificationBell.js';
+export { NotificationPermissionBanner } from './NotificationPermissionBanner.js';
+export { default as BroadcastsPage } from './BroadcastsPage.js';
+export { default as NotificationSettingsPage } from './NotificationSettingsPage.js';
+export { default as PushConfigPage } from './PushConfigPage.js';
+export { default as UserNotificationsPage } from './UserNotificationsPage.js';
+//# sourceMappingURL=index.js.map

package/dist/notifications/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/notifications/ui/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,gDAAgD;AAChD,kHAAkH;AAClH,8BAA8B;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/notifications/ui/relativeTime.d.ts

@@ -0,0 +1,25 @@
+/**
+ * "3 minutes ago" for a notification's timestamp.
+ *
+ * Issue #127, epic #109. Used by the notification centre, where an absolute
+ * timestamp is the wrong unit: the question a user asks of a bell is "is this
+ * new?", and `14:03` only answers it if they also know what time it is now.
+ *
+ * BUILT ON `Intl.RelativeTimeFormat`, not on a hand-written table of plurals.
+ * It is in every browser this app supports, it gets the plural rules right for
+ * languages whose plurals are not "add an s", and it is the difference between
+ * localising this later by passing a locale and localising it later by
+ * rewriting it.
+ *
+ * Falls back to the ISO string on an unparseable input rather than rendering
+ * `NaN minutes ago` — a timestamp this code cannot read is still information,
+ * and `Invalid Date` in a notification list looks like data loss.
+ */
+/**
+ * @param iso - an ISO-8601 timestamp, as every API date field in this app is.
+ * @param now - injectable so this is testable without freezing the clock, and so
+ *        a list rendered in one pass dates every row against the same instant
+ *        rather than against seven slightly different ones.
+ */
+export declare function formatRelativeTime(iso: string, now?: Date): string;
+//# sourceMappingURL=relativeTime.d.ts.map

package/dist/notifications/ui/relativeTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relativeTime.d.ts","sourceRoot":"","sources":["../../../src/notifications/ui/relativeTime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAuBH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CA6B9E"}

package/dist/notifications/ui/relativeTime.js

@@ -0,0 +1,70 @@
+/**
+ * "3 minutes ago" for a notification's timestamp.
+ *
+ * Issue #127, epic #109. Used by the notification centre, where an absolute
+ * timestamp is the wrong unit: the question a user asks of a bell is "is this
+ * new?", and `14:03` only answers it if they also know what time it is now.
+ *
+ * BUILT ON `Intl.RelativeTimeFormat`, not on a hand-written table of plurals.
+ * It is in every browser this app supports, it gets the plural rules right for
+ * languages whose plurals are not "add an s", and it is the difference between
+ * localising this later by passing a locale and localising it later by
+ * rewriting it.
+ *
+ * Falls back to the ISO string on an unparseable input rather than rendering
+ * `NaN minutes ago` — a timestamp this code cannot read is still information,
+ * and `Invalid Date` in a notification list looks like data loss.
+ */
+/**
+ * Thresholds, largest unit first. The first entry whose `limit` the elapsed
+ * time is under decides the unit.
+ *
+ * `Infinity` on the last row so the loop always terminates with a real unit —
+ * a table that can fall through needs a fallback branch that will be wrong
+ * exactly once, in a year's time, for the oldest row anybody ever looks at.
+ */
+const UNITS = [
+    { limit: 60_000, ms: 1_000, unit: 'second' },
+    { limit: 3_600_000, ms: 60_000, unit: 'minute' },
+    { limit: 86_400_000, ms: 3_600_000, unit: 'hour' },
+    { limit: 604_800_000, ms: 86_400_000, unit: 'day' },
+    { limit: 2_629_800_000, ms: 604_800_000, unit: 'week' },
+    { limit: 31_557_600_000, ms: 2_629_800_000, unit: 'month' },
+    { limit: Infinity, ms: 31_557_600_000, unit: 'year' },
+];
+/** Under this, say "just now" rather than counting seconds. */
+const JUST_NOW_MS = 45_000;
+/**
+ * @param iso - an ISO-8601 timestamp, as every API date field in this app is.
+ * @param now - injectable so this is testable without freezing the clock, and so
+ *        a list rendered in one pass dates every row against the same instant
+ *        rather than against seven slightly different ones.
+ */
+export function formatRelativeTime(iso, now = new Date()) {
+    const then = new Date(iso);
+    const time = then.getTime();
+    if (Number.isNaN(time))
+        return iso;
+    const elapsed = now.getTime() - time;
+    // A CLOCK-SKEW GUARD, not a hypothetical: the timestamp comes from the API
+    // server and is compared against the browser's clock, which is routinely
+    // wrong by seconds and occasionally by hours. Without this, a notification
+    // that has just arrived renders as "in 2 minutes", which reads as a bug in
+    // the app rather than as a wrong clock on the machine.
+    if (elapsed < JUST_NOW_MS)
+        return 'Just now';
+    const formatter = new Intl.RelativeTimeFormat(undefined, { numeric: 'auto' });
+    for (const { limit, ms, unit } of UNITS) {
+        if (elapsed < limit) {
+            // NEGATIVE, because the event is in the past — `RelativeTimeFormat`
+            // renders a negative value as "3 minutes ago" and a positive one as
+            // "in 3 minutes". Rounding toward zero (`trunc` via the negation of a
+            // floor) keeps "1 hour ago" from appearing 30 minutes early.
+            return formatter.format(-Math.floor(elapsed / ms), unit);
+        }
+    }
+    // Unreachable — the last row's limit is `Infinity`. Present so the function
+    // is total without a non-null assertion.
+    return iso;
+}
+//# sourceMappingURL=relativeTime.js.map

package/dist/notifications/ui/relativeTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relativeTime.js","sourceRoot":"","sources":["../../../src/notifications/ui/relativeTime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;GAOG;AACH,MAAM,KAAK,GAAuE;IAChF,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5C,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChD,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;IAClD,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;IACnD,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;IACvD,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;IAC3D,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE;CACtD,CAAC;AAEF,+DAA+D;AAC/D,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,MAAY,IAAI,IAAI,EAAE;IACpE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAEnC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAErC,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,2EAA2E;IAC3E,uDAAuD;IACvD,IAAI,OAAO,GAAG,WAAW;QAAE,OAAO,UAAU,CAAC;IAE7C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAE9E,KAAK,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACxC,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC;YACpB,oEAAoE;YACpE,oEAAoE;YACpE,sEAAsE;YACtE,6DAA6D;YAC7D,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,yCAAyC;IACzC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/onboarding/headless/client.d.ts

@@ -0,0 +1,44 @@
+import type { OnboardingMetricsResponse, OnboardingResponse } from '@marinoscar/platform-contract/onboarding';
+import type { PlatformApiClient } from '../../core/index.js';
+/**
+ * A write to the stored `onboarding` namespace: platform fields and any field
+ * the app added with `extendOnboardingSettings`. `null` clears a field.
+ *
+ * @stability experimental
+ */
+export type OnboardingSettingsWrite = Readonly<Record<string, unknown>>;
+/**
+ * The onboarding API calls.
+ *
+ * @stability experimental
+ */
+export interface OnboardingClient {
+    /** `GET /onboarding`; `refresh: true` re-runs the Doctor probes behind the admin steps. */
+    get(options?: {
+        refresh?: boolean;
+    }): Promise<OnboardingResponse>;
+    /** `GET /admin/onboarding/metrics?days=`. */
+    metrics(days: number): Promise<OnboardingMetricsResponse>;
+    /**
+     * Writes the stored state through `PATCH /user-settings` with `If-Match`
+     * (the current version, read first), retrying once on a `409`.
+     */
+    write(patch: OnboardingSettingsWrite): Promise<void>;
+}
+/**
+ * The onboarding client over the app's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const client = createOnboardingClient(usePlatformApi());
+ * await client.write({ welcomeSeenAt: new Date().toISOString() });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function createOnboardingClient(api: PlatformApiClient): OnboardingClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/onboarding/headless/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/onboarding/headless/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAG9G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,GAAG,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClE,6CAA6C;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC1D;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CAyB/E"}

package/dist/onboarding/headless/client.js

@@ -0,0 +1,44 @@
+import { ONBOARDING_METRICS_PATH, ONBOARDING_PATH, ONBOARDING_SETTINGS_KEY, } from '@marinoscar/platform-contract/onboarding';
+import { isPlatformApiError } from '../../core/index.js';
+/**
+ * The onboarding client over the app's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const client = createOnboardingClient(usePlatformApi());
+ * await client.write({ welcomeSeenAt: new Date().toISOString() });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function createOnboardingClient(api) {
+    const patchOnce = async (patch) => {
+        const current = await api.get('/user-settings');
+        await api.patch('/user-settings', { [ONBOARDING_SETTINGS_KEY]: patch }, { ifMatch: String(current.version) });
+    };
+    return {
+        get(options = {}) {
+            return api.get(options.refresh ? `${ONBOARDING_PATH}?refresh=true` : ONBOARDING_PATH);
+        },
+        metrics(days) {
+            return api.get(`${ONBOARDING_METRICS_PATH}?days=${encodeURIComponent(String(days))}`);
+        },
+        async write(patch) {
+            try {
+                await patchOnce(patch);
+            }
+            catch (error) {
+                if (isPlatformApiError(error) && error.status === 409) {
+                    await patchOnce(patch);
+                    return;
+                }
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/onboarding/headless/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/onboarding/headless/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,uBAAuB,GACxB,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA4BzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAsB;IAC3D,MAAM,SAAS,GAAG,KAAK,EAAE,KAA8B,EAAE,EAAE;QACzD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAsB,gBAAgB,CAAC,CAAC;QACrE,MAAM,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,CAAC,uBAAuB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,CAAC,OAAO,GAAG,EAAE;YACd,OAAO,GAAG,CAAC,GAAG,CAAqB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,eAAe,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAC5G,CAAC;QACD,OAAO,CAAC,IAAI;YACV,OAAO,GAAG,CAAC,GAAG,CAA4B,GAAG,uBAAuB,SAAS,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACnH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACtD,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}