@gitkraken/core-gitlens 0.24.0 → 0.25.0

package/dist/plus/notifications/notificationsService.js

@@ -0,0 +1,381 @@
+import { Emitter } from "../../utils/event.js";
+import { NotificationsApiError } from "./errors.js";
+import { isToastEligible } from "./presentation.js";
+import { NotificationsApi } from "./api.js";
+//#region ../plus/notifications/src/notificationsService.ts
+/**
+* How far before the newest previously-held notification's `createdAt` a notification may fall and still count as
+* newly arrived in {@link NotificationsService.refresh}'s result. Both sides are server timestamps; the margin only
+* covers concurrent inserts committing out of `created_at` order on the server.
+*/
+const newToastableSkewMargin = 3e5;
+/** At most this many pages are re-fetched by a refresh; anything paged in beyond them is dropped until loaded again */
+const maxRefreshPages = 5;
+/**
+* Holds the user's notifications for one product and keeps them in sync with `notifications-service-v2`.
+* Read/unread/delete and settings changes apply optimistically and roll back if the request fails (a 404 on
+* read/unread/delete means the notifications are already gone, so it isn't a failure). The service never polls on
+* its own: the host decides when to {@link refresh}, and each refresh reports which notices newly arrived and
+* should toast; how (and whether) to show them stays the host's call.
+*/
+var NotificationsService = class {
+	context;
+	_onDidChange = new Emitter();
+	get onDidChange() {
+		return this._onDidChange.event;
+	}
+	api;
+	_items = [];
+	_hasMore = false;
+	/** The last page loaded, 1-based; 0 before the first load. */
+	_page = 0;
+	_status = "idle";
+	_lastSyncedAt;
+	_settings;
+	/** The settings the server last acknowledged (fetched, or successfully saved) */
+	_confirmedSettings;
+	_settingsPost;
+	_settingsFollowUp;
+	_refreshing;
+	_loadingMore;
+	/**
+	* Actions in flight (or settled while a refresh that started before them was still fetching), by id. A refresh
+	* re-applies them so data fetched before the server saw an action doesn't undo it.
+	*/
+	_overrides = /* @__PURE__ */ new Map();
+	/** For items a refresh re-applied an override to: the override's output → which override and the server's item */
+	_overridden = /* @__PURE__ */ new WeakMap();
+	constructor(context) {
+		this.context = context;
+		this.api = new NotificationsApi(context);
+	}
+	dispose() {
+		this._onDidChange.dispose();
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	get unreadCount() {
+		return this._items.reduce((count, n) => n.readAt == null ? count + 1 : count, 0);
+	}
+	getState() {
+		return {
+			items: this._items,
+			hasMore: this._hasMore,
+			status: this._status,
+			lastSyncedAt: this._lastSyncedAt,
+			settings: this._settings,
+			unreadCount: this.unreadCount
+		};
+	}
+	/**
+	* Re-fetches every page already loaded (up to {@link maxRefreshPages}), so read state, deletions and expiry
+	* from elsewhere reach them without collapsing a list the user paged through. Expired items are pruned and
+	* local actions still in flight are kept. Never throws: on failure the cached items stay and the status
+	* becomes `error`.
+	*
+	* Resolves to the notices to toast: the unread, toast-eligible ones that newly arrived with this refresh,
+	* newest first. Empty when the refresh failed, when nothing had synced before it (no backfill: the first load
+	* for an account is the existing inbox, not news; a restored snapshot with a `lastSyncedAt` does count as
+	* synced, so what arrived while the host was closed still toasts), or when nothing is new. New means its id
+	* wasn't held before the refresh AND it was created after the newest of those held, less
+	* {@link newToastableSkewMargin}. Only server timestamps are compared, so the client's clock can't hide a
+	* notice. The id check keeps a notice already seen from toasting again; the time check keeps an old one that
+	* only now shifts into the first page (after a deletion, or a page boundary moving) from toasting as if it
+	* were new. With nothing held before there is no cutoff.
+	*
+	* Concurrent calls share one request and resolve to the same list, so the result is for ONE caller to act on
+	* once (the host's refresh loop); other callers should ignore it.
+	*/
+	refresh() {
+		this._refreshing ??= this.refreshCore().finally(() => {
+			this._refreshing = void 0;
+		});
+		return this._refreshing;
+	}
+	async refreshCore() {
+		this.setStatus("loading");
+		await this._loadingMore?.catch(() => void 0);
+		const previous = this._items;
+		const previouslySynced = this._lastSyncedAt != null;
+		let arrived = [];
+		try {
+			const pages = Math.min(Math.max(this._page, 1), maxRefreshPages);
+			const items = [];
+			const seen = /* @__PURE__ */ new Set();
+			let page = 0;
+			let hasMore = true;
+			while (hasMore && page < pages) {
+				page++;
+				const next = await this.api.list(page);
+				for (const n of next.items) if (!seen.has(n.id)) {
+					seen.add(n.id);
+					items.push(n);
+				}
+				hasMore = next.hasMore;
+			}
+			this._items = sortNewestFirst(this.pruneExpired(this.applyOverrides(items)));
+			this._hasMore = hasMore;
+			this._page = page;
+			this._lastSyncedAt = this.now();
+			this._status = "ready";
+			if (previouslySynced) arrived = this.newToastableSince(previous);
+		} catch (ex) {
+			this.context.log?.error?.(ex, "Unable to refresh notifications");
+			this._status = "error";
+		}
+		this.fireChange();
+		return arrived;
+	}
+	/**
+	* Loads the next page, after any refresh in flight (which may change which page is next). Throws on failure,
+	* leaving the loaded items as they were. Concurrent calls share one request.
+	*/
+	loadMore() {
+		this._loadingMore ??= this.loadMoreCore().finally(() => {
+			this._loadingMore = void 0;
+		});
+		return this._loadingMore;
+	}
+	async loadMoreCore() {
+		if (this._refreshing != null) await this._refreshing;
+		if (!this._hasMore) return;
+		const page = this._page + 1;
+		const next = await this.api.list(page);
+		const ids = new Set(this._items.map((n) => n.id));
+		const added = this.applyOverrides(next.items.filter((n) => !ids.has(n.id)));
+		this._items = sortNewestFirst(this.pruneExpired([...this._items, ...added]));
+		this._page = page;
+		this._hasMore = next.hasMore;
+		this.fireChange();
+	}
+	markRead(ids) {
+		const readAt = this.now();
+		return this.updateOptimistically(ids, (n) => n.readAt == null ? {
+			...n,
+			readAt
+		} : n, () => this.api.markRead(ids));
+	}
+	markUnread(ids) {
+		return this.updateOptimistically(ids, (n) => {
+			if (n.readAt == null) return n;
+			const { readAt: _, ...unread } = n;
+			return unread;
+		}, () => this.api.markUnread(ids));
+	}
+	async delete(ids) {
+		if (!ids.length) return;
+		const deleting = new Set(ids);
+		const removed = this._items.filter((n) => deleting.has(n.id));
+		this._items = this._items.filter((n) => !deleting.has(n.id));
+		const release = this.trackOverrides(ids, "deleted");
+		this.fireChange();
+		try {
+			await this.api.delete(ids);
+			release(true);
+		} catch (ex) {
+			if (NotificationsApiError.is(ex) && ex.status === 404) {
+				release(true);
+				return;
+			}
+			release(false);
+			const present = new Set(this._items.map((n) => n.id));
+			this._items = sortNewestFirst([...this._items, ...removed.filter((n) => !present.has(n.id))]);
+			this.fireChange();
+			throw ex;
+		}
+	}
+	/** Marks every loaded unread notification read. */
+	markAllRead() {
+		return this.markRead(this._items.filter((n) => n.readAt == null).map((n) => n.id));
+	}
+	/** Deletes every loaded read notification. */
+	deleteAllRead() {
+		return this.delete(this._items.filter((n) => n.readAt != null).map((n) => n.id));
+	}
+	/** Fetches the user's notification settings (and caches them in the state). */
+	async getSettings() {
+		const settings = await this.api.getSettings();
+		this._settings = settings;
+		this._confirmedSettings = settings;
+		this.fireChange();
+		return settings;
+	}
+	/**
+	* Applies `changes` optimistically, then saves. The server stores the whole settings object from each request,
+	* so POSTs must not overlap (they could land out of order and leave the older state): at most one is in flight,
+	* and calls made meanwhile share ONE follow-up POST that sends the latest state. Each call settles with the
+	* outcome of the POST that carried its change.
+	*/
+	async updateSettings(changes) {
+		let current = this._settings;
+		if (current == null) {
+			const fetched = await this.api.getSettings();
+			this._settings ??= fetched;
+			this._confirmedSettings ??= fetched;
+			current = this._settings;
+		}
+		this._settings = {
+			...current,
+			...changes
+		};
+		this.fireChange();
+		if (this._settingsFollowUp != null) return this._settingsFollowUp;
+		if (this._settingsPost == null) return this.trackSettingsPost(this.postSettings());
+		const follow = this._settingsPost.catch(() => void 0).then(() => {
+			this._settingsFollowUp = void 0;
+			return this.postSettings();
+		});
+		this._settingsFollowUp = follow;
+		return this.trackSettingsPost(follow);
+	}
+	trackSettingsPost(post) {
+		this._settingsPost = post;
+		const clear = () => {
+			if (this._settingsPost === post) this._settingsPost = void 0;
+		};
+		post.then(clear, clear);
+		return post;
+	}
+	/** Sends the latest optimistic settings; the confirmed state is what was sent, not the server's echo. */
+	async postSettings() {
+		const settings = this._settings;
+		try {
+			await this.api.updateSettings(settings);
+		} catch (ex) {
+			if (this._settings === settings) {
+				this._settings = this._confirmedSettings;
+				this.fireChange();
+			}
+			throw ex;
+		}
+		this._confirmedSettings = settings;
+		return settings;
+	}
+	/** The held notices that are new relative to `previous`, newest first; see {@link refresh} for the rules */
+	newToastableSince(previous) {
+		const knownIds = /* @__PURE__ */ new Set();
+		let newest = Number.NEGATIVE_INFINITY;
+		for (const n of previous) {
+			knownIds.add(n.id);
+			if (n.createdAt > newest) newest = n.createdAt;
+		}
+		const cutoff = newest - newToastableSkewMargin;
+		return this._items.filter((n) => !knownIds.has(n.id) && n.createdAt > cutoff && n.readAt == null && isToastEligible(n));
+	}
+	toSnapshot() {
+		return {
+			items: this._items,
+			hasMore: this._hasMore,
+			page: this._page,
+			lastSyncedAt: this._lastSyncedAt,
+			settings: this._settings
+		};
+	}
+	/** Seeds the state from a snapshot the host persisted; expired items are pruned. */
+	restore(snapshot) {
+		const items = Array.isArray(snapshot.items) ? snapshot.items.filter((n) => typeof n?.id === "string" && typeof n.createdAt === "number") : [];
+		this._items = sortNewestFirst(this.pruneExpired(items));
+		this._hasMore = snapshot.hasMore === true;
+		this._page = typeof snapshot.page === "number" ? snapshot.page : items.length ? 1 : 0;
+		this._lastSyncedAt = snapshot.lastSyncedAt;
+		this._settings = snapshot.settings;
+		this._confirmedSettings = snapshot.settings;
+		this.fireChange();
+	}
+	/** On a 404 (the notifications are already gone) the targets are removed instead of rolled back. */
+	async updateOptimistically(ids, update, request) {
+		if (!ids.length) return;
+		const targets = new Set(ids);
+		const previous = /* @__PURE__ */ new Map();
+		const updated = /* @__PURE__ */ new Map();
+		this._items = this._items.map((n) => {
+			if (!targets.has(n.id)) return n;
+			const next = update(n);
+			if (next !== n) {
+				previous.set(n.id, n);
+				updated.set(n.id, next);
+			}
+			return next;
+		});
+		const release = this.trackOverrides([...updated.keys()], update);
+		this.fireChange();
+		try {
+			await request();
+			release(true);
+		} catch (ex) {
+			if (NotificationsApiError.is(ex) && ex.status === 404) {
+				release(false);
+				this._items = this._items.filter((n) => !targets.has(n.id));
+				this.trackOverrides(ids, "deleted")(true);
+				this.fireChange();
+				return;
+			}
+			release(false);
+			this._items = this._items.map((n) => {
+				if (updated.get(n.id) === n) return previous.get(n.id) ?? n;
+				const overridden = this._overridden.get(n);
+				return overridden?.override === update ? overridden.server : n;
+			});
+			this.fireChange();
+			throw ex;
+		}
+	}
+	/**
+	* Records `override` for `ids` until the action settles; on success, until any refresh or Load More in flight
+	* (either may have fetched before the server applied the action) has landed too. Returns the release for when
+	* it settles.
+	*/
+	trackOverrides(ids, override) {
+		for (const id of ids) this._overrides.set(id, override);
+		return (succeeded) => {
+			const clear = () => {
+				for (const id of ids) if (this._overrides.get(id) === override) this._overrides.delete(id);
+			};
+			const inFlight = [this._refreshing, this._loadingMore].filter((p) => p != null);
+			if (succeeded && inFlight.length) Promise.allSettled(inFlight).then(clear);
+			else clear();
+		};
+	}
+	applyOverrides(items) {
+		if (!this._overrides.size) return items;
+		const result = [];
+		for (const n of items) {
+			const override = this._overrides.get(n.id);
+			if (override === "deleted") continue;
+			if (override == null) {
+				result.push(n);
+				continue;
+			}
+			const output = override(n);
+			if (output !== n) this._overridden.set(output, {
+				override,
+				server: n
+			});
+			result.push(output);
+		}
+		return result;
+	}
+	pruneExpired(items) {
+		const now = this.now();
+		return items.filter((n) => n.expiresAt == null || n.expiresAt > now);
+	}
+	setStatus(status) {
+		if (this._status === status) return;
+		this._status = status;
+		this.fireChange();
+	}
+	fireChange() {
+		this._onDidChange.fire(void 0);
+	}
+	now() {
+		return this.context.now?.() ?? Date.now();
+	}
+};
+function sortNewestFirst(items) {
+	return items.sort((a, b) => b.createdAt - a.createdAt);
+}
+//#endregion
+export { NotificationsService, newToastableSkewMargin };
+
+//# sourceMappingURL=notificationsService.js.map

package/dist/plus/notifications/notificationsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationsService.js","names":[],"sources":["../../../../plus/notifications/src/notificationsService.ts"],"sourcesContent":["import type { UnifiedDisposable } from '@gitlens/utils/disposable.js';\nimport type { Event } from '@gitlens/utils/event.js';\nimport { Emitter } from '@gitlens/utils/event.js';\nimport { NotificationsApi } from './api.js';\nimport type { NotificationsContext } from './context.js';\nimport { NotificationsApiError } from './errors.js';\nimport type {\n\tGkNotification,\n\tNotificationSettings,\n\tNotificationsSnapshot,\n\tNotificationsState,\n\tNotificationsStatus,\n} from './models.js';\nimport { isToastEligible } from './presentation.js';\n\n/**\n * How far before the newest previously-held notification's `createdAt` a notification may fall and still count as\n * newly arrived in {@link NotificationsService.refresh}'s result. Both sides are server timestamps; the margin only\n * covers concurrent inserts committing out of `created_at` order on the server.\n */\nexport const newToastableSkewMargin = 5 * 60 * 1000; // 5 minutes\n\n/** At most this many pages are re-fetched by a refresh; anything paged in beyond them is dropped until loaded again */\nconst maxRefreshPages = 5;\n\n/** A change an action made locally that a refresh must keep until the server is known to reflect it */\ntype Override = ((n: GkNotification) => GkNotification) | 'deleted';\n\n/**\n * Holds the user's notifications for one product and keeps them in sync with `notifications-service-v2`.\n * Read/unread/delete and settings changes apply optimistically and roll back if the request fails (a 404 on\n * read/unread/delete means the notifications are already gone, so it isn't a failure). The service never polls on\n * its own: the host decides when to {@link refresh}, and each refresh reports which notices newly arrived and\n * should toast; how (and whether) to show them stays the host's call.\n */\nexport class NotificationsService implements UnifiedDisposable {\n\tprivate readonly _onDidChange = new Emitter<void>();\n\tget onDidChange(): Event<void> {\n\t\treturn this._onDidChange.event;\n\t}\n\n\tprivate readonly api: NotificationsApi;\n\tprivate _items: GkNotification[] = [];\n\tprivate _hasMore = false;\n\t/** The last page loaded, 1-based; 0 before the first load. */\n\tprivate _page = 0;\n\tprivate _status: NotificationsStatus = 'idle';\n\tprivate _lastSyncedAt: number | undefined;\n\tprivate _settings: NotificationSettings | undefined;\n\t/** The settings the server last acknowledged (fetched, or successfully saved) */\n\tprivate _confirmedSettings: NotificationSettings | undefined;\n\tprivate _settingsPost: Promise<NotificationSettings> | undefined;\n\tprivate _settingsFollowUp: Promise<NotificationSettings> | undefined;\n\tprivate _refreshing: Promise<GkNotification[]> | undefined;\n\tprivate _loadingMore: Promise<void> | undefined;\n\t/**\n\t * Actions in flight (or settled while a refresh that started before them was still fetching), by id. A refresh\n\t * re-applies them so data fetched before the server saw an action doesn't undo it.\n\t */\n\tprivate readonly _overrides = new Map<string, Override>();\n\t/** For items a refresh re-applied an override to: the override's output → which override and the server's item */\n\tprivate readonly _overridden = new WeakMap<GkNotification, { override: Override; server: GkNotification }>();\n\n\tconstructor(private readonly context: NotificationsContext) {\n\t\tthis.api = new NotificationsApi(context);\n\t}\n\n\tdispose(): void {\n\t\tthis._onDidChange.dispose();\n\t}\n\n\t[Symbol.dispose](): void {\n\t\tthis.dispose();\n\t}\n\n\tget unreadCount(): number {\n\t\treturn this._items.reduce((count, n) => (n.readAt == null ? count + 1 : count), 0);\n\t}\n\n\tgetState(): NotificationsState {\n\t\treturn {\n\t\t\titems: this._items,\n\t\t\thasMore: this._hasMore,\n\t\t\tstatus: this._status,\n\t\t\tlastSyncedAt: this._lastSyncedAt,\n\t\t\tsettings: this._settings,\n\t\t\tunreadCount: this.unreadCount,\n\t\t};\n\t}\n\n\t/**\n\t * Re-fetches every page already loaded (up to {@link maxRefreshPages}), so read state, deletions and expiry\n\t * from elsewhere reach them without collapsing a list the user paged through. Expired items are pruned and\n\t * local actions still in flight are kept. Never throws: on failure the cached items stay and the status\n\t * becomes `error`.\n\t *\n\t * Resolves to the notices to toast: the unread, toast-eligible ones that newly arrived with this refresh,\n\t * newest first. Empty when the refresh failed, when nothing had synced before it (no backfill: the first load\n\t * for an account is the existing inbox, not news; a restored snapshot with a `lastSyncedAt` does count as\n\t * synced, so what arrived while the host was closed still toasts), or when nothing is new. New means its id\n\t * wasn't held before the refresh AND it was created after the newest of those held, less\n\t * {@link newToastableSkewMargin}. Only server timestamps are compared, so the client's clock can't hide a\n\t * notice. The id check keeps a notice already seen from toasting again; the time check keeps an old one that\n\t * only now shifts into the first page (after a deletion, or a page boundary moving) from toasting as if it\n\t * were new. With nothing held before there is no cutoff.\n\t *\n\t * Concurrent calls share one request and resolve to the same list, so the result is for ONE caller to act on\n\t * once (the host's refresh loop); other callers should ignore it.\n\t */\n\trefresh(): Promise<GkNotification[]> {\n\t\tthis._refreshing ??= this.refreshCore().finally(() => {\n\t\t\tthis._refreshing = undefined;\n\t\t});\n\t\treturn this._refreshing;\n\t}\n\n\tprivate async refreshCore(): Promise<GkNotification[]> {\n\t\tthis.setStatus('loading');\n\t\t// A Load More in flight would otherwise land after this read the page count, and be dropped by the commit.\n\t\t// (No deadlock: a running `loadMoreCore` is already past its own wait on `_refreshing`.)\n\t\tawait this._loadingMore?.catch(() => undefined);\n\n\t\t// What was held before this refresh, to tell what newly arrived with it\n\t\tconst previous = this._items;\n\t\tconst previouslySynced = this._lastSyncedAt != null;\n\n\t\tlet arrived: GkNotification[] = [];\n\t\ttry {\n\t\t\t// Re-fetch every page already loaded (capped), so read state, deletions and expiry on the server reach\n\t\t\t// them too, without collapsing a list the user has paged through\n\t\t\tconst pages = Math.min(Math.max(this._page, 1), maxRefreshPages);\n\t\t\tconst items: GkNotification[] = [];\n\t\t\tconst seen = new Set<string>();\n\t\t\t// Counted locally: the loop must end even if the server's own page numbering doesn't advance\n\t\t\tlet page = 0;\n\t\t\tlet hasMore = true;\n\t\t\twhile (hasMore && page < pages) {\n\t\t\t\tpage++;\n\t\t\t\tconst next = await this.api.list(page);\n\t\t\t\tfor (const n of next.items) {\n\t\t\t\t\tif (!seen.has(n.id)) {\n\t\t\t\t\t\tseen.add(n.id);\n\t\t\t\t\t\titems.push(n);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\thasMore = next.hasMore;\n\t\t\t}\n\n\t\t\tthis._items = sortNewestFirst(this.pruneExpired(this.applyOverrides(items)));\n\t\t\tthis._hasMore = hasMore;\n\t\t\tthis._page = page;\n\t\t\tthis._lastSyncedAt = this.now();\n\t\t\tthis._status = 'ready';\n\t\t\tif (previouslySynced) {\n\t\t\t\tarrived = this.newToastableSince(previous);\n\t\t\t}\n\t\t} catch (ex) {\n\t\t\tthis.context.log?.error?.(ex, 'Unable to refresh notifications');\n\t\t\tthis._status = 'error';\n\t\t}\n\n\t\tthis.fireChange();\n\t\treturn arrived;\n\t}\n\n\t/**\n\t * Loads the next page, after any refresh in flight (which may change which page is next). Throws on failure,\n\t * leaving the loaded items as they were. Concurrent calls share one request.\n\t */\n\tloadMore(): Promise<void> {\n\t\tthis._loadingMore ??= this.loadMoreCore().finally(() => {\n\t\t\tthis._loadingMore = undefined;\n\t\t});\n\t\treturn this._loadingMore;\n\t}\n\n\tprivate async loadMoreCore(): Promise<void> {\n\t\tif (this._refreshing != null) {\n\t\t\tawait this._refreshing;\n\t\t}\n\t\tif (!this._hasMore) return;\n\n\t\tconst page = this._page + 1;\n\t\tconst next = await this.api.list(page);\n\n\t\tconst ids = new Set(this._items.map(n => n.id));\n\t\tconst added = this.applyOverrides(next.items.filter(n => !ids.has(n.id)));\n\t\tthis._items = sortNewestFirst(this.pruneExpired([...this._items, ...added]));\n\t\tthis._page = page;\n\t\tthis._hasMore = next.hasMore;\n\t\tthis.fireChange();\n\t}\n\n\tmarkRead(ids: readonly string[]): Promise<void> {\n\t\tconst readAt = this.now();\n\t\treturn this.updateOptimistically(\n\t\t\tids,\n\t\t\tn => (n.readAt == null ? { ...n, readAt: readAt } : n),\n\t\t\t() => this.api.markRead(ids),\n\t\t);\n\t}\n\n\tmarkUnread(ids: readonly string[]): Promise<void> {\n\t\treturn this.updateOptimistically(\n\t\t\tids,\n\t\t\tn => {\n\t\t\t\tif (n.readAt == null) return n;\n\n\t\t\t\tconst { readAt: _, ...unread } = n;\n\t\t\t\treturn unread;\n\t\t\t},\n\t\t\t() => this.api.markUnread(ids),\n\t\t);\n\t}\n\n\tasync delete(ids: readonly string[]): Promise<void> {\n\t\tif (!ids.length) return;\n\n\t\tconst deleting = new Set(ids);\n\t\tconst removed = this._items.filter(n => deleting.has(n.id));\n\t\tthis._items = this._items.filter(n => !deleting.has(n.id));\n\t\tconst release = this.trackOverrides(ids, 'deleted');\n\t\tthis.fireChange();\n\n\t\ttry {\n\t\t\tawait this.api.delete(ids);\n\t\t\trelease(true);\n\t\t} catch (ex) {\n\t\t\t// The server drops ids it can no longer find and only answers 404 when none remain: already deleted\n\t\t\tif (NotificationsApiError.is(ex) && ex.status === 404) {\n\t\t\t\trelease(true);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\trelease(false);\n\t\t\t// Put back what was removed, without resurrecting anything a concurrent refresh already returned\n\t\t\tconst present = new Set(this._items.map(n => n.id));\n\t\t\tthis._items = sortNewestFirst([...this._items, ...removed.filter(n => !present.has(n.id))]);\n\t\t\tthis.fireChange();\n\t\t\tthrow ex;\n\t\t}\n\t}\n\n\t/** Marks every loaded unread notification read. */\n\tmarkAllRead(): Promise<void> {\n\t\treturn this.markRead(this._items.filter(n => n.readAt == null).map(n => n.id));\n\t}\n\n\t/** Deletes every loaded read notification. */\n\tdeleteAllRead(): Promise<void> {\n\t\treturn this.delete(this._items.filter(n => n.readAt != null).map(n => n.id));\n\t}\n\n\t/** Fetches the user's notification settings (and caches them in the state). */\n\tasync getSettings(): Promise<NotificationSettings> {\n\t\tconst settings = await this.api.getSettings();\n\t\tthis._settings = settings;\n\t\tthis._confirmedSettings = settings;\n\t\tthis.fireChange();\n\t\treturn settings;\n\t}\n\n\t/**\n\t * Applies `changes` optimistically, then saves. The server stores the whole settings object from each request,\n\t * so POSTs must not overlap (they could land out of order and leave the older state): at most one is in flight,\n\t * and calls made meanwhile share ONE follow-up POST that sends the latest state. Each call settles with the\n\t * outcome of the POST that carried its change.\n\t */\n\tasync updateSettings(changes: Partial<NotificationSettings>): Promise<NotificationSettings> {\n\t\tlet current = this._settings;\n\t\tif (current == null) {\n\t\t\tconst fetched = await this.api.getSettings();\n\t\t\t// A concurrent call may have populated it while fetching\n\t\t\tthis._settings ??= fetched;\n\t\t\tthis._confirmedSettings ??= fetched;\n\t\t\tcurrent = this._settings;\n\t\t}\n\n\t\tthis._settings = { ...current, ...changes };\n\t\tthis.fireChange();\n\n\t\tif (this._settingsFollowUp != null) return this._settingsFollowUp;\n\n\t\tif (this._settingsPost == null) return this.trackSettingsPost(this.postSettings());\n\n\t\tconst follow = this._settingsPost\n\t\t\t.catch(() => undefined)\n\t\t\t.then(() => {\n\t\t\t\t// Starting now: later calls need a new follow-up\n\t\t\t\tthis._settingsFollowUp = undefined;\n\t\t\t\treturn this.postSettings();\n\t\t\t});\n\t\tthis._settingsFollowUp = follow;\n\t\treturn this.trackSettingsPost(follow);\n\t}\n\n\tprivate trackSettingsPost(post: Promise<NotificationSettings>): Promise<NotificationSettings> {\n\t\tthis._settingsPost = post;\n\t\tconst clear = (): void => {\n\t\t\tif (this._settingsPost === post) {\n\t\t\t\tthis._settingsPost = undefined;\n\t\t\t}\n\t\t};\n\t\tpost.then(clear, clear);\n\t\treturn post;\n\t}\n\n\t/** Sends the latest optimistic settings; the confirmed state is what was sent, not the server's echo. */\n\tprivate async postSettings(): Promise<NotificationSettings> {\n\t\tconst settings = this._settings!;\n\t\ttry {\n\t\t\tawait this.api.updateSettings(settings);\n\t\t} catch (ex) {\n\t\t\t// A newer change will be carried by the follow-up POST, so only roll back when there is none\n\t\t\tif (this._settings === settings) {\n\t\t\t\tthis._settings = this._confirmedSettings;\n\t\t\t\tthis.fireChange();\n\t\t\t}\n\t\t\tthrow ex;\n\t\t}\n\n\t\tthis._confirmedSettings = settings;\n\t\treturn settings;\n\t}\n\n\t/** The held notices that are new relative to `previous`, newest first; see {@link refresh} for the rules */\n\tprivate newToastableSince(previous: readonly GkNotification[]): GkNotification[] {\n\t\tconst knownIds = new Set<string>();\n\t\tlet newest = Number.NEGATIVE_INFINITY;\n\t\tfor (const n of previous) {\n\t\t\tknownIds.add(n.id);\n\t\t\tif (n.createdAt > newest) {\n\t\t\t\tnewest = n.createdAt;\n\t\t\t}\n\t\t}\n\n\t\tconst cutoff = newest - newToastableSkewMargin;\n\t\treturn this._items.filter(\n\t\t\tn => !knownIds.has(n.id) && n.createdAt > cutoff && n.readAt == null && isToastEligible(n),\n\t\t);\n\t}\n\n\ttoSnapshot(): NotificationsSnapshot {\n\t\treturn {\n\t\t\titems: this._items,\n\t\t\thasMore: this._hasMore,\n\t\t\tpage: this._page,\n\t\t\tlastSyncedAt: this._lastSyncedAt,\n\t\t\tsettings: this._settings,\n\t\t};\n\t}\n\n\t/** Seeds the state from a snapshot the host persisted; expired items are pruned. */\n\trestore(snapshot: NotificationsSnapshot): void {\n\t\tconst items = Array.isArray(snapshot.items)\n\t\t\t? snapshot.items.filter(n => typeof n?.id === 'string' && typeof n.createdAt === 'number')\n\t\t\t: [];\n\n\t\tthis._items = sortNewestFirst(this.pruneExpired(items));\n\t\tthis._hasMore = snapshot.hasMore === true;\n\t\tthis._page = typeof snapshot.page === 'number' ? snapshot.page : items.length ? 1 : 0;\n\t\tthis._lastSyncedAt = snapshot.lastSyncedAt;\n\t\tthis._settings = snapshot.settings;\n\t\tthis._confirmedSettings = snapshot.settings;\n\t\tthis.fireChange();\n\t}\n\n\t/** On a 404 (the notifications are already gone) the targets are removed instead of rolled back. */\n\tprivate async updateOptimistically(\n\t\tids: readonly string[],\n\t\tupdate: (n: GkNotification) => GkNotification,\n\t\trequest: () => Promise<void>,\n\t): Promise<void> {\n\t\tif (!ids.length) return;\n\n\t\tconst targets = new Set(ids);\n\t\tconst previous = new Map<string, GkNotification>();\n\t\tconst updated = new Map<string, GkNotification>();\n\t\tthis._items = this._items.map(n => {\n\t\t\tif (!targets.has(n.id)) return n;\n\n\t\t\tconst next = update(n);\n\t\t\tif (next !== n) {\n\t\t\t\tprevious.set(n.id, n);\n\t\t\t\tupdated.set(n.id, next);\n\t\t\t}\n\t\t\treturn next;\n\t\t});\n\t\tconst release = this.trackOverrides([...updated.keys()], update);\n\t\tthis.fireChange();\n\n\t\ttry {\n\t\t\tawait request();\n\t\t\trelease(true);\n\t\t} catch (ex) {\n\t\t\t// The server drops ids it can no longer find and only answers 404 when none remain: they're gone, and a\n\t\t\t// refresh already in flight (fetched before they were deleted) must not bring them back\n\t\t\tif (NotificationsApiError.is(ex) && ex.status === 404) {\n\t\t\t\trelease(false);\n\t\t\t\tthis._items = this._items.filter(n => !targets.has(n.id));\n\t\t\t\tthis.trackOverrides(ids, 'deleted')(true);\n\t\t\t\tthis.fireChange();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\trelease(false);\n\t\t\t// Only roll back items still in the state this call (or a refresh re-applying it) left them in, so a\n\t\t\t// later action or refresh on them wins\n\t\t\tthis._items = this._items.map(n => {\n\t\t\t\tif (updated.get(n.id) === n) return previous.get(n.id) ?? n;\n\n\t\t\t\t// A refresh landed meanwhile and re-applied this action to its data: fall back to the server's item\n\t\t\t\tconst overridden = this._overridden.get(n);\n\t\t\t\treturn overridden?.override === update ? overridden.server : n;\n\t\t\t});\n\t\t\tthis.fireChange();\n\t\t\tthrow ex;\n\t\t}\n\t}\n\n\t/**\n\t * Records `override` for `ids` until the action settles; on success, until any refresh or Load More in flight\n\t * (either may have fetched before the server applied the action) has landed too. Returns the release for when\n\t * it settles.\n\t */\n\tprivate trackOverrides(ids: readonly string[], override: Override): (succeeded: boolean) => void {\n\t\tfor (const id of ids) {\n\t\t\tthis._overrides.set(id, override);\n\t\t}\n\n\t\treturn succeeded => {\n\t\t\tconst clear = () => {\n\t\t\t\tfor (const id of ids) {\n\t\t\t\t\t// A later action on the same id owns it now\n\t\t\t\t\tif (this._overrides.get(id) === override) {\n\t\t\t\t\t\tthis._overrides.delete(id);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tconst inFlight = [this._refreshing, this._loadingMore].filter(p => p != null);\n\t\t\tif (succeeded && inFlight.length) {\n\t\t\t\t// `allSettled`: a failed Load More rejects, and must still clear (without an unhandled rejection)\n\t\t\t\tvoid Promise.allSettled(inFlight).then(clear);\n\t\t\t} else {\n\t\t\t\tclear();\n\t\t\t}\n\t\t};\n\t}\n\n\tprivate applyOverrides(items: GkNotification[]): GkNotification[] {\n\t\tif (!this._overrides.size) return items;\n\n\t\tconst result: GkNotification[] = [];\n\t\tfor (const n of items) {\n\t\t\tconst override = this._overrides.get(n.id);\n\t\t\tif (override === 'deleted') continue;\n\n\t\t\tif (override == null) {\n\t\t\t\tresult.push(n);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst output = override(n);\n\t\t\tif (output !== n) {\n\t\t\t\tthis._overridden.set(output, { override: override, server: n });\n\t\t\t}\n\t\t\tresult.push(output);\n\t\t}\n\t\treturn result;\n\t}\n\n\tprivate pruneExpired(items: GkNotification[]): GkNotification[] {\n\t\tconst now = this.now();\n\t\treturn items.filter(n => n.expiresAt == null || n.expiresAt > now);\n\t}\n\n\tprivate setStatus(status: NotificationsStatus): void {\n\t\tif (this._status === status) return;\n\n\t\tthis._status = status;\n\t\tthis.fireChange();\n\t}\n\n\tprivate fireChange(): void {\n\t\tthis._onDidChange.fire(undefined);\n\t}\n\n\tprivate now(): number {\n\t\treturn this.context.now?.() ?? Date.now();\n\t}\n}\n\nfunction sortNewestFirst(items: GkNotification[]): GkNotification[] {\n\treturn items.sort((a, b) => b.createdAt - a.createdAt);\n}\n"],"mappings":"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"}

package/dist/plus/notifications/parse.d.ts

@@ -0,0 +1,12 @@
+import { NotificationsLogger } from "./context.js";
+import { GkNotification } from "./models.js";
+//#region ../plus/notifications/src/parse.d.ts
+/**
+ * Validates a notification from the server. Returns `undefined` (and logs why, without its content) when it
+ * can't be shown: a missing identity, a malformed payload for its event, an unknown
+ * event with no `fallback`. A missing `title` is not a reason to drop one.
+ */
+export declare function parseNotification(raw: unknown, log?: NotificationsLogger): GkNotification | undefined;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//#endregion
+//# sourceMappingURL=parse.d.ts.map

package/dist/plus/notifications/parse.js

@@ -0,0 +1,152 @@
+import { isSafeExternalUrl, toPlainText } from "./presentation.js";
+//#region ../plus/notifications/src/parse.ts
+const contentTypes = /* @__PURE__ */ new Set([
+	"feature",
+	"help",
+	"marketing",
+	"system",
+	"security"
+]);
+const knownEvents = /* @__PURE__ */ new Set([
+	"general",
+	"callToAction",
+	"projectShared",
+	"nudge"
+]);
+/**
+* Validates a notification from the server. Returns `undefined` (and logs why, without its content) when it
+* can't be shown: a missing identity, a malformed payload for its event, an unknown
+* event with no `fallback`. A missing `title` is not a reason to drop one.
+*/
+function parseNotification(raw, log) {
+	if (!isRecord(raw)) {
+		log?.warn?.("Dropped a notification: not an object");
+		return;
+	}
+	const id = nonEmptyString(raw.notificationId);
+	if (id == null) {
+		log?.warn?.("Dropped a notification: missing notificationId");
+		return;
+	}
+	const result = toNotification(id, raw);
+	if (typeof result === "string") {
+		log?.warn?.(`Dropped notification ${id}: ${result}`);
+		return;
+	}
+	return result;
+}
+/** The validated notification, or why it was dropped. */
+function toNotification(id, raw) {
+	const contentType = typeof raw.contentType === "string" && contentTypes.has(raw.contentType) ? raw.contentType : "feature";
+	const createdAt = parseTimestamp(raw.createdAt);
+	if (createdAt == null) return "invalid createdAt";
+	const rawEvent = typeof raw.event === "string" ? raw.event : "";
+	let event;
+	let content;
+	let needsNewerVersion = false;
+	if (knownEvents.has(rawEvent)) {
+		event = rawEvent;
+		content = parsePayload(event, isRecord(raw.payload) ? raw.payload : void 0);
+		if (content == null) return `invalid '${event}' payload`;
+	} else {
+		const fallback = nonEmptyString(raw.fallback);
+		if (fallback == null) return `unknown event '${rawEvent}' with no fallback`;
+		event = "unknown";
+		content = { body: fallback };
+		needsNewerVersion = true;
+	}
+	const headline = nonEmptyString(raw.title)?.trim();
+	const notification = {
+		id,
+		event,
+		contentType,
+		body: content.body,
+		createdAt
+	};
+	if (headline) notification.headline = headline;
+	const desktopMessage = isRecord(raw.payload) ? nonEmptyString(raw.payload.desktopMessage)?.trim() : void 0;
+	const fallbackText = nonEmptyString(raw.fallback);
+	const summary = desktopMessage || (fallbackText != null ? toPlainText(fallbackText) : void 0);
+	if (summary) notification.summary = summary;
+	if (content.cta != null) notification.cta = content.cta;
+	if (content.projectShared != null) notification.projectShared = content.projectShared;
+	const readAt = parseTimestamp(raw.readAt);
+	if (readAt != null) notification.readAt = readAt;
+	const expiresAt = parseTimestamp(raw.expiresAt);
+	if (expiresAt != null) notification.expiresAt = expiresAt;
+	if (needsNewerVersion) notification.needsNewerVersion = true;
+	return notification;
+}
+function parsePayload(event, payload) {
+	if (payload == null) return void 0;
+	switch (event) {
+		case "general": {
+			const markdown = nonEmptyString(payload.markdown);
+			return markdown != null ? { body: markdown } : void 0;
+		}
+		case "callToAction": {
+			const markdown = nonEmptyString(payload.markdown);
+			const cta = isRecord(payload.callToAction) ? payload.callToAction : void 0;
+			const text = nonEmptyString(cta?.text)?.trim();
+			const url = nonEmptyString(cta?.link)?.trim();
+			if (markdown == null || !text || !url || !isSafeExternalUrl(url)) return void 0;
+			return {
+				body: markdown,
+				cta: {
+					text,
+					url
+				}
+			};
+		}
+		case "projectShared": {
+			const projectShared = parseProjectShared(payload);
+			return projectShared != null ? {
+				body: void 0,
+				projectShared
+			} : void 0;
+		}
+		case "nudge": {
+			const message = nonEmptyString((isRecord(payload.metadata) ? payload.metadata : void 0)?.message);
+			return message != null ? { body: message } : void 0;
+		}
+		default: return;
+	}
+}
+function parseProjectShared(payload) {
+	const organization = nameOf(payload.organization);
+	const owner = nameOf(payload.owner);
+	const project = nameOf(payload.project);
+	if (organization == null || owner == null || project == null) return void 0;
+	const teams = [];
+	if (Array.isArray(payload.teams)) for (const team of payload.teams) {
+		const name = nameOf(team);
+		if (name != null) teams.push(name);
+	}
+	return {
+		organization,
+		owner,
+		project,
+		teams
+	};
+}
+function nameOf(value) {
+	return isRecord(value) ? nonEmptyString(value.name)?.trim() : void 0;
+}
+function isRecord(value) {
+	return typeof value === "object" && value != null && !Array.isArray(value);
+}
+/** The string itself when it has non-whitespace content, otherwise `undefined`. */
+function nonEmptyString(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value : void 0;
+}
+/** An ISO timestamp (or epoch ms) as epoch ms; `undefined` when absent or unparseable. */
+function parseTimestamp(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+	if (typeof value !== "string" || !value) return void 0;
+	const ms = Date.parse(value);
+	return Number.isNaN(ms) ? void 0 : ms;
+}
+//#endregion
+export { isRecord, parseNotification };
+
+//# sourceMappingURL=parse.js.map

package/dist/plus/notifications/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","names":[],"sources":["../../../../plus/notifications/src/parse.ts"],"sourcesContent":["import type { NotificationsLogger } from './context.js';\nimport type { GkNotification, NotificationContentType, NotificationEvent, ProjectSharedDetails } from './models.js';\nimport { isSafeExternalUrl, toPlainText } from './presentation.js';\n\nconst contentTypes: ReadonlySet<string> = new Set<NotificationContentType>([\n\t'feature',\n\t'help',\n\t'marketing',\n\t'system',\n\t'security',\n]);\nconst knownEvents: ReadonlySet<string> = new Set<NotificationEvent>([\n\t'general',\n\t'callToAction',\n\t'projectShared',\n\t'nudge',\n]);\n\ntype Content = Pick<GkNotification, 'body' | 'cta' | 'projectShared'>;\n\n/**\n * Validates a notification from the server. Returns `undefined` (and logs why, without its content) when it\n * can't be shown: a missing identity, a malformed payload for its event, an unknown\n * event with no `fallback`. A missing `title` is not a reason to drop one.\n */\nexport function parseNotification(raw: unknown, log?: NotificationsLogger): GkNotification | undefined {\n\tif (!isRecord(raw)) {\n\t\tlog?.warn?.('Dropped a notification: not an object');\n\t\treturn undefined;\n\t}\n\n\tconst id = nonEmptyString(raw.notificationId);\n\tif (id == null) {\n\t\tlog?.warn?.('Dropped a notification: missing notificationId');\n\t\treturn undefined;\n\t}\n\n\tconst result = toNotification(id, raw);\n\tif (typeof result === 'string') {\n\t\tlog?.warn?.(`Dropped notification ${id}: ${result}`);\n\t\treturn undefined;\n\t}\n\n\treturn result;\n}\n\n/** The validated notification, or why it was dropped. */\nfunction toNotification(id: string, raw: Record<string, unknown>): GkNotification | string {\n\t// An unrecognized content type (e.g. one the server adds later) is shown like `feature`: no chip, no toast\n\tconst contentType: NotificationContentType =\n\t\ttypeof raw.contentType === 'string' && contentTypes.has(raw.contentType)\n\t\t\t? (raw.contentType as NotificationContentType)\n\t\t\t: 'feature';\n\n\tconst createdAt = parseTimestamp(raw.createdAt);\n\tif (createdAt == null) return 'invalid createdAt';\n\n\tconst rawEvent = typeof raw.event === 'string' ? raw.event : '';\n\n\tlet event: NotificationEvent;\n\tlet content: Content | undefined;\n\tlet needsNewerVersion = false;\n\tif (knownEvents.has(rawEvent)) {\n\t\tevent = rawEvent as NotificationEvent;\n\t\tcontent = parsePayload(event, isRecord(raw.payload) ? raw.payload : undefined);\n\t\tif (content == null) return `invalid '${event}' payload`;\n\t} else {\n\t\tconst fallback = nonEmptyString(raw.fallback);\n\t\tif (fallback == null) return `unknown event '${rawEvent}' with no fallback`;\n\n\t\tevent = 'unknown';\n\t\tcontent = { body: fallback };\n\t\tneedsNewerVersion = true;\n\t}\n\n\t// Never the server's `name`: it's an internal identifier, not display text\n\tconst headline = nonEmptyString(raw.title)?.trim();\n\n\tconst notification: GkNotification = {\n\t\tid: id,\n\t\tevent: event,\n\t\tcontentType: contentType,\n\t\tbody: content.body,\n\t\tcreatedAt: createdAt,\n\t};\n\tif (headline) {\n\t\tnotification.headline = headline;\n\t}\n\tconst desktopMessage = isRecord(raw.payload) ? nonEmptyString(raw.payload.desktopMessage)?.trim() : undefined;\n\t// `fallback` is markdown (Desktop renders it as such), but a header is one line of plain text\n\tconst fallbackText = nonEmptyString(raw.fallback);\n\tconst summary = desktopMessage || (fallbackText != null ? toPlainText(fallbackText) : undefined);\n\tif (summary) {\n\t\tnotification.summary = summary;\n\t}\n\tif (content.cta != null) {\n\t\tnotification.cta = content.cta;\n\t}\n\tif (content.projectShared != null) {\n\t\tnotification.projectShared = content.projectShared;\n\t}\n\n\tconst readAt = parseTimestamp(raw.readAt);\n\tif (readAt != null) {\n\t\tnotification.readAt = readAt;\n\t}\n\n\tconst expiresAt = parseTimestamp(raw.expiresAt);\n\tif (expiresAt != null) {\n\t\tnotification.expiresAt = expiresAt;\n\t}\n\n\tif (needsNewerVersion) {\n\t\tnotification.needsNewerVersion = true;\n\t}\n\n\treturn notification;\n}\n\nfunction parsePayload(event: NotificationEvent, payload: Record<string, unknown> | undefined): Content | undefined {\n\tif (payload == null) return undefined;\n\n\tswitch (event) {\n\t\tcase 'general': {\n\t\t\tconst markdown = nonEmptyString(payload.markdown);\n\t\t\treturn markdown != null ? { body: markdown } : undefined;\n\t\t}\n\t\tcase 'callToAction': {\n\t\t\tconst markdown = nonEmptyString(payload.markdown);\n\t\t\tconst cta = isRecord(payload.callToAction) ? payload.callToAction : undefined;\n\t\t\tconst text = nonEmptyString(cta?.text)?.trim();\n\t\t\tconst url = nonEmptyString(cta?.link)?.trim();\n\t\t\tif (markdown == null || !text || !url || !isSafeExternalUrl(url)) return undefined;\n\n\t\t\treturn { body: markdown, cta: { text: text, url: url } };\n\t\t}\n\t\tcase 'projectShared': {\n\t\t\tconst projectShared = parseProjectShared(payload);\n\t\t\treturn projectShared != null ? { body: undefined, projectShared: projectShared } : undefined;\n\t\t}\n\t\tcase 'nudge': {\n\t\t\tconst metadata = isRecord(payload.metadata) ? payload.metadata : undefined;\n\t\t\tconst message = nonEmptyString(metadata?.message);\n\t\t\treturn message != null ? { body: message } : undefined;\n\t\t}\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\nfunction parseProjectShared(payload: Record<string, unknown>): ProjectSharedDetails | undefined {\n\tconst organization = nameOf(payload.organization);\n\tconst owner = nameOf(payload.owner);\n\tconst project = nameOf(payload.project);\n\tif (organization == null || owner == null || project == null) return undefined;\n\n\tconst teams: string[] = [];\n\tif (Array.isArray(payload.teams)) {\n\t\tfor (const team of payload.teams) {\n\t\t\tconst name = nameOf(team);\n\t\t\tif (name != null) {\n\t\t\t\tteams.push(name);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { organization: organization, owner: owner, project: project, teams: teams };\n}\n\nfunction nameOf(value: unknown): string | undefined {\n\treturn isRecord(value) ? nonEmptyString(value.name)?.trim() : undefined;\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === 'object' && value != null && !Array.isArray(value);\n}\n\n/** The string itself when it has non-whitespace content, otherwise `undefined`. */\nfunction nonEmptyString(value: unknown): string | undefined {\n\treturn typeof value === 'string' && value.trim().length > 0 ? value : undefined;\n}\n\n/** An ISO timestamp (or epoch ms) as epoch ms; `undefined` when absent or unparseable. */\nfunction parseTimestamp(value: unknown): number | undefined {\n\tif (typeof value === 'number') return Number.isFinite(value) ? value : undefined;\n\tif (typeof value !== 'string' || !value) return undefined;\n\n\tconst ms = Date.parse(value);\n\treturn Number.isNaN(ms) ? undefined : ms;\n}\n"],"mappings":"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"}

package/dist/plus/notifications/presentation.d.ts

@@ -0,0 +1,28 @@
+import { GkNotification, NotificationContentType } from "./models.js";
+//#region ../plus/notifications/src/presentation.d.ts
+export type NotificationCategoryChip = 'help' | 'offer' | 'security' | 'system';
+/** The category chip shown on a notification card; `feature` notifications get none. */
+export declare function getCategoryChip(contentType: NotificationContentType): NotificationCategoryChip | undefined;
+/** Only security and system notices may interrupt with a toast; everything else arrives quietly. */
+export declare function isToastEligible(notification: Pick<GkNotification, 'contentType'>): boolean;
+/**
+ * Server-supplied links may only open `https:` URLs (never `command:`, `javascript:`, `file:`, ...). Deliberately
+ * stricter than the inline-link policy for untrusted markdown (`getUntrustedLinkHref`, which also allows `http:`
+ * and `mailto:`): a call-to-action is a prominent, single-click action.
+ */
+export declare function isSafeExternalUrl(url: string): boolean;
+export declare function formatUnreadCount(count: number): string;
+/**
+ * The body to show under a notification's headline. Service-generated notices often open their body with the
+ * headline itself (`jane@acme.dev has requested to join _Acme_. …`), so a first paragraph that only repeats the
+ * headline (ignoring markdown emphasis/code markers, whitespace and a trailing period) is dropped. Only the
+ * first paragraph is ever dropped; `undefined` when nothing remains.
+ */
+export declare function getDisplayBody(headline: string | undefined, body: string | undefined): string | undefined;
+/**
+ * A best-effort conversion of markdown to a single line of plain text, for headers that cannot render markdown.
+ * Not a parser: it handles the common inline and line-start constructs and leaves anything exotic as-is.
+ */
+export declare function toPlainText(markdown: string): string;
+//#endregion
+//# sourceMappingURL=presentation.d.ts.map