@palbase/web 1.6.1 → 1.7.0

package/dist/{analytics-facade-ATGUv2-f.d.cts → analytics-facade-9GPSKnVG.d.cts}

@@ -825,6 +825,49 @@ interface ChatMessage {
      * Mirrors iOS `ChatMessage.effectiveExpiry` (which it derives from).
      */
     readonly expiresAt: Date | null;
+    /**
+     * Server-metadata cluster — the double-tick DELIVERED watermark on THIS user's OWN
+     * (`direction === 'outgoing'`) messages, FOLDED TO USER-LEVEL. The wire carries the
+     * acking device_id; the SDK folds across a peer's devices and across peers to ONE
+     * user-level server_seq (MONOTONIC max — a stale lower incoming tick NEVER lowers it).
+     * A per-message tick is "is `message.serverSeq <= deliveredUpTo`?". Absent (`undefined`)
+     * until a `delivered` conv event covers this message; never set on an incoming message.
+     * Mirrors iOS `Chat.deliveredUpTo` (a chat-level scalar there; per-message here).
+     */
+    readonly deliveredUpTo?: number;
+    /**
+     * Server-metadata cluster — the double-tick READ watermark on THIS user's OWN
+     * (`direction === 'outgoing'`) messages, FOLDED TO USER-LEVEL + MONOTONIC max (same
+     * fold as `deliveredUpTo`). Set by a `read` conv event. Read STAYS gated by the peer's
+     * `share_receipts` server-side (the broadcast simply never arrives when muted); the
+     * client fold is identical to delivered. Mirrors iOS `Chat.readUpTo`.
+     */
+    readonly readUpTo?: number;
+}
+/**
+ * The per-(user, group) notify scope (the server-metadata MUTE toggle). `'all'`
+ * (default, absent row) fires the push wake; `'none'` (muted) suppresses it. The raw
+ * wire value is the snake-free `"all"`/`"none"` string. An unknown/garbage server value
+ * maps to `'all'` at the surface — fail-OPEN, never silently mutes (mirrors iOS
+ * `NotifyScope`). The server stores this opaque enum and stays MLS-blind (no content).
+ */
+type NotifyScope = 'all' | 'none';
+/**
+ * The caller's OWN unread view (the `GET /v1/messaging/groups/{gid}/unread` response).
+ * Every field is an OPAQUE server-metadata integer (no message content): the group's max
+ * server_seq, this caller's read + delivered cursors, and the server-derived unread
+ * count. The camelCase mirror of the snake_case wire (`group_max_seq` → `groupMaxSeq`,
+ * etc). Mirrors iOS `UnreadView`.
+ */
+interface UnreadView {
+    /** The highest server_seq the group has reached (the newest message's seq). */
+    readonly groupMaxSeq: number;
+    /** The furthest server_seq THIS caller has marked read. */
+    readonly lastReadSeq: number;
+    /** The furthest server_seq THIS caller's devices have acked delivered. */
+    readonly deliveredSeq: number;
+    /** The server-derived unread count for this caller (clamped `>= 0` at the surface). */
+    readonly unreadCount: number;
 }
 /** The receipt from a send — the server's monotonic sequence + accepted epoch. */
 interface SentReceipt {
@@ -1001,7 +1044,12 @@ interface ChatBackend {
     registerActive(group: MessagingGroup): void;
     setTyping(group: MessagingGroup, isTyping: boolean): void;
     markRead(group: MessagingGroup, upToServerSeq: number): Promise<void>;
-    /** Subscribe live message + conv (presence/typing/read) for an active group. */
+    /** Server-metadata cluster: set/get the per-(user,group) notify scope (mute) and
+     * fetch the caller's own unread view. The server stays MLS-blind (opaque metadata). */
+    setNotifyScope(group: MessagingGroup, scope: NotifyScope): Promise<NotifyScope>;
+    getNotifyScope(group: MessagingGroup): Promise<NotifyScope>;
+    unread(group: MessagingGroup): Promise<UnreadView>;
+    /** Subscribe live message + conv (presence/typing/read/delivered) for an active group. */
     subscribeLive(group: MessagingGroup, chat: Chat): Unsubscribe$1;
     /** Resolve a sender device id → its owning user id (for senderUserId). */
     userIdForDevice(group: MessagingGroup, deviceId: string): Promise<string | null>;
@@ -1306,6 +1354,20 @@ declare class Chat {
     leave(): Promise<void>;
     setTyping(isTyping: boolean): void;
     markRead(message: ChatMessage): Promise<void>;
+    /** Set this chat's notify scope (the mute toggle). `'none'` mutes the push wake;
+     * `'all'` unmutes (the default). Materializes a draft first (the scope is a
+     * per-(user,group) server row), PUTs `/notify`, and returns the server-echoed scope.
+     * Mirrors iOS `Chat.setNotifyScope`. */
+    setNotifyScope(scope: NotifyScope): Promise<NotifyScope>;
+    /** Refresh + return this chat's notify scope from the server (fail-OPEN to `'all'`).
+     * Returns `'all'` for a draft chat (no server row yet). */
+    getNotifyScope(): Promise<NotifyScope>;
+    /** Fetch the caller's authoritative SERVER unread count (opaque server metadata).
+     * Returns the clamped count (`max(0, …)`); `0` for a draft chat. The local computed
+     * `unreadCount` getter stays the instant, offline best-effort badge — this is the
+     * canonical count on demand. Named distinctly so it does not shadow the observable
+     * `unreadCount` snapshot getter. Mirrors iOS `Chat.refreshUnread`. */
+    unreadCountFromServer(): Promise<number>;
     /** Add an emoji reaction to a message. No-op if the message isn't reactable
      * (empty clientMsgId — a legacy/system row). The reaction folds locally with
      * the server receipt's `(epoch, serverSeq)` so the target's tally updates
@@ -1731,4 +1793,4 @@ declare class PalbeAnalytics {
     private post;
 }
 
-export { type AnalyticsProperties as A, type PresenceState as B, Call as C, type RealtimeConnectionState as D, type RealtimeHandler as E, type FlagsView as F, type RealtimePayload as G, type RealtimeStatus as H, type RealtimeStatusSnapshot as I, type RealtimeSubscription as J, type ResolvedMention as K, type ResolvedReply as L, type MagicLinkResult as M, type PalbeRuntime as N, type OAuthExchangeResult as O, PalbeAnalytics as P, buildRuntime as Q, RealtimeChannel as R, type SentReceipt as S, type Unsubscribe as U, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MentionRange as r, type MessageDirection as s, PalbeAuth as t, PalbeCalls as u, type PalbeConfig as v, PalbeFlags as w, PalbeMessaging as x, type PalbeOAuthConfig as y, PalbeRealtime as z };
+export { type AnalyticsProperties as A, type PresenceState as B, Call as C, type RealtimeConnectionState as D, type RealtimeHandler as E, type FlagsView as F, type RealtimePayload as G, type RealtimeStatus as H, type RealtimeStatusSnapshot as I, type RealtimeSubscription as J, type ResolvedMention as K, type ResolvedReply as L, type MagicLinkResult as M, type NotifyScope as N, type OAuthExchangeResult as O, PalbeAnalytics as P, type Unsubscribe as Q, RealtimeChannel as R, type SentReceipt as S, type PalbeRuntime as T, type UnreadView as U, buildRuntime as V, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MentionRange as r, type MessageDirection as s, PalbeAuth as t, PalbeCalls as u, type PalbeConfig as v, PalbeFlags as w, PalbeMessaging as x, type PalbeOAuthConfig as y, PalbeRealtime as z };

package/dist/{analytics-facade-DhcTP_kw.d.ts → analytics-facade-CQJ3b-zB.d.ts}

@@ -825,6 +825,49 @@ interface ChatMessage {
      * Mirrors iOS `ChatMessage.effectiveExpiry` (which it derives from).
      */
     readonly expiresAt: Date | null;
+    /**
+     * Server-metadata cluster — the double-tick DELIVERED watermark on THIS user's OWN
+     * (`direction === 'outgoing'`) messages, FOLDED TO USER-LEVEL. The wire carries the
+     * acking device_id; the SDK folds across a peer's devices and across peers to ONE
+     * user-level server_seq (MONOTONIC max — a stale lower incoming tick NEVER lowers it).
+     * A per-message tick is "is `message.serverSeq <= deliveredUpTo`?". Absent (`undefined`)
+     * until a `delivered` conv event covers this message; never set on an incoming message.
+     * Mirrors iOS `Chat.deliveredUpTo` (a chat-level scalar there; per-message here).
+     */
+    readonly deliveredUpTo?: number;
+    /**
+     * Server-metadata cluster — the double-tick READ watermark on THIS user's OWN
+     * (`direction === 'outgoing'`) messages, FOLDED TO USER-LEVEL + MONOTONIC max (same
+     * fold as `deliveredUpTo`). Set by a `read` conv event. Read STAYS gated by the peer's
+     * `share_receipts` server-side (the broadcast simply never arrives when muted); the
+     * client fold is identical to delivered. Mirrors iOS `Chat.readUpTo`.
+     */
+    readonly readUpTo?: number;
+}
+/**
+ * The per-(user, group) notify scope (the server-metadata MUTE toggle). `'all'`
+ * (default, absent row) fires the push wake; `'none'` (muted) suppresses it. The raw
+ * wire value is the snake-free `"all"`/`"none"` string. An unknown/garbage server value
+ * maps to `'all'` at the surface — fail-OPEN, never silently mutes (mirrors iOS
+ * `NotifyScope`). The server stores this opaque enum and stays MLS-blind (no content).
+ */
+type NotifyScope = 'all' | 'none';
+/**
+ * The caller's OWN unread view (the `GET /v1/messaging/groups/{gid}/unread` response).
+ * Every field is an OPAQUE server-metadata integer (no message content): the group's max
+ * server_seq, this caller's read + delivered cursors, and the server-derived unread
+ * count. The camelCase mirror of the snake_case wire (`group_max_seq` → `groupMaxSeq`,
+ * etc). Mirrors iOS `UnreadView`.
+ */
+interface UnreadView {
+    /** The highest server_seq the group has reached (the newest message's seq). */
+    readonly groupMaxSeq: number;
+    /** The furthest server_seq THIS caller has marked read. */
+    readonly lastReadSeq: number;
+    /** The furthest server_seq THIS caller's devices have acked delivered. */
+    readonly deliveredSeq: number;
+    /** The server-derived unread count for this caller (clamped `>= 0` at the surface). */
+    readonly unreadCount: number;
 }
 /** The receipt from a send — the server's monotonic sequence + accepted epoch. */
 interface SentReceipt {
@@ -1001,7 +1044,12 @@ interface ChatBackend {
     registerActive(group: MessagingGroup): void;
     setTyping(group: MessagingGroup, isTyping: boolean): void;
     markRead(group: MessagingGroup, upToServerSeq: number): Promise<void>;
-    /** Subscribe live message + conv (presence/typing/read) for an active group. */
+    /** Server-metadata cluster: set/get the per-(user,group) notify scope (mute) and
+     * fetch the caller's own unread view. The server stays MLS-blind (opaque metadata). */
+    setNotifyScope(group: MessagingGroup, scope: NotifyScope): Promise<NotifyScope>;
+    getNotifyScope(group: MessagingGroup): Promise<NotifyScope>;
+    unread(group: MessagingGroup): Promise<UnreadView>;
+    /** Subscribe live message + conv (presence/typing/read/delivered) for an active group. */
     subscribeLive(group: MessagingGroup, chat: Chat): Unsubscribe$1;
     /** Resolve a sender device id → its owning user id (for senderUserId). */
     userIdForDevice(group: MessagingGroup, deviceId: string): Promise<string | null>;
@@ -1306,6 +1354,20 @@ declare class Chat {
     leave(): Promise<void>;
     setTyping(isTyping: boolean): void;
     markRead(message: ChatMessage): Promise<void>;
+    /** Set this chat's notify scope (the mute toggle). `'none'` mutes the push wake;
+     * `'all'` unmutes (the default). Materializes a draft first (the scope is a
+     * per-(user,group) server row), PUTs `/notify`, and returns the server-echoed scope.
+     * Mirrors iOS `Chat.setNotifyScope`. */
+    setNotifyScope(scope: NotifyScope): Promise<NotifyScope>;
+    /** Refresh + return this chat's notify scope from the server (fail-OPEN to `'all'`).
+     * Returns `'all'` for a draft chat (no server row yet). */
+    getNotifyScope(): Promise<NotifyScope>;
+    /** Fetch the caller's authoritative SERVER unread count (opaque server metadata).
+     * Returns the clamped count (`max(0, …)`); `0` for a draft chat. The local computed
+     * `unreadCount` getter stays the instant, offline best-effort badge — this is the
+     * canonical count on demand. Named distinctly so it does not shadow the observable
+     * `unreadCount` snapshot getter. Mirrors iOS `Chat.refreshUnread`. */
+    unreadCountFromServer(): Promise<number>;
     /** Add an emoji reaction to a message. No-op if the message isn't reactable
      * (empty clientMsgId — a legacy/system row). The reaction folds locally with
      * the server receipt's `(epoch, serverSeq)` so the target's tally updates
@@ -1731,4 +1793,4 @@ declare class PalbeAnalytics {
     private post;
 }
 
-export { type AnalyticsProperties as A, type PresenceState as B, Call as C, type RealtimeConnectionState as D, type RealtimeHandler as E, type FlagsView as F, type RealtimePayload as G, type RealtimeStatus as H, type RealtimeStatusSnapshot as I, type RealtimeSubscription as J, type ResolvedMention as K, type ResolvedReply as L, type MagicLinkResult as M, type PalbeRuntime as N, type OAuthExchangeResult as O, PalbeAnalytics as P, buildRuntime as Q, RealtimeChannel as R, type SentReceipt as S, type Unsubscribe as U, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MentionRange as r, type MessageDirection as s, PalbeAuth as t, PalbeCalls as u, type PalbeConfig as v, PalbeFlags as w, PalbeMessaging as x, type PalbeOAuthConfig as y, PalbeRealtime as z };
+export { type AnalyticsProperties as A, type PresenceState as B, Call as C, type RealtimeConnectionState as D, type RealtimeHandler as E, type FlagsView as F, type RealtimePayload as G, type RealtimeStatus as H, type RealtimeStatusSnapshot as I, type RealtimeSubscription as J, type ResolvedMention as K, type ResolvedReply as L, type MagicLinkResult as M, type NotifyScope as N, type OAuthExchangeResult as O, PalbeAnalytics as P, type Unsubscribe as Q, RealtimeChannel as R, type SentReceipt as S, type PalbeRuntime as T, type UnreadView as U, buildRuntime as V, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MentionRange as r, type MessageDirection as s, PalbeAuth as t, PalbeCalls as u, type PalbeConfig as v, PalbeFlags as w, PalbeMessaging as x, type PalbeOAuthConfig as y, PalbeRealtime as z };

package/dist/{chunk-EQAHM3ZJ.js → chunk-QRO632M7.js}

@@ -2884,6 +2884,10 @@ var MessagingPaths = {
   groupMessages: (displayId) => `${GROUPS}/${seg(displayId)}/messages`,
   groupCommits: (displayId) => `${GROUPS}/${seg(displayId)}/commits`,
   groupRead: (displayId) => `${GROUPS}/${seg(displayId)}/read`,
+  // Server-metadata cluster: the per-(user,group) notify scope (mute toggle, GET/PUT)
+  // + the caller's own unread view (GET). {gid} is the grp_ display_id (M3 #7).
+  groupNotify: (displayId) => `${GROUPS}/${seg(displayId)}/notify`,
+  groupUnread: (displayId) => `${GROUPS}/${seg(displayId)}/unread`,
   deviceWelcomes: (deviceId) => `${DEVICES}/${seg(deviceId)}/welcomes`,
   deviceQueue: (deviceId) => `${DEVICES}/${seg(deviceId)}/queue`,
   deviceQueueAck: (deviceId) => `${DEVICES}/${seg(deviceId)}/queue/ack`,
@@ -4462,6 +4466,18 @@ var Chat = class {
         lastSeenAt: ts ? new Date(ts * 1e3) : null
       });
       this.emit();
+    } else if (event === "delivered" || event === "read") {
+      const seq = typeof payload.up_to_server_seq === "number" ? payload.up_to_server_seq : null;
+      if (seq === null) return;
+      let changed = false;
+      this.messageList = this.messageList.map((m) => {
+        if (m.direction !== "outgoing" || m.serverSeq > seq) return m;
+        const cur = event === "delivered" ? m.deliveredUpTo ?? -1 : m.readUpTo ?? -1;
+        if (seq <= cur) return m;
+        changed = true;
+        return event === "delivered" ? { ...m, deliveredUpTo: seq } : { ...m, readUpTo: seq };
+      });
+      if (changed) this.emit();
     }
   }
   kindOf(incoming) {
@@ -4710,6 +4726,31 @@ var Chat = class {
     this.readWatermark = Math.max(this.readWatermark, message.serverSeq);
     this.emit();
   }
+  // ── Server-metadata cluster: notify scope (mute) + server unread ──
+  /** Set this chat's notify scope (the mute toggle). `'none'` mutes the push wake;
+   * `'all'` unmutes (the default). Materializes a draft first (the scope is a
+   * per-(user,group) server row), PUTs `/notify`, and returns the server-echoed scope.
+   * Mirrors iOS `Chat.setNotifyScope`. */
+  async setNotifyScope(scope) {
+    const group = await this.materializeIfNeeded();
+    return this.backend.setNotifyScope(group, scope);
+  }
+  /** Refresh + return this chat's notify scope from the server (fail-OPEN to `'all'`).
+   * Returns `'all'` for a draft chat (no server row yet). */
+  async getNotifyScope() {
+    if (!this._group) return "all";
+    return this.backend.getNotifyScope(this._group);
+  }
+  /** Fetch the caller's authoritative SERVER unread count (opaque server metadata).
+   * Returns the clamped count (`max(0, …)`); `0` for a draft chat. The local computed
+   * `unreadCount` getter stays the instant, offline best-effort badge — this is the
+   * canonical count on demand. Named distinctly so it does not shadow the observable
+   * `unreadCount` snapshot getter. Mirrors iOS `Chat.refreshUnread`. */
+  async unreadCountFromServer() {
+    if (!this._group) return 0;
+    const v = await this.backend.unread(this._group);
+    return Math.max(0, v.unreadCount);
+  }
   // ── Reactions ──
   /** Add an emoji reaction to a message. No-op if the message isn't reactable
    * (empty clientMsgId — a legacy/system row). The reaction folds locally with
@@ -5148,7 +5189,7 @@ var MessageDeliverySource = class {
     if (this.observed.has(group.displayId)) return;
     try {
       const channel = this.rt.realtime.channel(`messaging:conv:${group.rfcGroupId}`);
-      const subs = ["presence", "typing", "read"].map(
+      const subs = ["presence", "typing", "read", "delivered"].map(
         (ev) => channel.on(ev, (payload) => {
           this.hub.emitConv(group.displayId, { event: ev, payload });
         })
@@ -5188,6 +5229,40 @@ var MessageDeliverySource = class {
       body: { read_seq: upToServerSeq, read_epoch: group.currentEpoch, is_private: false }
     });
   }
+  // ── Server-metadata cluster: notify scope (mute) + unread (HTTP) ──
+  /** PUT `/v1/messaging/groups/{gid}/notify` — set the caller's per-(user,group) notify
+   * scope (`'all'`|`'none'`). The server stores the opaque enum verbatim and stays blind.
+   * Returns the server-echoed scope (fail-OPEN to `'all'` on an unknown value). */
+  async setNotifyScope(group, scope) {
+    const res = await palbeRequest(
+      this.rt,
+      "PUT",
+      MessagingPaths.groupNotify(group.displayId),
+      { body: { notify_scope: scope } }
+    );
+    return res.notify_scope === "none" ? "none" : "all";
+  }
+  /** GET `/v1/messaging/groups/{gid}/notify` — the caller's notify scope. An absent
+   * server row / unknown value reads as `'all'` (fail-OPEN — never silently mutes). */
+  async getNotifyScope(group) {
+    const res = await palbeRequest(
+      this.rt,
+      "GET",
+      MessagingPaths.groupNotify(group.displayId)
+    );
+    return res.notify_scope === "none" ? "none" : "all";
+  }
+  /** GET `/v1/messaging/groups/{gid}/unread` — the caller's OWN unread view (opaque
+   * server metadata). Maps the snake_case wire → the camelCase `UnreadView`. */
+  async unread(group) {
+    const res = await palbeRequest(this.rt, "GET", MessagingPaths.groupUnread(group.displayId));
+    return {
+      groupMaxSeq: res.group_max_seq,
+      lastReadSeq: res.last_read_seq,
+      deliveredSeq: res.delivered_seq,
+      unreadCount: res.unread_count
+    };
+  }
 };
 function isOwnEchoOrConsumed(e) {
   const msg = e instanceof Error ? e.message : String(e);
@@ -7241,9 +7316,9 @@ var MessagingCoordinator = class {
     });
     return group;
   }
-  async sendText(group, text, replyTo, bodyRanges) {
+  async sendText(group, text, replyTo, bodyRanges, expiry) {
     const r = await this.resolve();
-    return r.groups.sendText(group, text, replyTo, bodyRanges);
+    return r.groups.sendText(group, text, replyTo, bodyRanges, expiry);
   }
   async sendReaction(group, args) {
     const r = await this.resolve();
@@ -7344,6 +7419,19 @@ var MessagingCoordinator = class {
     const r = await this.resolve();
     await r.source.markRead(group, upToServerSeq);
   }
+  // ── Server-metadata cluster: notify scope (mute) + unread ──
+  async setNotifyScope(group, scope) {
+    const r = await this.resolve();
+    return r.source.setNotifyScope(group, scope);
+  }
+  async getNotifyScope(group) {
+    const r = await this.resolve();
+    return r.source.getNotifyScope(group);
+  }
+  async unread(group) {
+    const r = await this.resolve();
+    return r.source.unread(group);
+  }
   subscribeLive(group, chat) {
     let offMsg = null;
     let offConv = null;
@@ -8283,7 +8371,7 @@ function defaultSessionStorage(key) {
 }
 
 // src/version.ts
-var VERSION = "1.6.1";
+var VERSION = "1.7.0";
 
 // src/runtime.ts
 function buildRuntime(config) {
@@ -8643,4 +8731,4 @@ export {
   pb,
   createBoundClient
 };
-//# sourceMappingURL=chunk-EQAHM3ZJ.js.map
+//# sourceMappingURL=chunk-QRO632M7.js.map