uapp-communication-sdk 1.0.0-dev.67 → 1.0.0-dev.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uapp-communication-sdk",
-  "version": "1.0.0-dev.67",
+  "version": "1.0.0-dev.72",
   "description": "Embeddable Communication Hub widgets (chat, feed, bookings, schedule).",
   "type": "module",
   "types": "./types/sdk/index.d.ts",

package/types/core/time/viewer-timezone.d.ts

@@ -20,6 +20,23 @@ export declare class ViewerTimeZone {
     formatTime(utcIso: string): string;
     /** `HH:MM – HH:MM` in the display zone; `''` when either bound is missing/unresolved. */
     formatTimeRange(startUtc: string | null | undefined, endUtc: string | null | undefined): string;
+    /**
+     * A deadline for a "… until X" label, in the display zone.
+     *
+     * <p>Bare `HH:MM` says "today" to a reader, so a deadline on another DAY has to say which one or it
+     * reads as a time that has already passed — somebody off all Sunday is back when their hours next
+     * open, which is Monday, and "Away until 16:00" shown at 16:52 on Sunday is simply false.</p>
+     *
+     * <p>Beyond a week the weekday alone would be ambiguous (seven days out is the same weekday), so the
+     * date joins it.</p>
+     */
+    formatUntil(utcIso: string, now?: Date): string;
+    /**
+     * Whole CALENDAR days from one instant to another in the display zone — not elapsed hours divided by
+     * 24. 23:30 to 00:30 is the next day however few minutes separate them, and that is what a reader
+     * means by "tomorrow".
+     */
+    private calendarDaysAhead;
     /** A UTC ISO instant formatted as a date in the display zone (defaults to `"Thu, 25 Jun"`). */
     formatDate(utcIso: string, options?: Intl.DateTimeFormatOptions): string;
 }

package/types/core/time/viewer-timezone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-timezone.d.ts","sourceRoot":"","sources":["../../../../../src/core/time/viewer-timezone.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,mBAAmB;IAClC,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,qBAAa,cAAc;IAEvB,8CAA8C;aAC9B,OAAO,EAAE,MAAM;IAC/B,2EAA2E;aAC3D,MAAM,EAAE,MAAM;IAJhC,OAAO;IAOP,0FAA0F;WAC5E,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc;IAY9D,4FAA4F;IAC5F,IAAW,oBAAoB,IAAI,OAAO,CAEzC;IAED,4FAA4F;IACrF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IASzC,yFAAyF;IAClF,eAAe,CACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,MAAM;IAKT,+FAA+F;IACxF,UAAU,CACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,IAAI,CAAC,qBAIb,GACA,MAAM;CAMV"}
+{"version":3,"file":"viewer-timezone.d.ts","sourceRoot":"","sources":["../../../../../src/core/time/viewer-timezone.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,mBAAmB;IAClC,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,qBAAa,cAAc;IAEvB,8CAA8C;aAC9B,OAAO,EAAE,MAAM;IAC/B,2EAA2E;aAC3D,MAAM,EAAE,MAAM;IAJhC,OAAO;IAOP,0FAA0F;WAC5E,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc;IAY9D,4FAA4F;IAC5F,IAAW,oBAAoB,IAAI,OAAO,CAEzC;IAED,4FAA4F;IACrF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IASzC,yFAAyF;IAClF,eAAe,CACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,MAAM;IAKT;;;;;;;;;OASG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM;IAgBlE;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAOzB,+FAA+F;IACxF,UAAU,CACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,IAAI,CAAC,qBAIb,GACA,MAAM;CAMV"}

package/types/features/calls/presentation/CallOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CallOverlay.d.ts","sourceRoot":"","sources":["../../../../../../src/features/calls/presentation/CallOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAA+C,MAAM,OAAO,CAAC;AAOvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA+IzD,sGAAsG;AACtG,eAAO,MAAM,WAAW,GAAI,cAEzB;IACD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC,KAAG,YAAY,GAAG,IAsElB,CAAC"}
+{"version":3,"file":"CallOverlay.d.ts","sourceRoot":"","sources":["../../../../../../src/features/calls/presentation/CallOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAA+C,MAAM,OAAO,CAAC;AAQvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAoOzD,sGAAsG;AACtG,eAAO,MAAM,WAAW,GAAI,cAEzB;IACD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC,KAAG,YAAY,GAAG,IA8ElB,CAAC"}

package/types/features/calls/presentation/call-pip.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The Document Picture-in-Picture seam — the browser half of "the call follows you out of the tab".
+ *
+ * <p>A PiP window is a REAL, separate document: it inherits no stylesheet, no theme attribute and no
+ * font from the page that opened it. Everything the card needs has to be carried across explicitly,
+ * which is what most of this file is.</p>
+ *
+ * <p><b>And it has to be carried into the right SHAPE.</b> In the app the card lives in the document,
+ * styled by ordinary `:root` rules. Inside an SDK embed it lives in a shadow root, styled by a sheet
+ * whose `:root`/`html`/`body` selectors were rewritten to `:host` at build time
+ * (`scripts/sdk-css-transform.cjs`) — copy those into a plain document and every design token silently
+ * matches nothing, which is the unstyled-overlay failure the `no-restricted-syntax` portal rule in
+ * `eslint.config.ts` exists to warn about. So the pop-out mirrors whatever the card is already in: a
+ * shadow root gets a shadow root.</p>
+ *
+ * <p>Kept apart from React so the rules can be read (and tested) without mounting anything.</p>
+ */
+/** Options the API accepts. Narrower than the spec — only what this call surface uses. */
+export interface DocumentPipOptions {
+    readonly width?: number;
+    readonly height?: number;
+}
+/** Where styles come from, and therefore what shape the pop-out has to reproduce. */
+export type StyleRoot = Document | ShadowRoot;
+/** An open pop-out: the window, and the node to render the card into. */
+export interface PipMount {
+    readonly window: Window;
+    readonly container: HTMLElement | ShadowRoot;
+}
+/**
+ * Chromium 116+ only, at the time of writing. Everywhere else the call card simply stays in the page —
+ * a missing pop-out is a smaller failure than a call surface that throws on open.
+ */
+export declare const supportsDocumentPip: (host?: Window) => boolean;
+/** The PiP window currently open, if any — the browser allows at most one per document. */
+export declare const currentPipWindow: (host?: Window) => Window | null;
+/**
+ * Copies the page's styles into the PiP document.
+ *
+ * <p>Cloned rule by rule, which also captures Vite's dev-server styles and every CSS custom property
+ * the design system defines on `:root`. A cross-origin sheet cannot be read and is re-linked by href
+ * instead — the one case where cloning is impossible.</p>
+ */
+export declare const adoptStyles: (pip: Window, source?: StyleRoot) => void;
+/**
+ * Carries the theme across. The palette hangs off `data-theme` (and the class list) on the root element,
+ * so without this the card opens in whichever theme the tokens happen to default to — a white card
+ * flashing out of a dark app.
+ */
+export declare const adoptTheme: (pip: Window, source?: Document) => void;
+/**
+ * Opens the pop-out window, styled and themed, or null when the browser cannot.
+ *
+ * <p>Answers null rather than throwing: every caller is a UI affordance, and a call that keeps running
+ * in the tab is the correct outcome when the pop-out is refused. The refusal is ordinary — the API needs
+ * either a user gesture or Chrome's auto-picture-in-picture permission, and neither is guaranteed.</p>
+ *
+ * @param styleRoot what the card is currently styled by — its `getRootNode()`. A shadow root is
+ * reproduced as a shadow root; a document is copied into the pop-out's document.
+ */
+export declare const openPipWindow: (options?: DocumentPipOptions, styleRoot?: StyleRoot, host?: Window) => Promise<PipMount | null>;
+//# sourceMappingURL=call-pip.d.ts.map

package/types/features/calls/presentation/call-pip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-pip.d.ts","sourceRoot":"","sources":["../../../../../../src/features/calls/presentation/call-pip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9C,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,UAAU,CAAC;CAC9C;AAWD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAM,MAAe,KAAG,OACO,CAAC;AAEpE,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,GAAI,OAAM,MAAe,KAAG,MAAM,GAAG,IACG,CAAC;AAkCtE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,SAAQ,SAAoB,KAAG,IAcvE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,SAAQ,QAAmB,KAAG,IAQrE,CAAC;AAgDF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACxB,UAAS,kBAAuB,EAChC,YAAW,SAAoB,EAC/B,OAAM,MAAe,KACpB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAsBzB,CAAC"}

package/types/features/calls/presentation/use-call-pip.d.ts

@@ -0,0 +1,30 @@
+import { type RefObject } from 'react';
+import { type PipMount } from './call-pip';
+/**
+ * Moves the call card out into a floating window while the tab is in the background, and brings it back
+ * when the tab returns — the behaviour WhatsApp Web, Meet and Teams all have.
+ *
+ * <p><b>Why a Media Session handler and not a `visibilitychange` listener.</b> Opening a
+ * Picture-in-Picture window needs either a user gesture or Chrome's auto-picture-in-picture permission,
+ * and switching tabs is neither: calling `requestWindow` straight from `visibilitychange` is refused.
+ * The supported route is to register an `enterpictureinpicture` Media Session action — Chrome grants
+ * that permission to pages currently using the camera or microphone, which during a call we are, and
+ * then invokes the handler itself when the tab is hidden. This is the same mechanism the apps above use,
+ * so it inherits their behaviour rather than approximating it.</p>
+ *
+ * <p>Coming back is ours to do: the browser will happily leave the window floating over a tab you are
+ * already looking at, which is two copies of the same call.</p>
+ *
+ * @param live whether a call is on screen — the window opens only for one, and closes with it.
+ * @param cardRef the rendered card, read only to find what it is styled by. In the app that is the
+ * document; inside an SDK embed it is the widget's shadow root, and the pop-out has to be built to
+ * match or the card arrives with no styling at all.
+ * @returns the open mount to render into, plus a manual opener for the pop-out control. The opener is
+ * the graceful degradation path: a click IS a user gesture, so it works on Chromium even where the
+ * automatic permission was never granted.
+ */
+export declare const useCallPip: (live: boolean, cardRef: RefObject<HTMLElement | null>) => {
+    readonly mount: PipMount | null;
+    readonly popOut: () => void;
+};
+//# sourceMappingURL=use-call-pip.d.ts.map

package/types/features/calls/presentation/use-call-pip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-call-pip.d.ts","sourceRoot":"","sources":["../../../../../../src/features/calls/presentation/use-call-pip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAC;AACjF,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,OAAO,EACb,SAAS,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,KACrC;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CA+FhE,CAAC"}

package/types/features/chat/presentation/ConversationHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationHeader.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/presentation/ConversationHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAkB1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAKnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0HtD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/D;AAkFD,eAAO,MAAM,kBAAkB,GAAI,yKAahC,uBAAuB,KAAG,YAkD5B,CAAC"}
+{"version":3,"file":"ConversationHeader.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/presentation/ConversationHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAmB1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAKnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsHtD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/D;AAkFD,eAAO,MAAM,kBAAkB,GAAI,yKAahC,uBAAuB,KAAG,YAgD5B,CAAC"}

package/types/features/chat/presentation/MemberRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemberRow.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/presentation/MemberRow.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAM1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAIpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAyDD,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,KAAG,YAyDjD,CAAC"}
+{"version":3,"file":"MemberRow.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/presentation/MemberRow.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAIpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAyDD,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,KAAG,YAyDjD,CAAC"}

package/types/features/chat/presentation/dm-presence.d.ts

@@ -26,12 +26,11 @@ export interface DmPresenceInputs {
     } | undefined;
     /** The last status frame for the peer. Newer than the conversation's snapshot, so it wins. */
     readonly liveStatus: LiveStatusEntry | undefined;
-    readonly fallbackSubtitle: string;
     readonly nowMs: number;
 }
 /**
  * Resolve a DM's online dot + subtitle + badge from live presence, falling back to what the
  * conversation itself carried when no live frame has arrived yet. Pure.
  */
-export declare const resolveDmPresence: ({ conversation, live, liveStatus, fallbackSubtitle, nowMs, }: DmPresenceInputs) => DmPresence;
+export declare const resolveDmPresence: ({ conversation, live, liveStatus, nowMs, }: DmPresenceInputs) => DmPresence;
 //# sourceMappingURL=dm-presence.d.ts.map

package/types/features/chat/presentation/dm-presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dm-presence.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/presentation/dm-presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,mGAAmG;AACnG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;IAC7F,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,8DAM/B,gBAAgB,KAAG,UASrB,CAAC"}
+{"version":3,"file":"dm-presence.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/presentation/dm-presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,mGAAmG;AACnG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EACT;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACjE,SAAS,CAAC;IACd,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,4CAK/B,gBAAgB,KAAG,UAuBrB,CAAC"}

package/types/features/presence/application/index.d.ts

@@ -1,2 +1,3 @@
 export * from './use-cases/my-presence-use-cases';
+export * from './use-cases/get-presence-of';
 //# sourceMappingURL=index.d.ts.map

package/types/features/presence/application/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/application/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/application/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC"}

package/types/features/presence/application/use-cases/get-presence-of.d.ts

@@ -0,0 +1,14 @@
+import type { Result } from '@core/result';
+import type { OtherPresence, PresenceError } from '../../domain';
+import type { MyPresenceUseCaseDeps } from './my-presence-use-cases';
+/**
+ * Presence for the people currently visible on screen — the freshness contract for everyone ELSE's
+ * badge. Clients poll this for their visible ids rather than trusting a snapshot fetched before the
+ * socket was up: the snapshot race that once froze a colleague on Offline until reload.
+ */
+export declare class GetPresenceOfUseCase {
+    private readonly gateway;
+    constructor(deps: MyPresenceUseCaseDeps);
+    execute(userIds: readonly string[]): Promise<Result<readonly OtherPresence[], PresenceError>>;
+}
+//# sourceMappingURL=get-presence-of.d.ts.map

package/types/features/presence/application/use-cases/get-presence-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-presence-of.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/presence/application/use-cases/get-presence-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAEvB,IAAI,EAAE,qBAAqB;IAIvC,OAAO,CACZ,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;CAG5D"}

package/types/features/presence/domain/index.d.ts

@@ -1,4 +1,5 @@
 export * from './my-presence';
+export * from './others-presence';
 export * from './errors/presence-errors';
 export * from './ports/presence-gateway';
 //# sourceMappingURL=index.d.ts.map

package/types/features/presence/domain/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}

package/types/features/presence/domain/others-presence.d.ts

@@ -0,0 +1,18 @@
+import type { PresenceStatus } from '@shared/presence';
+/**
+ * Somebody ELSE's presence, as a colleague may see it beside their name.
+ *
+ * <p>Deliberately smaller than {@link MyPresence}: no `source` and no `note`. WHY somebody is busy —
+ * their calendar, their own hand — is theirs; what a colleague needs is only whether to interrupt,
+ * and until when. The server enforces the same cut, so this type cannot grow the fields by accident.</p>
+ *
+ * <p>`online` and `status` agree by construction — the server resolves Offline exactly when there is
+ * no connection — but both are carried so no consumer has to re-derive one from the other.</p>
+ */
+export interface OtherPresence {
+    readonly userId: string;
+    readonly online: boolean;
+    readonly status: PresenceStatus;
+    readonly untilUtc: string | null;
+}
+//# sourceMappingURL=others-presence.d.ts.map

package/types/features/presence/domain/others-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"others-presence.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/domain/others-presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC"}

package/types/features/presence/domain/ports/presence-gateway.d.ts

@@ -1,6 +1,7 @@
 import type { Result } from '@core/result';
 import type { PresenceError } from '../errors/presence-errors';
 import type { MyPresence, SetMyPresenceInput } from '../my-presence';
+import type { OtherPresence } from '../others-presence';
 /**
  * First-person only, mirroring the server.
  *
@@ -12,5 +13,11 @@ export interface PresenceGateway {
     getMine(): Promise<Result<MyPresence, PresenceError>>;
     setMine(input: SetMyPresenceInput): Promise<Result<MyPresence, PresenceError>>;
     clearMine(): Promise<Result<MyPresence, PresenceError>>;
+    /**
+     * The presence of the people a client has ON SCREEN. Read-only, so it does not bend the
+     * first-person rule above; the server answers every id (a stranger reads as offline) and refuses a
+     * batch larger than a screen's worth.
+     */
+    getOf(userIds: readonly string[]): Promise<Result<readonly OtherPresence[], PresenceError>>;
 }
 //# sourceMappingURL=presence-gateway.d.ts.map

package/types/features/presence/domain/ports/presence-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/presence/domain/ports/presence-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;CACzD"}
+{"version":3,"file":"presence-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/presence/domain/ports/presence-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;CAC7F"}

package/types/features/presence/infrastructure/dto/presence-dtos.d.ts

@@ -26,4 +26,38 @@ export interface SetMyPresenceRequestDto {
     readonly minutes: number;
     readonly note?: string;
 }
+/** One row of the visible-people batch. Status is the wire NUMBER, like everywhere else. */
+export declare const UserPresenceDtoSchema: z.ZodObject<{
+    userId: z.ZodString;
+    online: z.ZodBoolean;
+    status: z.ZodNumber;
+    untilUtc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: number;
+    userId: string;
+    online: boolean;
+    untilUtc?: string | null | undefined;
+}, {
+    status: number;
+    userId: string;
+    online: boolean;
+    untilUtc?: string | null | undefined;
+}>;
+export declare const UserPresenceListSchema: z.ZodArray<z.ZodObject<{
+    userId: z.ZodString;
+    online: z.ZodBoolean;
+    status: z.ZodNumber;
+    untilUtc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: number;
+    userId: string;
+    online: boolean;
+    untilUtc?: string | null | undefined;
+}, {
+    status: number;
+    userId: string;
+    online: boolean;
+    untilUtc?: string | null | undefined;
+}>, "many">;
+export type UserPresenceDto = z.infer<typeof UserPresenceDtoSchema>;
 //# sourceMappingURL=presence-dtos.d.ts.map

package/types/features/presence/infrastructure/dto/presence-dtos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence-dtos.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/presence/infrastructure/dto/presence-dtos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sGAAsG;AACtG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,gGAAgG;AAChG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"presence-dtos.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/presence/infrastructure/dto/presence-dtos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sGAAsG;AACtG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,gGAAgG;AAChG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;WAAiC,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/types/features/presence/infrastructure/http-presence-gateway.d.ts

@@ -1,7 +1,7 @@
 import type { HttpClient } from '@core/http';
 import type { Logger } from '@core/logger';
 import { type Result } from '@core/result';
-import { type MyPresence, type PresenceError, type PresenceGateway, type SetMyPresenceInput } from '../domain';
+import { type MyPresence, type OtherPresence, type PresenceError, type PresenceGateway, type SetMyPresenceInput } from '../domain';
 export interface HttpPresenceGatewayDeps {
     readonly httpClient: HttpClient;
     readonly logger: Logger;
@@ -13,6 +13,7 @@ export declare class HttpPresenceGateway implements PresenceGateway {
     constructor(deps: HttpPresenceGatewayDeps);
     getMine(): Promise<Result<MyPresence, PresenceError>>;
     setMine(input: SetMyPresenceInput): Promise<Result<MyPresence, PresenceError>>;
+    getOf(userIds: readonly string[]): Promise<Result<readonly OtherPresence[], PresenceError>>;
     clearMine(): Promise<Result<MyPresence, PresenceError>>;
     /**
      * One place for the parse-and-map, because all three endpoints answer with the SAME shape: the

package/types/features/presence/infrastructure/http-presence-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-presence-gateway.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/infrastructure/http-presence-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AACpD,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAKnB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,+FAA+F;AAC/F,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,IAAI,EAAE,uBAAuB;IAKzC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAIrD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAO9E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAO9D;;;;OAIG;YACW,OAAO;CAgBtB"}
+{"version":3,"file":"http-presence-gateway.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/infrastructure/http-presence-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AACpD,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAKnB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,+FAA+F;AAC/F,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,IAAI,EAAE,uBAAuB;IAKzC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAIrD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAOxE,KAAK,CAChB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;IAqBpD,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAO9D;;;;OAIG;YACW,OAAO;CAgBtB"}

package/types/features/presence/infrastructure/http-presence-routes.d.ts

@@ -6,5 +6,7 @@ export declare const PRESENCE_ROUTES: {
     readonly mine: "/api/app/presence/mine";
     readonly setMine: "/api/app/presence/set-mine";
     readonly clearMine: "/api/app/presence/clear-mine";
+    /** ABP binds `GetOfAsync(GetPresenceOfInput)` from the query string — one `Ids=` pair per id. */
+    readonly of: (userIds: readonly string[]) => string;
 };
 //# sourceMappingURL=http-presence-routes.d.ts.map

package/types/features/presence/infrastructure/http-presence-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-presence-routes.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/infrastructure/http-presence-routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC"}
+{"version":3,"file":"http-presence-routes.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/infrastructure/http-presence-routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;IAI1B,iGAAiG;2BACnF,SAAS,MAAM,EAAE,KAAG,MAAM;CAEhC,CAAC"}

package/types/features/presence/infrastructure/presence-mappers.d.ts

@@ -1,5 +1,5 @@
-import { type MyPresence, type SetMyPresenceInput } from '../domain';
-import type { MyPresenceDto, SetMyPresenceRequestDto } from './dto/presence-dtos';
+import { type MyPresence, type OtherPresence, type SetMyPresenceInput } from '../domain';
+import type { MyPresenceDto, SetMyPresenceRequestDto, UserPresenceDto } from './dto/presence-dtos';
 export declare const toMyPresence: (dto: MyPresenceDto) => MyPresence;
 /**
  * The domain's status name → the wire's number.
@@ -9,4 +9,5 @@ export declare const toMyPresence: (dto: MyPresenceDto) => MyPresence;
  * straight through, so nothing type-checked the difference.</p>
  */
 export declare const toSetMyPresenceRequest: (input: SetMyPresenceInput) => SetMyPresenceRequestDto;
+export declare const toOtherPresence: (dto: UserPresenceDto) => OtherPresence;
 //# sourceMappingURL=presence-mappers.d.ts.map

package/types/features/presence/infrastructure/presence-mappers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence-mappers.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/infrastructure/presence-mappers.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAElF,eAAO,MAAM,YAAY,GAAI,KAAK,aAAa,KAAG,UAMhD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,kBAAkB,KAAG,uBAIjE,CAAC"}
+{"version":3,"file":"presence-mappers.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/infrastructure/presence-mappers.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEnG,eAAO,MAAM,YAAY,GAAI,KAAK,aAAa,KAAG,UAMhD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,kBAAkB,KAAG,uBAIjE,CAAC;AAEH,eAAO,MAAM,eAAe,GAAI,KAAK,eAAe,KAAG,aAKrD,CAAC"}

package/types/features/presence/presence-module.d.ts

@@ -1,6 +1,6 @@
 import type { HttpClient } from '@core/http';
 import type { Logger } from '@core/logger';
-import { ClearMyPresenceUseCase, GetMyPresenceUseCase, SetMyPresenceUseCase } from './application';
+import { ClearMyPresenceUseCase, GetMyPresenceUseCase, GetPresenceOfUseCase, SetMyPresenceUseCase } from './application';
 export interface PresenceModuleDeps {
     readonly logger: Logger;
     readonly httpClient: HttpClient;
@@ -9,6 +9,7 @@ export interface PresenceModule {
     readonly getMyPresence: GetMyPresenceUseCase;
     readonly setMyPresence: SetMyPresenceUseCase;
     readonly clearMyPresence: ClearMyPresenceUseCase;
+    readonly getPresenceOf: GetPresenceOfUseCase;
     readonly logger: Logger;
 }
 /** Composition root for presence — one gateway shared by the three first-person use cases. */

package/types/features/presence/presence-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence-module.d.ts","sourceRoot":"","sources":["../../../../../src/features/presence/presence-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,GAAI,MAAM,kBAAkB,KAAG,cAa/D,CAAC"}
+{"version":3,"file":"presence-module.d.ts","sourceRoot":"","sources":["../../../../../src/features/presence/presence-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,GAAI,MAAM,kBAAkB,KAAG,cAc/D,CAAC"}

package/types/features/presence/presentation/MyPresenceMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MyPresenceMenu.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/MyPresenceMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AA2C1C;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,KAAG,YAoDhF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAAO,YAYlC,CAAC"}
+{"version":3,"file":"MyPresenceMenu.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/MyPresenceMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AA6C1C;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,KAAG,YAqDhF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAAO,YAalC,CAAC"}

package/types/features/presence/presentation/PresenceModuleProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceModuleProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/PresenceModuleProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,eAAO,MAAM,sBAAsB,GAAI,uBAGpC;IACD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,KAAG,YAEH,CAAC"}
+{"version":3,"file":"PresenceModuleProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/PresenceModuleProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAYzD,eAAO,MAAM,sBAAsB,GAAI,uBAGpC;IACD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,KAAG,YAKH,CAAC"}

package/types/features/presence/presentation/ViewerPresenceBadge.d.ts

@@ -0,0 +1,22 @@
+import type { ReactElement } from 'react';
+import type { PresenceStatus } from '@shared/presence';
+export interface ViewerPresenceBadgeProps {
+    readonly status: PresenceStatus;
+    /** When the status ends, or null when nothing bounds it. */
+    readonly untilUtc?: string | null;
+    readonly size?: 'sm' | 'md';
+}
+/**
+ * A {@link PresenceBadge} already wired to the READER's clock.
+ *
+ * <p>`PresenceBadge` takes its formatter as a prop because it sits in `shared/` and cannot reach the
+ * viewer's preferences. Every caller then wrote the same three lines to hand it
+ * `useViewerTimeZone().formatUntil` — chat header, member list, user directory — which is three chances
+ * to reach for `formatTime` instead and render a deadline on another day as a bare `HH:MM` that reads
+ * as today, and as already past.</p>
+ *
+ * <p>So the wiring lives here once. Use this anywhere inside the app; reach for `PresenceBadge`
+ * directly only where there is genuinely no viewer to have a timezone.</p>
+ */
+export declare const ViewerPresenceBadge: ({ status, untilUtc, size, }: ViewerPresenceBadgeProps) => ReactElement;
+//# sourceMappingURL=ViewerPresenceBadge.d.ts.map

package/types/features/presence/presentation/ViewerPresenceBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerPresenceBadge.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/ViewerPresenceBadge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,6BAIjC,wBAAwB,KAAG,YAW7B,CAAC"}

package/types/features/presence/presentation/index.d.ts

@@ -2,4 +2,6 @@ export * from './PresenceModuleProvider';
 export * from './use-presence-module';
 export * from './use-my-presence';
 export * from './MyPresenceMenu';
+export * from './use-live-presence-poll';
+export * from './ViewerPresenceBadge';
 //# sourceMappingURL=index.d.ts.map

package/types/features/presence/presentation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/types/features/presence/presentation/use-live-presence-poll.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The freshness loop for everyone ELSE's badge: every mounted badge registers its person as watched
+ * (see `useLiveStatus`), and this hook polls `presence/of` for exactly that set, writing the answers
+ * into the shared live store that every badge already reads.
+ *
+ * <p>This is the poor man's presence subscription — the same visibility-scoped shape Slack's
+ * `presence_sub` has, built on a poll instead of a socket. It closes the whole class of snapshot
+ * races structurally: a conversation fetched before the socket was up, a StatusChanged event missed
+ * during a reconnect, a backend restart that wiped the in-memory presence store — all of them
+ * converge within one interval, because the poll asks the server fresh every time.</p>
+ *
+ * <p>Cost scales with what is on screen, not with the tenant: fifty visible people is one request
+ * per interval, answered mostly from the server's cache. The set changing (a page navigation
+ * mounting different badges) re-keys the query, so newly visible people resolve immediately rather
+ * than waiting out the interval.</p>
+ */
+export declare const useLivePresencePoll: () => void;
+//# sourceMappingURL=use-live-presence-poll.d.ts.map

package/types/features/presence/presentation/use-live-presence-poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-live-presence-poll.d.ts","sourceRoot":"","sources":["../../../../../../src/features/presence/presentation/use-live-presence-poll.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,QAAO,IAwBtC,CAAC"}

package/types/features/users/presentation/UserPresenceCell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserPresenceCell.d.ts","sourceRoot":"","sources":["../../../../../../src/features/users/presentation/UserPresenceCell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,KAAG,YAwBpE,CAAC"}
+{"version":3,"file":"UserPresenceCell.d.ts","sourceRoot":"","sources":["../../../../../../src/features/users/presentation/UserPresenceCell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,KAAG,YA0BpE,CAAC"}

package/types/sdk/index.d.ts

@@ -20,7 +20,7 @@ export { createNotificationClient, type NotificationClient, type NotificationCli
  * The signed-in person's own status, without a widget. The widgets show everyone ELSE's status; this
  * is how a host's own header lets somebody set theirs.
  */
-export { createPresenceClient, type PresenceClient, type PresenceClientOptions, type SdkPresence, type SdkPresenceSource, type SdkPresenceStatus, type SetSdkPresenceInput, } from './presence/presence-client';
+export { createPresenceClient, type PresenceClient, type PresenceClientOptions, type SdkOtherPresence, type SdkPresence, type SdkPresenceSource, type SdkPresenceStatus, type SetSdkPresenceInput, } from './presence/presence-client';
 export { WidgetRoot, type WidgetRootProps } from './elements/WidgetRoot';
 export { registerChatWidget, registerFeedWidget, registerBookingsWidget, registerScheduleWidget, };
 export { SDK_MODULE_SCOPES, type AuthConfig, type CommsProviderProps, type SdkEvent, type SdkModuleScope, type ThemeConfig, type ThemeDensity, type ThemeMode, } from './types';

package/types/sdk/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD;;;GAGG;AACH,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,GACrB,MAAM,qCAAqC,CAAC;AAC7C;;;GAGG;AACH,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GACvB,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAO,IAKvC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD;;;GAGG;AACH,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,GACrB,MAAM,qCAAqC,CAAC;AAC7C;;;GAGG;AACH,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GACvB,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAO,IAKvC,CAAC"}

package/types/sdk/presence/presence-client.d.ts

@@ -18,6 +18,18 @@ export interface SdkPresence {
     /** True only while a self-set status is in force — the one case `clearMine` applies to. */
     readonly hasOverride: boolean;
 }
+/**
+ * Somebody ELSE's presence. Deliberately smaller than {@link SdkPresence}: no `source`, no `note` —
+ * WHY a person is busy is theirs; what a colleague needs is whether to interrupt, and until when.
+ */
+export interface SdkOtherPresence {
+    readonly userId: string;
+    /** Whether their client is open. Independent of `status`: someone in a meeting is very much online. */
+    readonly online: boolean;
+    readonly status: SdkPresenceStatus;
+    /** ISO 8601 UTC instant the status ends, or null when nothing bounds it. Format it locally. */
+    readonly untilUtc: string | null;
+}
 export interface SetSdkPresenceInput {
     readonly status: SdkPresenceStatus;
     /**
@@ -47,6 +59,18 @@ export interface PresenceClient {
     setMine: (input: SetSdkPresenceInput) => Promise<SdkPresence | null>;
     /** Ends a self-set status early, falling back to whatever the system infers. */
     clearMine: () => Promise<SdkPresence | null>;
+    /**
+     * The presence of OTHER people — for a people-list you render yourself, outside the widgets.
+     *
+     * <p>Ask only for the ids currently on screen and poll about every 30 seconds: the server resolves
+     * fresh behind a cache on the same interval, so asking faster buys nothing, and asking about people
+     * nobody is looking at is the cost model this endpoint exists to protect. At most 100 ids per call;
+     * more is refused rather than truncated, so a page is never half-fresh.</p>
+     *
+     * <p>Answers `null` only when the call itself failed. A stranger the server knows nothing about
+     * comes back as an offline row, so a returned list always has one entry per requested id.</p>
+     */
+    getOf: (userIds: readonly string[]) => Promise<readonly SdkOtherPresence[] | null>;
 }
 /**
  * The signed-in person's own status, WITHOUT a widget.

package/types/sdk/presence/presence-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence-client.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/presence/presence-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAE/C,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpF,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mGAAmG;IACnG,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrE,gFAAgF;IAChF,SAAS,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cAiCrE,CAAC"}
+{"version":3,"file":"presence-client.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/presence/presence-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAE/C,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpF,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uGAAuG;IACvG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mGAAmG;IACnG,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrE,gFAAgF;IAChF,SAAS,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C;;;;;;;;;;OAUG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;CACpF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cAwCrE,CAAC"}

package/types/shared/presence/PresenceBadge.d.ts

@@ -4,8 +4,19 @@ export interface PresenceBadgeProps {
     readonly status: PresenceStatus;
     /** When the status ends. Rendered only when a formatter is supplied — see the note below. */
     readonly untilUtc?: string | null;
-    /** Formats an ISO instant in the READER's locale and zone. Omit to show the bare label. */
-    readonly formatTime?: (iso: string) => string;
+    /**
+     * Formats the END of the status in the VIEWER'S configured display zone — pass
+     * `useViewerTimeZone().formatUntil`. Omit to show the bare label.
+     *
+     * <p>`formatUntil`, NOT `formatTime`: a deadline on another day rendered as bare `HH:MM` reads as
+     * today and can therefore read as already past — somebody away all Sunday is back Monday, and
+     * "Away until 16:00" on a Sunday afternoon is simply false. The narrower name is the guard.</p>
+     *
+     * <p>Injected rather than chosen here: this component cannot reach the viewer's preferences, and
+     * quietly formatting in the browser's zone would make presence the one surface that disagrees with
+     * every other clock on the page for anyone who has set a personal timezone.</p>
+     */
+    readonly formatUntil?: (iso: string) => string;
     readonly size?: 'sm' | 'md';
 }
 /**
@@ -19,5 +30,5 @@ export interface PresenceBadgeProps {
  * <p>One component for every surface. Five places rendering their own version is how the same person
  * ends up a different colour in the chat header and the directory on the same screen.</p>
  */
-export declare const PresenceBadge: ({ status, untilUtc, formatTime, size, }: PresenceBadgeProps) => ReactElement;
+export declare const PresenceBadge: ({ status, untilUtc, formatUntil, size, }: PresenceBadgeProps) => ReactElement;
 //# sourceMappingURL=PresenceBadge.d.ts.map