@gitkraken/core-gitlens 0.24.0 → 0.26.0

package/dist/plus/notifications/api.js

@@ -0,0 +1,89 @@
+import { NotificationsApiError } from "./errors.js";
+import { isRecord, parseNotification } from "./parse.js";
+//#region ../plus/notifications/src/api.ts
+const notificationsPageSize = 50;
+/** A thin client over the `notifications-service-v2` v1 API. */
+var NotificationsApi = class {
+	context;
+	constructor(context) {
+		this.context = context;
+	}
+	/** Loads one page (1-based), newest first. Invalid notifications are dropped (and logged). */
+	async list(page, pageSize = 50) {
+		const query = new URLSearchParams({
+			productType: this.context.productType,
+			page: String(page),
+			pageSize: String(pageSize)
+		});
+		const data = await this.request("list", "v1/notifications", { method: "GET" }, query);
+		const results = isRecord(data) && Array.isArray(data.results) ? data.results : [];
+		const items = [];
+		for (const raw of results) {
+			const notification = parseNotification(raw, this.context.log);
+			if (notification != null) items.push(notification);
+		}
+		return {
+			items,
+			hasMore: isRecord(data) && data.hasMore === true,
+			page: isRecord(data) && typeof data.page === "number" ? data.page : page
+		};
+	}
+	async markRead(ids) {
+		await this.request("markRead", "v1/notifications/read", {
+			method: "POST",
+			body: JSON.stringify({ notificationIds: ids })
+		});
+	}
+	async markUnread(ids) {
+		await this.request("markUnread", "v1/notifications/unread", {
+			method: "POST",
+			body: JSON.stringify({ notificationIds: ids })
+		});
+	}
+	async delete(ids) {
+		await this.request("delete", "v1/notifications", {
+			method: "DELETE",
+			body: JSON.stringify({ notificationIds: ids })
+		});
+	}
+	async getSettings() {
+		const data = await this.request("getSettings", "v1/notifications/user-settings", { method: "GET" });
+		const settings = isRecord(data) ? data : {};
+		return {
+			marketingEnabled: settings.marketingEnabled !== false,
+			helpEnabled: settings.helpEnabled !== false,
+			securityEnabled: settings.securityEnabled !== false
+		};
+	}
+	async updateSettings(settings) {
+		await this.request("updateSettings", "v1/notifications/user-settings", {
+			method: "POST",
+			body: JSON.stringify({
+				marketingEnabled: settings.marketingEnabled,
+				helpEnabled: settings.helpEnabled,
+				securityEnabled: settings.securityEnabled
+			})
+		});
+	}
+	/** Sends the request and returns the unwrapped `data` envelope (or `undefined` for an empty body). */
+	async request(operation, path, init, query) {
+		const rsp = await this.context.fetchGkApi(path, {
+			...init,
+			headers: { "Content-Type": "application/json" }
+		}, query);
+		if (!rsp.ok) throw new NotificationsApiError(rsp.status, operation, rsp.statusText);
+		const text = await rsp.text();
+		if (!text) return void 0;
+		let json;
+		try {
+			json = JSON.parse(text);
+		} catch (ex) {
+			throw new NotificationsApiError(rsp.status, operation, "invalid JSON response", { cause: ex });
+		}
+		return isRecord(json) ? json.data ?? json : json;
+	}
+};
+//#endregion
+export { NotificationsApi, notificationsPageSize };
+
+//# sourceMappingURL=api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","names":[],"sources":["../../../../plus/notifications/src/api.ts"],"sourcesContent":["import type { NotificationsContext } from './context.js';\nimport { NotificationsApiError } from './errors.js';\nimport type { GkNotification, NotificationSettings, NotificationsPage } from './models.js';\nimport { isRecord, parseNotification } from './parse.js';\n\nexport const notificationsPageSize = 50;\n\n/** A thin client over the `notifications-service-v2` v1 API. */\nexport class NotificationsApi {\n\tconstructor(private readonly context: NotificationsContext) {}\n\n\t/** Loads one page (1-based), newest first. Invalid notifications are dropped (and logged). */\n\tasync list(page: number, pageSize: number = notificationsPageSize): Promise<NotificationsPage> {\n\t\tconst query = new URLSearchParams({\n\t\t\tproductType: this.context.productType,\n\t\t\tpage: String(page),\n\t\t\tpageSize: String(pageSize),\n\t\t});\n\t\tconst data = await this.request('list', 'v1/notifications', { method: 'GET' }, query);\n\n\t\tconst results = isRecord(data) && Array.isArray(data.results) ? (data.results as unknown[]) : [];\n\t\tconst items: GkNotification[] = [];\n\t\tfor (const raw of results) {\n\t\t\tconst notification = parseNotification(raw, this.context.log);\n\t\t\tif (notification != null) {\n\t\t\t\titems.push(notification);\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\titems: items,\n\t\t\thasMore: isRecord(data) && data.hasMore === true,\n\t\t\tpage: isRecord(data) && typeof data.page === 'number' ? data.page : page,\n\t\t};\n\t}\n\n\tasync markRead(ids: readonly string[]): Promise<void> {\n\t\tawait this.request('markRead', 'v1/notifications/read', {\n\t\t\tmethod: 'POST',\n\t\t\tbody: JSON.stringify({ notificationIds: ids }),\n\t\t});\n\t}\n\n\tasync markUnread(ids: readonly string[]): Promise<void> {\n\t\tawait this.request('markUnread', 'v1/notifications/unread', {\n\t\t\tmethod: 'POST',\n\t\t\tbody: JSON.stringify({ notificationIds: ids }),\n\t\t});\n\t}\n\n\tasync delete(ids: readonly string[]): Promise<void> {\n\t\tawait this.request('delete', 'v1/notifications', {\n\t\t\tmethod: 'DELETE',\n\t\t\tbody: JSON.stringify({ notificationIds: ids }),\n\t\t});\n\t}\n\n\tasync getSettings(): Promise<NotificationSettings> {\n\t\tconst data = await this.request('getSettings', 'v1/notifications/user-settings', { method: 'GET' });\n\t\tconst settings = isRecord(data) ? data : {};\n\t\t// A missing flag means the service default, which is opted in\n\t\treturn {\n\t\t\tmarketingEnabled: settings.marketingEnabled !== false,\n\t\t\thelpEnabled: settings.helpEnabled !== false,\n\t\t\tsecurityEnabled: settings.securityEnabled !== false,\n\t\t};\n\t}\n\n\tasync updateSettings(settings: NotificationSettings): Promise<void> {\n\t\tawait this.request('updateSettings', 'v1/notifications/user-settings', {\n\t\t\tmethod: 'POST',\n\t\t\tbody: JSON.stringify({\n\t\t\t\tmarketingEnabled: settings.marketingEnabled,\n\t\t\t\thelpEnabled: settings.helpEnabled,\n\t\t\t\tsecurityEnabled: settings.securityEnabled,\n\t\t\t} satisfies NotificationSettings),\n\t\t});\n\t}\n\n\t/** Sends the request and returns the unwrapped `data` envelope (or `undefined` for an empty body). */\n\tprivate async request(\n\t\toperation: string,\n\t\tpath: string,\n\t\tinit: RequestInit,\n\t\tquery?: URLSearchParams,\n\t): Promise<unknown> {\n\t\tconst rsp = await this.context.fetchGkApi(\n\t\t\tpath,\n\t\t\t{\n\t\t\t\t...init,\n\t\t\t\theaders: { 'Content-Type': 'application/json' },\n\t\t\t},\n\t\t\tquery,\n\t\t);\n\t\tif (!rsp.ok) throw new NotificationsApiError(rsp.status, operation, rsp.statusText);\n\n\t\tconst text = await rsp.text();\n\t\tif (!text) return undefined;\n\n\t\tlet json: unknown;\n\t\ttry {\n\t\t\tjson = JSON.parse(text);\n\t\t} catch (ex) {\n\t\t\tthrow new NotificationsApiError(rsp.status, operation, 'invalid JSON response', { cause: ex });\n\t\t}\n\t\treturn isRecord(json) ? (json.data ?? json) : json;\n\t}\n}\n"],"mappings":";;;AAKA,MAAa,wBAAwB;;AAGrC,IAAa,mBAAb,MAA8B;CACA;CAA7B,YAAY,SAAgD;EAA/B,KAAA,UAAA;CAAgC;;CAG7D,MAAM,KAAK,MAAc,WAAA,IAAsE;EAC9F,MAAM,QAAQ,IAAI,gBAAgB;GACjC,aAAa,KAAK,QAAQ;GAC1B,MAAM,OAAO,IAAI;GACjB,UAAU,OAAO,QAAQ;EAC1B,CAAC;EACD,MAAM,OAAO,MAAM,KAAK,QAAQ,QAAQ,oBAAoB,EAAE,QAAQ,MAAM,GAAG,KAAK;EAEpF,MAAM,UAAU,SAAS,IAAI,KAAK,MAAM,QAAQ,KAAK,OAAO,IAAK,KAAK,UAAwB,CAAC;EAC/F,MAAM,QAA0B,CAAC;EACjC,KAAK,MAAM,OAAO,SAAS;GAC1B,MAAM,eAAe,kBAAkB,KAAK,KAAK,QAAQ,GAAG;GAC5D,IAAI,gBAAgB,MACnB,MAAM,KAAK,YAAY;EAEzB;EAEA,OAAO;GACC;GACP,SAAS,SAAS,IAAI,KAAK,KAAK,YAAY;GAC5C,MAAM,SAAS,IAAI,KAAK,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO;EACrE;CACD;CAEA,MAAM,SAAS,KAAuC;EACrD,MAAM,KAAK,QAAQ,YAAY,yBAAyB;GACvD,QAAQ;GACR,MAAM,KAAK,UAAU,EAAE,iBAAiB,IAAI,CAAC;EAC9C,CAAC;CACF;CAEA,MAAM,WAAW,KAAuC;EACvD,MAAM,KAAK,QAAQ,cAAc,2BAA2B;GAC3D,QAAQ;GACR,MAAM,KAAK,UAAU,EAAE,iBAAiB,IAAI,CAAC;EAC9C,CAAC;CACF;CAEA,MAAM,OAAO,KAAuC;EACnD,MAAM,KAAK,QAAQ,UAAU,oBAAoB;GAChD,QAAQ;GACR,MAAM,KAAK,UAAU,EAAE,iBAAiB,IAAI,CAAC;EAC9C,CAAC;CACF;CAEA,MAAM,cAA6C;EAClD,MAAM,OAAO,MAAM,KAAK,QAAQ,eAAe,kCAAkC,EAAE,QAAQ,MAAM,CAAC;EAClG,MAAM,WAAW,SAAS,IAAI,IAAI,OAAO,CAAC;EAE1C,OAAO;GACN,kBAAkB,SAAS,qBAAqB;GAChD,aAAa,SAAS,gBAAgB;GACtC,iBAAiB,SAAS,oBAAoB;EAC/C;CACD;CAEA,MAAM,eAAe,UAA+C;EACnE,MAAM,KAAK,QAAQ,kBAAkB,kCAAkC;GACtE,QAAQ;GACR,MAAM,KAAK,UAAU;IACpB,kBAAkB,SAAS;IAC3B,aAAa,SAAS;IACtB,iBAAiB,SAAS;GAC3B,CAAgC;EACjC,CAAC;CACF;;CAGA,MAAc,QACb,WACA,MACA,MACA,OACmB;EACnB,MAAM,MAAM,MAAM,KAAK,QAAQ,WAC9B,MACA;GACC,GAAG;GACH,SAAS,EAAE,gBAAgB,mBAAmB;EAC/C,GACA,KACD;EACA,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,sBAAsB,IAAI,QAAQ,WAAW,IAAI,UAAU;EAElF,MAAM,OAAO,MAAM,IAAI,KAAK;EAC5B,IAAI,CAAC,MAAM,OAAO,KAAA;EAElB,IAAI;EACJ,IAAI;GACH,OAAO,KAAK,MAAM,IAAI;EACvB,SAAS,IAAI;GACZ,MAAM,IAAI,sBAAsB,IAAI,QAAQ,WAAW,yBAAyB,EAAE,OAAO,GAAG,CAAC;EAC9F;EACA,OAAO,SAAS,IAAI,IAAK,KAAK,QAAQ,OAAQ;CAC/C;AACD"}

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

@@ -0,0 +1,28 @@
+//#region ../plus/notifications/src/context.d.ts
+/**
+ * Optional diagnostics sink. The package never logs on its own; the host routes these to its logger.
+ */
+export interface NotificationsLogger {
+  debug?(message: string): void;
+  warn?(message: string): void;
+  error?(ex: unknown, message?: string): void;
+}
+/**
+ * Everything the notifications package needs from its host. The package cannot import `vscode` or reach
+ * into the extension host, so the only way it talks to the outside world is through this context.
+ */
+export interface NotificationsContext {
+  /** The `productType` the notifications service filters by, e.g. `gitlens`. The package never hardcodes one. */
+  readonly productType: string;
+  /**
+   * Authenticated request against the GK cloud API. `path` is relative to the API root, has no leading slash
+   * and never carries a query string, e.g. `v1/notifications`; any query comes separately in `query`. A non-2xx
+   * response is returned, not thrown.
+   */
+  fetchGkApi(path: string, init?: RequestInit, query?: URLSearchParams): Promise<Response>;
+  /** Current time in ms since the epoch; a test seam that defaults to `Date.now()`. */
+  now?(): number;
+  readonly log?: NotificationsLogger;
+}
+//#endregion
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1,13 @@
+//#region ../plus/notifications/src/errors.d.ts
+/**
+ * A failed request to the notifications service: a non-2xx response, or a 2xx one whose body isn't valid JSON
+ * (e.g. an HTML error page from a proxy). The message is for logs, not for display.
+ */
+export declare class NotificationsApiError extends Error {
+  readonly status: number;
+  readonly operation: string;
+  static is(ex: unknown): ex is NotificationsApiError;
+  constructor(status: number, operation: string, reason?: string, options?: ErrorOptions);
+}
+//#endregion
+//# sourceMappingURL=errors.d.ts.map

package/dist/plus/notifications/errors.js

@@ -0,0 +1,22 @@
+//#region ../plus/notifications/src/errors.ts
+/**
+* A failed request to the notifications service: a non-2xx response, or a 2xx one whose body isn't valid JSON
+* (e.g. an HTML error page from a proxy). The message is for logs, not for display.
+*/
+var NotificationsApiError = class NotificationsApiError extends Error {
+	status;
+	operation;
+	static is(ex) {
+		return ex instanceof NotificationsApiError;
+	}
+	constructor(status, operation, reason, options) {
+		super(`Notifications request '${operation}' failed: ${status}${reason ? ` ${reason}` : ""}`, options);
+		this.status = status;
+		this.operation = operation;
+		this.name = "NotificationsApiError";
+	}
+};
+//#endregion
+export { NotificationsApiError };
+
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../../../plus/notifications/src/errors.ts"],"sourcesContent":["/**\n * A failed request to the notifications service: a non-2xx response, or a 2xx one whose body isn't valid JSON\n * (e.g. an HTML error page from a proxy). The message is for logs, not for display.\n */\nexport class NotificationsApiError extends Error {\n\tstatic is(ex: unknown): ex is NotificationsApiError {\n\t\treturn ex instanceof NotificationsApiError;\n\t}\n\n\tconstructor(\n\t\treadonly status: number,\n\t\treadonly operation: string,\n\t\treason?: string,\n\t\toptions?: ErrorOptions,\n\t) {\n\t\tsuper(`Notifications request '${operation}' failed: ${status}${reason ? ` ${reason}` : ''}`, options);\n\t\tthis.name = 'NotificationsApiError';\n\t}\n}\n"],"mappings":";;;;;AAIA,IAAa,wBAAb,MAAa,8BAA8B,MAAM;CAMtC;CACA;CANV,OAAO,GAAG,IAA0C;EACnD,OAAO,cAAc;CACtB;CAEA,YACC,QACA,WACA,QACA,SACC;EACD,MAAM,0BAA0B,UAAU,YAAY,SAAS,SAAS,IAAI,WAAW,MAAM,OAAO;EAL3F,KAAA,SAAA;EACA,KAAA,YAAA;EAKT,KAAK,OAAO;CACb;AACD"}

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

@@ -0,0 +1,94 @@
+//#region ../plus/notifications/src/models.d.ts
+export type NotificationContentType = 'feature' | 'help' | 'marketing' | 'system' | 'security';
+/** The events this package knows how to render; anything else is `unknown` and shown via its `fallback`. */
+export type NotificationEvent = 'general' | 'callToAction' | 'projectShared' | 'nudge' | 'unknown';
+/** A notification as `notifications-service-v2` returns it from `GET v1/notifications`. Untrusted input. */
+export interface RawNotification {
+  notificationId: string;
+  name: string;
+  title?: string | null;
+  notificationType: 'system' | 'user';
+  contentType: NotificationContentType;
+  /** Any string; the known values are those of {@link NotificationEvent} other than `unknown`. */
+  event: string;
+  /** ISO 8601 timestamps. */
+  readAt?: string | null;
+  expiresAt?: string | null;
+  createdAt: string;
+  updatedAt: string;
+  fallback?: string | null;
+  payload?: unknown;
+}
+export interface NotificationSettings {
+  marketingEnabled: boolean;
+  helpEnabled: boolean;
+  securityEnabled: boolean;
+}
+/**
+ * The parts of a `projectShared` notification. The package cannot localize, so the host assembles the sentence
+ * ("In {organization}, {owner} created a new Team Workspace: {project}", plus the teams when there are any).
+ */
+export interface ProjectSharedDetails {
+  organization: string;
+  owner: string;
+  project: string;
+  teams: string[];
+}
+/** A validated notification. Plain data, so it can be persisted and sent over RPC as is. */
+export interface GkNotification {
+  id: string;
+  event: NotificationEvent;
+  contentType: NotificationContentType;
+  /**
+   * The server's display `title`; `undefined` when unset, in which case the host supplies its own header.
+   * Never the server's internal `name`.
+   */
+  headline?: string;
+  /**
+   * A plain-text one-line summary of the notice (the server's `payload.desktopMessage`, else `fallback`), when set;
+   * the host uses it where there's no {@link headline}. Never markdown-rendered.
+   */
+  summary?: string;
+  /** Markdown. `undefined` for `projectShared`, whose body the host builds from {@link projectShared}. */
+  body: string | undefined;
+  /** Only for `callToAction`; the URL is always `https:`. */
+  cta?: {
+    text: string;
+    url: string;
+  };
+  /** Only for `projectShared`. */
+  projectShared?: ProjectSharedDetails;
+  /** Timestamps in ms since the epoch. */
+  createdAt: number;
+  readAt?: number;
+  expiresAt?: number;
+  /** Set when an unknown event is shown through its `fallback` text. */
+  needsNewerVersion?: boolean;
+}
+export interface NotificationsPage {
+  items: GkNotification[];
+  hasMore: boolean;
+  page: number;
+}
+export type NotificationsStatus = 'idle' | 'loading' | 'ready' | 'error';
+export interface NotificationsState {
+  /** Newest first. */
+  readonly items: readonly GkNotification[];
+  readonly hasMore: boolean;
+  readonly status: NotificationsStatus;
+  readonly lastSyncedAt: number | undefined;
+  readonly settings: NotificationSettings | undefined;
+  /** Unread among the loaded items. */
+  readonly unreadCount: number;
+}
+/** What the host persists between sessions; see `NotificationsService.toSnapshot()` and `restore()`. */
+export interface NotificationsSnapshot {
+  items: GkNotification[];
+  hasMore: boolean;
+  /** The last page loaded, 1-based. */
+  page: number;
+  lastSyncedAt: number | undefined;
+  settings: NotificationSettings | undefined;
+}
+//#endregion
+//# sourceMappingURL=models.d.ts.map

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

@@ -0,0 +1,115 @@
+import { UnifiedDisposable } from "../../utils/disposable.js";
+import { Event } from "../../utils/event.js";
+import { NotificationsContext } from "./context.js";
+import { GkNotification, NotificationSettings, NotificationsSnapshot, NotificationsState } from "./models.js";
+//#region ../plus/notifications/src/notificationsService.d.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.
+ */
+export declare const newToastableSkewMargin: number;
+/**
+ * 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.
+ */
+export declare class NotificationsService implements UnifiedDisposable {
+  private readonly context;
+  private readonly _onDidChange;
+  get onDidChange(): Event<void>;
+  private readonly api;
+  private _items;
+  private _hasMore;
+  /** The last page loaded, 1-based; 0 before the first load. */
+  private _page;
+  private _status;
+  private _lastSyncedAt;
+  private _settings;
+  /** The settings the server last acknowledged (fetched, or successfully saved) */
+  private _confirmedSettings;
+  private _settingsPost;
+  private _settingsFollowUp;
+  private _refreshing;
+  private _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.
+   */
+  private readonly _overrides;
+  /** For items a refresh re-applied an override to: the override's output → which override and the server's item */
+  private readonly _overridden;
+  constructor(context: NotificationsContext);
+  dispose(): void;
+  [Symbol.dispose](): void;
+  get unreadCount(): number;
+  getState(): NotificationsState;
+  /**
+   * 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(): Promise<GkNotification[]>;
+  private refreshCore;
+  /**
+   * 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(): Promise<void>;
+  private loadMoreCore;
+  markRead(ids: readonly string[]): Promise<void>;
+  markUnread(ids: readonly string[]): Promise<void>;
+  delete(ids: readonly string[]): Promise<void>;
+  /** Marks every loaded unread notification read. */
+  markAllRead(): Promise<void>;
+  /** Deletes every loaded read notification. */
+  deleteAllRead(): Promise<void>;
+  /** Fetches the user's notification settings (and caches them in the state). */
+  getSettings(): Promise<NotificationSettings>;
+  /**
+   * 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.
+   */
+  updateSettings(changes: Partial<NotificationSettings>): Promise<NotificationSettings>;
+  private trackSettingsPost;
+  /** Sends the latest optimistic settings; the confirmed state is what was sent, not the server's echo. */
+  private postSettings;
+  /** The held notices that are new relative to `previous`, newest first; see {@link refresh} for the rules */
+  private newToastableSince;
+  toSnapshot(): NotificationsSnapshot;
+  /** Seeds the state from a snapshot the host persisted; expired items are pruned. */
+  restore(snapshot: NotificationsSnapshot): void;
+  /** On a 404 (the notifications are already gone) the targets are removed instead of rolled back. */
+  private updateOptimistically;
+  /**
+   * 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.
+   */
+  private trackOverrides;
+  private applyOverrides;
+  private pruneExpired;
+  private setStatus;
+  private fireChange;
+  private now;
+}
+//#endregion
+//# sourceMappingURL=notificationsService.d.ts.map