@palbase/web 1.6.2 → 1.8.0

package/dist/index.cjs

@@ -161,14 +161,47 @@ function unwrap(res) {
   return res.data;
 }
 
+// src/perf/url-redactor.ts
+var ID_SEGMENT = /^(?:\d+|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$/;
+var EMAIL_SEGMENT = /(?:@|%40)/i;
+function isSensitiveSegment(seg2) {
+  return ID_SEGMENT.test(seg2) || EMAIL_SEGMENT.test(seg2);
+}
+function redactUrl(rawUrl) {
+  let path = rawUrl;
+  try {
+    path = new URL(rawUrl).pathname;
+  } catch {
+    const q = path.indexOf("?");
+    if (q >= 0) path = path.slice(0, q);
+  }
+  return path.split("/").map((seg2) => isSensitiveSegment(seg2) ? ":id" : seg2).join("/");
+}
+
 // src/request.ts
 var MUTATING = /* @__PURE__ */ new Set(["POST", "PUT", "PATCH", "DELETE"]);
+var PERF_EXCLUDED_PREFIX = "/v1/analytics/";
+function isSelfTraced(path) {
+  return path.startsWith(PERF_EXCLUDED_PREFIX);
+}
+function nowMs() {
+  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function isAbort(e) {
+  return e instanceof Error && e.name === "AbortError";
+}
 async function palbeRequest(rt, method, path, spec = {}) {
   const headers = { ...spec.headers };
   const callerHasKey = Object.keys(headers).some((k) => k.toLowerCase() === "idempotency-key");
   if (MUTATING.has(method) && !callerHasKey) {
     headers["Idempotency-Key"] = crypto.randomUUID();
   }
+  if (rt.appIdentifier !== "") {
+    const callerHasBundle = Object.keys(headers).some(
+      (k) => k.toLowerCase() === "x-palbase-bundle"
+    );
+    if (!callerHasBundle) headers["X-Palbase-Bundle"] = rt.appIdentifier;
+  }
   const attempt = async () => {
     try {
       return await rt.http.request(method, path, {
@@ -181,21 +214,38 @@ async function palbeRequest(rt, method, path, spec = {}) {
       throw pe ? fromPalbaseError(pe) : e;
     }
   };
-  let res = await attempt();
-  if (res.error?.status === 401 && rt.tokenManager.getRefreshToken() && rt.tokenManager.refreshFunction) {
-    try {
-      await rt.tokenManager.refreshSession();
-    } catch (refreshErr) {
-      const pe = asPalbaseError(refreshErr);
-      const status = pe?.status ?? 0;
-      if (status === 400 || status === 401 || status === 403) {
-        rt.tokenManager.clearSession();
-        throw fromPalbaseError(res.error);
+  const traced = !isSelfTraced(path) && rt.perf !== void 0;
+  const startedAt = traced ? nowMs() : 0;
+  let recorded = false;
+  const record = (status) => {
+    if (!traced || recorded) return;
+    recorded = true;
+    rt.perf.recordNetwork(method, redactUrl(path), status, nowMs() - startedAt);
+  };
+  let res;
+  try {
+    res = await attempt();
+    if (res.error?.status === 401 && rt.tokenManager.getRefreshToken() && rt.tokenManager.refreshFunction) {
+      try {
+        await rt.tokenManager.refreshSession();
+      } catch (refreshErr) {
+        const pe = asPalbaseError(refreshErr);
+        const status = pe?.status ?? 0;
+        if (status === 400 || status === 401 || status === 403) {
+          rt.tokenManager.clearSession();
+          record(res.error.status);
+          throw fromPalbaseError(res.error);
+        }
+        record(pe?.status ?? 0);
+        throw pe ? fromPalbaseError(pe) : refreshErr;
       }
-      throw pe ? fromPalbaseError(pe) : refreshErr;
+      res = await attempt();
     }
-    res = await attempt();
+  } catch (e) {
+    if (!isAbort(e)) record(asPalbaseError(e)?.status ?? 0);
+    throw e;
   }
+  record(res.error?.status ?? 200);
   return unwrap(res);
 }
 
@@ -1900,6 +1950,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`,
@@ -3478,6 +3532,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) {
@@ -3726,6 +3792,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
@@ -4164,7 +4255,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 });
         })
@@ -4204,6 +4295,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);
@@ -6361,6 +6486,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;
@@ -7419,7 +7557,7 @@ function localStorageSessionStorage(key = DEFAULT_KEY) {
 }
 
 // src/version.ts
-var VERSION = "1.6.2";
+var VERSION = "1.8.0";
 
 // src/internal.ts
 function getRuntime() {
@@ -7588,6 +7726,12 @@ function createClientProxy(resolveRt, nsAccessor) {
     },
     get messaging() {
       return resolveRt().messaging;
+    },
+    get perf() {
+      return resolveRt().perf;
+    },
+    setTestDevice(on) {
+      resolveRt().perf.setTestDevice(on);
     }
   };
   return new Proxy(base, {