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

package/dist/notifications/headless/service-worker.d.ts

@@ -0,0 +1,242 @@
+/**
+ * One action button on a push notification, as an app's `pushPayload` hook
+ * added it.
+ *
+ * @stability experimental
+ */
+export interface NotificationAction {
+    /** The action id. */
+    action: string;
+    /** The button label. */
+    title: string;
+    /** An icon: a root-relative path or an `https:` URL. */
+    icon?: string;
+}
+/**
+ * The payload the API's push channel sends as the Web Push message body
+ * (JSON, under the 4 KB push payload limit). `id` and `link` ride into
+ * `notification.data` for the click handler.
+ *
+ * @stability experimental
+ */
+export interface NotificationPushPayload {
+    /** The notification row's id (`''` for a test push). */
+    id: string;
+    /** The event key. */
+    eventKey: string;
+    /** The title. */
+    title: string;
+    /** The body. */
+    body: string;
+    /** A root-relative link (re-validated before any navigation). */
+    link: string;
+    /** Set only by the admin "Send test push" action (#618). */
+    test?: boolean;
+    /** A collapse tag an app's `pushPayload` hook added (PP-14.10); the notification id when absent. */
+    tag?: string;
+    /** An icon an app's `pushPayload` hook added; the configured default when absent. */
+    icon?: string;
+    /** A badge an app's `pushPayload` hook added; the configured default when absent. */
+    badge?: string;
+    /** Up to two action buttons an app's `pushPayload` hook added. A click on one opens the notification's link, as a click on the notification does. */
+    actions?: NotificationAction[];
+}
+/**
+ * The options `showNotification` takes, as the handlers pass them.
+ *
+ * @stability experimental
+ */
+export interface NotificationsShowOptions {
+    /** The body text. */
+    body?: string;
+    /** The de-dup tag. */
+    tag?: string;
+    /** The icon URL. */
+    icon?: string;
+    /** The status-bar badge URL. */
+    badge?: string;
+    /** Action buttons. */
+    actions?: NotificationAction[];
+    /** Data handed to the click handler. */
+    data?: unknown;
+}
+/**
+ * A window client, as the click handler and the test-push ack see it.
+ *
+ * @stability experimental
+ */
+export interface NotificationsServiceWorkerClient {
+    /** The client's URL. */
+    readonly url: string;
+    /** Posts a message to the page. */
+    postMessage(message: unknown): void;
+}
+/**
+ * The members of a `ServiceWorkerGlobalScope` the handlers call.
+ *
+ * @stability experimental
+ */
+export interface NotificationsServiceWorkerScope {
+    /** The worker's registration. */
+    readonly registration: {
+        /** Shows an OS notification. */
+        showNotification(title: string, options?: NotificationsShowOptions): Promise<void>;
+        /** The push manager (resubscription). */
+        readonly pushManager: {
+            /** Subscribes this browser to push. */
+            subscribe(options: {
+                applicationServerKey: BufferSource | string | null;
+                userVisibleOnly: boolean;
+            }): Promise<unknown>;
+        };
+    };
+    /** The worker's clients. */
+    readonly clients: {
+        /** The open window clients. */
+        matchAll(options: {
+            type: 'window';
+            includeUncontrolled: boolean;
+        }): Promise<ReadonlyArray<NotificationsServiceWorkerClient>>;
+        /** Opens a new window at a URL. */
+        openWindow(url: string): Promise<unknown>;
+    };
+    /**
+     * Adds an event listener. The event is untyped here: the worker's own
+     * overloads type it per event name, which a structural shape cannot repeat.
+     */
+    addEventListener(type: string, listener: (event: any) => void): void;
+}
+/**
+ * An event the worker must keep alive until its work settles.
+ *
+ * @stability experimental
+ */
+export interface NotificationsExtendableEvent {
+    /** Keeps the worker alive until the promise settles. */
+    waitUntil(promise: Promise<unknown>): void;
+}
+/**
+ * A `push` event, as {@link handlePushEvent} reads it.
+ *
+ * @stability experimental
+ */
+export interface NotificationsPushEvent extends NotificationsExtendableEvent {
+    /** The message data, or null for an empty push. */
+    readonly data: {
+        /** The payload, parsed as JSON (throws on malformed JSON). */
+        json(): unknown;
+    } | null;
+}
+/**
+ * A `notificationclick` event, as {@link handleNotificationClick} reads it.
+ *
+ * @stability experimental
+ */
+export interface NotificationsClickEvent extends NotificationsExtendableEvent {
+    /** The clicked notification. */
+    readonly notification: {
+        /** Dismisses it. */
+        close(): void;
+        /** The data it was shown with (`{ id, link }`). */
+        readonly data: unknown;
+    };
+}
+/**
+ * A `pushsubscriptionchange` event. `oldSubscription` is in the Push API spec
+ * and missing from TypeScript's own lib.
+ *
+ * @stability experimental
+ */
+export interface NotificationsPushSubscriptionChangeEvent extends NotificationsExtendableEvent {
+    /** The subscription that changed, or null. */
+    readonly oldSubscription?: {
+        /** The options it was created with. */
+        readonly options?: {
+            /** The VAPID key it was created with. */
+            readonly applicationServerKey?: ArrayBuffer | null;
+        };
+    } | null;
+}
+/**
+ * The icons a push notification shows.
+ *
+ * @stability experimental
+ */
+export interface NotificationServiceWorkerOptions {
+    /** The notification icon. Default `/icons/icon-192.png`. */
+    icon?: string;
+    /** The status-bar badge. Default `/icons/badge-96.png`. */
+    badge?: string;
+}
+/**
+ * Handles a `notificationclick`: closes the notification, re-validates its
+ * link (root-relative only, `//` rejected; anything else falls back to `/`),
+ * then focuses an open window and posts it the click, or opens a new window
+ * with the id in a `?n=` query param. Never calls the API.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param event - the click event.
+ *
+ * @example
+ * ```ts
+ * self.addEventListener('notificationclick', (event) => handleNotificationClick(self, event));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function handleNotificationClick(scope: NotificationsServiceWorkerScope, event: NotificationsClickEvent): void;
+/**
+ * Handles a `push`: shows the payload as an OS notification, ALWAYS (a
+ * focused tab raises no toast of its own for a pushed event, so the worker
+ * staying quiet would leave the user with nothing). A malformed payload shows
+ * a generic notification: a push that shows nothing makes Chrome show its own
+ * "updated in the background" notice instead. A test push (#618) is shown
+ * and then acknowledged to every window client.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param event - the push event.
+ * @param options - the icons.
+ * @returns when the notification is shown; pass it to `event.waitUntil`.
+ *
+ * @example
+ * ```ts
+ * self.addEventListener('push', (event) => event.waitUntil(handlePushEvent(self, event)));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function handlePushEvent(scope: NotificationsServiceWorkerScope, event: NotificationsPushEvent, options?: NotificationServiceWorkerOptions): Promise<void>;
+/**
+ * Handles a `pushsubscriptionchange`: resubscribes with the old
+ * subscription's key, best effort. Never POSTs the new subscription (no token
+ * here); the page re-syncs on its next load, which is the real mechanism.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param event - the change event.
+ * @returns when the attempt settles; never rejects.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function handlePushSubscriptionChange(scope: NotificationsServiceWorkerScope, event: NotificationsPushSubscriptionChangeEvent): Promise<void>;
+/**
+ * Adds the three notification listeners (`push`, `notificationclick`,
+ * `pushsubscriptionchange`) to the worker. Call it once from the app's
+ * `sw.ts`.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param options - the push notification icons.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/sw.ts
+ * registerNotificationServiceWorkerHandlers(self, { icon: '/icons/icon-192.png', badge: '/icons/badge-96.png' });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function registerNotificationServiceWorkerHandlers(scope: NotificationsServiceWorkerScope, options?: NotificationServiceWorkerOptions): void;
+//# sourceMappingURL=service-worker.d.ts.map

package/dist/notifications/headless/service-worker.d.ts.map

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

package/dist/notifications/headless/service-worker.js

@@ -0,0 +1,226 @@
+// =============================================================================
+// The notifications half of an app's service worker (issue #738; behaviour
+// from #222, #223, #230 and #618, moved from the reference app's `src/sw.ts`)
+// =============================================================================
+//
+// The app keeps its own `sw.ts` (the precache manifest, the SPA fallback, the
+// update handshake are the app's), and calls
+// {@link registerNotificationServiceWorkerHandlers} once from it, which adds
+// the `push`, `notificationclick` and `pushsubscriptionchange` listeners
+// below. The handlers are also exported one by one for an app that composes
+// its own listeners.
+//
+// -----------------------------------------------------------------------
+// HARD CONSTRAINT: THESE HANDLERS NEVER CALL THE API
+// -----------------------------------------------------------------------
+//
+// A worker has no way to authenticate: the access token is memory-only in the
+// page, and the refresh cookie is rotated on every use, so a worker that
+// refreshed on its own would spend the page's one-shot refresh token and log
+// the user out. Anything a handler needs arrives in the push payload, and
+// every API call a click implies (mark read) is handed to a page that holds a
+// token (`postMessage`, or the `?n=` query param on a cold open, both read by
+// `NotificationProvider`).
+//
+// THE SCOPE IS STRUCTURAL. This module is compiled with the DOM library, not
+// the WebWorker one, so it names only the members it calls
+// ({@link NotificationsServiceWorkerScope}); an app's
+// `ServiceWorkerGlobalScope` (`self`) is assignable to it as it is.
+// =============================================================================
+import { isInternalLink } from './internalLink.js';
+/** The message a page receives for a click on a worker-shown notification. */
+const CLICK_MESSAGE = 'notification-click';
+/** The message a page receives when a test push arrived. */
+const TEST_ACK_MESSAGE = 'push-test-received';
+function iconsOf(options) {
+    return { icon: options?.icon ?? '/icons/icon-192.png', badge: options?.badge ?? '/icons/badge-96.png' };
+}
+/**
+ * Handles a `notificationclick`: closes the notification, re-validates its
+ * link (root-relative only, `//` rejected; anything else falls back to `/`),
+ * then focuses an open window and posts it the click, or opens a new window
+ * with the id in a `?n=` query param. Never calls the API.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param event - the click event.
+ *
+ * @example
+ * ```ts
+ * self.addEventListener('notificationclick', (event) => handleNotificationClick(self, event));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function handleNotificationClick(scope, event) {
+    // Dismissed first: left open, the OS lets it be clicked again while this runs.
+    event.notification.close();
+    const data = (event.notification.data ?? {});
+    const id = typeof data.id === 'string' ? data.id : '';
+    const rawLink = typeof data.link === 'string' ? data.link : null;
+    const link = isInternalLink(rawLink) ? rawLink : '/';
+    event.waitUntil((async () => {
+        // `includeUncontrolled`: a tab open before this worker activated is not
+        // controlled by it, and would otherwise read as a cold open.
+        const windowClients = (await scope.clients.matchAll({ type: 'window', includeUncontrolled: true }));
+        if (windowClients.length > 0) {
+            const linkPath = link.split('?')[0];
+            const target = windowClients.find((client) => {
+                try {
+                    return new URL(client.url).pathname === linkPath;
+                }
+                catch {
+                    return false;
+                }
+            }) ?? windowClients[0];
+            await target.focus();
+            target.postMessage({ type: CLICK_MESSAGE, id, link });
+            return;
+        }
+        const separator = link.includes('?') ? '&' : '?';
+        await scope.clients.openWindow(`${link}${separator}n=${encodeURIComponent(id)}`);
+    })());
+}
+async function showTestPush(scope, payload, icons) {
+    const windowClients = (await scope.clients.matchAll({ type: 'window', includeUncontrolled: true }));
+    const hadFocusedClient = windowClients.some((client) => client.visibilityState === 'visible' && client.focused === true);
+    let shown = false;
+    let error;
+    try {
+        await scope.registration.showNotification(payload.title, {
+            body: payload.body,
+            tag: payload.id,
+            ...icons,
+            // `id: ''`: a test names no notification row, so nothing is marked read.
+            data: { id: '', link: payload.link, test: true },
+        });
+        shown = true;
+    }
+    catch (err) {
+        error = err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+    }
+    const ack = {
+        type: TEST_ACK_MESSAGE,
+        id: payload.id,
+        receivedAt: Date.now(),
+        shown,
+        hadFocusedClient,
+        ...(error ? { error } : {}),
+    };
+    for (const client of windowClients) {
+        try {
+            client.postMessage(ack);
+        }
+        catch {
+            // One client refusing the message must not stop the others hearing it.
+        }
+    }
+}
+/**
+ * Handles a `push`: shows the payload as an OS notification, ALWAYS (a
+ * focused tab raises no toast of its own for a pushed event, so the worker
+ * staying quiet would leave the user with nothing). A malformed payload shows
+ * a generic notification: a push that shows nothing makes Chrome show its own
+ * "updated in the background" notice instead. A test push (#618) is shown
+ * and then acknowledged to every window client.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param event - the push event.
+ * @param options - the icons.
+ * @returns when the notification is shown; pass it to `event.waitUntil`.
+ *
+ * @example
+ * ```ts
+ * self.addEventListener('push', (event) => event.waitUntil(handlePushEvent(self, event)));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export async function handlePushEvent(scope, event, options) {
+    const icons = iconsOf(options);
+    let payload;
+    try {
+        if (!event.data)
+            throw new Error('push event carried no data');
+        payload = event.data.json();
+    }
+    catch {
+        await scope.registration.showNotification('New notification', {
+            body: 'You have a new notification',
+            ...icons,
+            tag: 'push-fallback',
+        });
+        return;
+    }
+    if (payload.test === true) {
+        await showTestPush(scope, payload, icons);
+        return;
+    }
+    await scope.registration.showNotification(payload.title, {
+        body: payload.body,
+        // Keyed by the notification id: repeated pushes of one row collapse. An
+        // app's own tag (PP-14.10) collapses pushes of different rows instead.
+        tag: typeof payload.tag === 'string' && payload.tag !== '' ? payload.tag : payload.id,
+        ...icons,
+        // The app's icon and badge, when its hook added them; the payload came
+        // through the API's allowlist, which only lets a root-relative path or an
+        // `https:` URL through.
+        ...(typeof payload.icon === 'string' ? { icon: payload.icon } : {}),
+        ...(typeof payload.badge === 'string' ? { badge: payload.badge } : {}),
+        ...(Array.isArray(payload.actions) && payload.actions.length > 0 ? { actions: payload.actions.slice(0, 2) } : {}),
+        data: { id: payload.id, link: payload.link },
+    });
+}
+/**
+ * Handles a `pushsubscriptionchange`: resubscribes with the old
+ * subscription's key, best effort. Never POSTs the new subscription (no token
+ * here); the page re-syncs on its next load, which is the real mechanism.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param event - the change event.
+ * @returns when the attempt settles; never rejects.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export async function handlePushSubscriptionChange(scope, event) {
+    const applicationServerKey = event.oldSubscription?.options?.applicationServerKey;
+    if (!applicationServerKey)
+        return;
+    try {
+        await scope.registration.pushManager.subscribe({ applicationServerKey, userVisibleOnly: true });
+    }
+    catch (error) {
+        console.warn('Service worker push resubscription failed; page will resync on next load.', error);
+    }
+}
+/**
+ * Adds the three notification listeners (`push`, `notificationclick`,
+ * `pushsubscriptionchange`) to the worker. Call it once from the app's
+ * `sw.ts`.
+ *
+ * @param scope - the worker's global scope (`self`).
+ * @param options - the push notification icons.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/sw.ts
+ * registerNotificationServiceWorkerHandlers(self, { icon: '/icons/icon-192.png', badge: '/icons/badge-96.png' });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function registerNotificationServiceWorkerHandlers(scope, options) {
+    scope.addEventListener('notificationclick', (event) => {
+        handleNotificationClick(scope, event);
+    });
+    scope.addEventListener('push', (event) => {
+        event.waitUntil(handlePushEvent(scope, event, options));
+    });
+    scope.addEventListener('pushsubscriptionchange', (event) => {
+        event.waitUntil(handlePushSubscriptionChange(scope, event));
+    });
+}
+//# sourceMappingURL=service-worker.js.map

package/dist/notifications/headless/service-worker.js.map

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

package/dist/notifications/headless/sse.d.ts

@@ -0,0 +1,58 @@
+/**
+ * One dispatched SSE event.
+ *
+ * @stability experimental
+ */
+export interface SseFrame {
+    /** The `event:` name, or `'message'`. */
+    event: string;
+    /** The `data:` lines, joined. */
+    data: string;
+    /** The `id:` field of this frame, or `null`. */
+    id: string | null;
+}
+/**
+ * The connection's lifecycle.
+ *
+ * @stability experimental
+ */
+export type SseState = 'connecting' | 'open' | 'reconnecting' | 'closed';
+/**
+ * What `connectSse` takes.
+ *
+ * @stability experimental
+ */
+export interface SseOptions {
+    /** The stream URL. */
+    url: string;
+    /** The current `Authorization` header value, or `null`. */
+    authorization: () => string | null;
+    /** Refreshes the session after a 401; resolves whether it worked. */
+    reauthenticate: () => Promise<boolean>;
+    /** Called when the stream opens. */
+    onOpen: () => void;
+    /** Called per frame. */
+    onFrame: (frame: SseFrame) => void;
+    /** Called on every state change. */
+    onStateChange?: (state: SseState) => void;
+}
+/**
+ * An open connection.
+ *
+ * @stability experimental
+ */
+export interface SseConnection {
+    /** Closes it for good. */
+    close: () => void;
+}
+/**
+ * Opens a connection through the app's configured connector; without one, a
+ * closed no-op connection (the inbox still loads, no live frames arrive).
+ *
+ * @param options - the connection options.
+ * @returns the connection.
+ *
+ * @stability experimental
+ */
+export declare function connectSse(options: SseOptions): SseConnection;
+//# sourceMappingURL=sse.d.ts.map

package/dist/notifications/headless/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/notifications/headless/sse.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,qEAAqE;IACrE,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,oCAAoC;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,wBAAwB;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,oCAAoC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAO7D"}

package/dist/notifications/headless/sse.js

@@ -0,0 +1,23 @@
+// The SSE connection the notification stream opens (issue #738): the shape of
+// `@marinoscar/platform-web/core`'s `connectSse`, which the app hands in
+// through `configureNotificationsWeb({ connectSse })` (bearer token, reconnect
+// with backoff, maintenance handling stay the app's).
+import { notificationsWebConfig } from './api.js';
+/**
+ * Opens a connection through the app's configured connector; without one, a
+ * closed no-op connection (the inbox still loads, no live frames arrive).
+ *
+ * @param options - the connection options.
+ * @returns the connection.
+ *
+ * @stability experimental
+ */
+export function connectSse(options) {
+    const connect = notificationsWebConfig().connectSse;
+    if (!connect) {
+        options.onStateChange?.('closed');
+        return { close: () => undefined };
+    }
+    return connect(options);
+}
+//# sourceMappingURL=sse.js.map

package/dist/notifications/headless/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/notifications/headless/sse.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AACzE,+EAA+E;AAC/E,sDAAsD;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAqDlD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,OAAmB;IAC5C,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC,UAAU,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC"}