@repzo/widget-react-native 1.2.0 → 1.2.2

package/lib/typescript/module/ui/components/VoiceNote.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A voice note (or any audio attachment) played inside the chat, laid out the
+ * way messaging apps do it: a play button beside a waveform the visitor can
+ * tap or drag to jump through the note, the time under it, and a speed chip
+ * once the note has been started. Only rendered when the host app has
+ * `expo-audio` (see `src/audio/voice.ts`); without it audio stays a file row.
+ */
+export interface VoiceNoteLabels {
+    play: string;
+    pause: string;
+    speed: string;
+}
+interface VoiceNoteProps {
+    url: string;
+    /** Keeps the made-up waveform the same for this note on every render. */
+    seed: string;
+    /** The workspace color. */
+    color: string;
+    /** In a visitor bubble, which is filled with `color`: the player turns white. */
+    onBrandBubble: boolean;
+    labels: VoiceNoteLabels;
+    /** The note can't be played (expired link, unsupported format). */
+    onError: () => void;
+}
+/**
+ * The player is only created once the visitor taps play. The whole thread
+ * renders at once, so a player per note would download every note in the
+ * conversation as soon as the chat opened.
+ */
+export declare function VoiceNote(props: VoiceNoteProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=VoiceNote.d.ts.map

package/lib/typescript/module/ui/components/VoiceNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceNote.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/VoiceNote.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,mEAAmE;IACnE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAUD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,+BAa9C"}

package/lib/typescript/module/ui/components/icons.d.ts

@@ -18,6 +18,10 @@ type ChevronDirection = 'left' | 'right' | 'up' | 'down';
 export declare function ChevronIcon({ size, color, direction, style, }: IconProps & {
     direction?: ChevronDirection;
 }): import("react").JSX.Element;
+/** A right-pointing triangle, drawn with borders — a voice note's play button. */
+export declare function PlayIcon({ size, color, style }: IconProps): import("react").JSX.Element;
+/** Two upright bars — a playing voice note's pause button. */
+export declare function PauseIcon({ size, color, style }: IconProps): import("react").JSX.Element;
 /** Arrow with a shaft — used for the "start a conversation" affordance. */
 export declare function ArrowRightIcon({ size, color, style }: IconProps): import("react").JSX.Element;
 /** Right-pointing triangle for the send button. */

package/lib/typescript/module/ui/components/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/icons.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIhE,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,wBAAwB;AACxB,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAcnF;AAED,KAAK,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AASzD,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,EAC1B,IAAS,EACT,KAAyB,EACzB,SAAkB,EAClB,KAAK,GACN,EAAE,SAAS,GAAG;IAAE,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAAE,+BAgB9C;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA2BxF;AAED,mDAAmD;AACnD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA2BjF;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA4B9E;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,EAAE,IAAS,EAAE,KAA0B,EAAE,KAAK,EAAE,EAAE,SAAS,+BA6B1F;AAED,oCAAoC;AACpC,wBAAgB,QAAQ,CAAC,EAAE,IAAS,EAAE,KAA0B,EAAE,KAAK,EAAE,EAAE,SAAS,+BA6BnF;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA8BhF;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,KAA2B,EAAE,KAAK,EAAE,EAAE,SAAS,+BA+BrF;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAgBvF;AASD,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAkCnF"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/icons.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIhE,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,wBAAwB;AACxB,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAcnF;AAED,KAAK,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AASzD,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,EAC1B,IAAS,EACT,KAAyB,EACzB,SAAkB,EAClB,KAAK,GACN,EAAE,SAAS,GAAG;IAAE,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAAE,+BAgB9C;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAmB9E;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAQ/E;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA2BxF;AAED,mDAAmD;AACnD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA2BjF;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA4B9E;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,EAAE,IAAS,EAAE,KAA0B,EAAE,KAAK,EAAE,EAAE,SAAS,+BA6B1F;AAED,oCAAoC;AACpC,wBAAgB,QAAQ,CAAC,EAAE,IAAS,EAAE,KAA0B,EAAE,KAAK,EAAE,EAAE,SAAS,+BA6BnF;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,EAAE,IAAS,EAAE,KAAqB,EAAE,KAAK,EAAE,EAAE,SAAS,+BA8BhF;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,KAA2B,EAAE,KAAK,EAAE,EAAE,SAAS,+BA+BrF;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAgBvF;AASD,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,KAAyB,EAAE,KAAK,EAAE,EAAE,SAAS,+BAkCnF"}

package/lib/typescript/module/ui/screens/chat/ChatView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatView.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/chat/ChatView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuDH,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,OAAO,EACP,eAAe,EACf,WAAW,EACX,KAAK,EACL,SAAS,EACT,WAAW,EACX,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,WAAgB,EAChB,cAAc,EACd,MAAM,EACN,WAAW,EACX,cAAc,EACd,MAAM,EACN,iBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,QAAQ,EACR,MAAM,EACN,OAAO,GACR,EAAE,aAAa,+BAuiBf"}
+{"version":3,"file":"ChatView.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/chat/ChatView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0DH,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,OAAO,EACP,eAAe,EACf,WAAW,EACX,KAAK,EACL,SAAS,EACT,WAAW,EACX,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,WAAgB,EAChB,cAAc,EACd,MAAM,EACN,WAAW,EACX,cAAc,EACd,MAAM,EACN,iBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,QAAQ,EACR,MAAM,EACN,OAAO,GACR,EAAE,aAAa,+BAuiBf"}

package/lib/typescript/module/ui/screens/chat/ChatView.styles.d.ts

@@ -207,15 +207,6 @@ export declare const styles: {
         height: number;
         borderRadius: 10;
     };
-    attachmentFile: {
-        borderWidth: number;
-        borderRadius: 10;
-        paddingHorizontal: number;
-        paddingVertical: number;
-    };
-    attachmentName: {
-        fontSize: 13;
-    };
     failedText: {
         fontSize: 12;
         marginTop: 4;

package/lib/typescript/module/ui/screens/chat/ChatView.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatView.styles.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/chat/ChatView.styles.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAOlF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmajB,CAAC"}
+{"version":3,"file":"ChatView.styles.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/chat/ChatView.styles.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAOlF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ZjB,CAAC"}

package/lib/typescript/module/ui/screens/chat/ChatView.types.d.ts

@@ -5,6 +5,7 @@ import type { AgentUiAction, AttachmentSource, ConversationRatingResult, Message
 import type { AgentUiBlockLabels } from '../../components/AgentUiBlocks';
 import type { ImageViewerLabels } from '../../components/ImageViewer';
 import type { RatingCardLabels } from '../../components/RatingCard';
+import type { VoiceNoteLabels } from '../../components/VoiceNote';
 export interface ChatLabels {
     back: string;
     loading: string;
@@ -41,6 +42,9 @@ export interface ChatLabels {
     rating: RatingCardLabels;
     attach: AttachLabels;
     viewer: ImageViewerLabels;
+    voice: VoiceNoteLabels;
+    /** Screen-reader label for a file card; keeps `{name}`. */
+    openAttachment: string;
 }
 /** Composer attachment copy. Limits are already filled in; `remove` keeps `{name}`. */
 export interface AttachLabels {

package/lib/typescript/module/ui/screens/chat/ChatView.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatView.types.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/chat/ChatView.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChatView.types.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/chat/ChatView.types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repzo/widget-react-native",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Repzo chat widget for React Native \u2014 pure JavaScript, no native modules",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",
@@ -53,6 +53,7 @@
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "*",
     "@react-native-firebase/messaging": "*",
+    "expo-audio": "*",
     "expo-crypto": "*",
     "expo-document-picker": "*",
     "expo-file-system": "*",
@@ -70,6 +71,9 @@
     "@react-native-firebase/messaging": {
       "optional": true
     },
+    "expo-audio": {
+      "optional": true
+    },
     "expo-crypto": {
       "optional": true
     },

package/src/api/client.ts

@@ -62,6 +62,16 @@ export class RepzoWidgetError extends Error {
   }
 }
 
+/** A Send message part asked for on its own, which may share one request with others. */
+type SendPart = 'post' | 'outbound';
+
+interface SendPartAsk {
+  part: SendPart;
+  own: () => Promise<unknown>;
+  resolve: (value: unknown) => void;
+  reject: (error: unknown) => void;
+}
+
 interface RequestOptions {
   method?: 'GET' | 'POST' | 'DELETE';
   body?: unknown;
@@ -92,6 +102,9 @@ export class WidgetApiClient {
   /** Set by the store: a 403 with a terminal `code` came back from any endpoint. */
   onTerminalError: ((error: RepzoWidgetError) => void) | null = null;
 
+  /** Send parts asked for in this tick — see askSendPart. */
+  private sendPartBatch: SendPartAsk[] | null = null;
+
   configure(baseUrl: string, channelAccountId: string) {
     this.baseUrl = baseUrl.replace(/\/$/, '');
     this.channelAccountId = channelAccountId;
@@ -194,7 +207,9 @@ export class WidgetApiClient {
   }
 
   getOutboundMessage(): Promise<{ message: OutboundMessage | null }> {
-    return this.request(`/api/widget/outbound/${encodeURIComponent(this.channelAccountId)}`);
+    return this.askSendPart('outbound', () =>
+      this.request(`/api/widget/outbound/${encodeURIComponent(this.channelAccountId)}`)
+    );
   }
 
   /**
@@ -202,7 +217,46 @@ export class WidgetApiClient {
    * `recheckInMs`: ask again after this long — the shown one stops then.
    */
   getPost(): Promise<{ post: WidgetPost | null; recheckInMs?: number | null }> {
-    return this.request('/api/widget/send/post?platform=mobile');
+    return this.askSendPart('post', () => this.request('/api/widget/send/post?platform=mobile'));
+  }
+
+  /**
+   * The post and the launcher's chat message are both asked for right after a
+   * session starts: asks made in the same tick go out as one request (each
+   * part answers the way its own endpoint does). A lone ask, a Workstation
+   * deployment that doesn't know a part yet (it leaves it out — the
+   * `outbound` part is newer than the combined endpoint), or a failed combined
+   * request falls back to each part's own endpoint, as before.
+   */
+  private askSendPart<T>(part: SendPart, own: () => Promise<T>): Promise<T> {
+    return new Promise<T>((resolve, reject) => {
+      if (!this.sendPartBatch) {
+        this.sendPartBatch = [];
+        setTimeout(() => void this.flushSendParts(), 0);
+      }
+      this.sendPartBatch.push({ part, own, resolve: resolve as (value: unknown) => void, reject });
+    });
+  }
+
+  private async flushSendParts(): Promise<void> {
+    const asks = this.sendPartBatch ?? [];
+    this.sendPartBatch = null;
+    const parts = Array.from(new Set(asks.map((ask) => ask.part)));
+    let answer: Record<string, unknown> | null = null;
+    if (parts.length > 1) {
+      try {
+        answer = await this.request<Record<string, unknown>>(
+          `/api/widget/send/messages?include=${parts.join(',')}&platform=mobile`
+        );
+      } catch {
+        answer = null;
+      }
+    }
+    for (const ask of asks) {
+      const value = answer?.[ask.part];
+      if (value && typeof value === 'object') ask.resolve(value);
+      else ask.own().then(ask.resolve, ask.reject);
+    }
   }
 
   /**
@@ -367,6 +421,11 @@ export class WidgetApiClient {
     return this.request('/api/widget/push-token', { method: 'POST', body: data });
   }
 
+  /** A Send push (`document_type: 'send_push'`) was tapped — counts as an open in Workstation. */
+  reportPushOpened(deliveryId: string): Promise<void> {
+    return this.request('/api/widget/push-opened', { method: 'POST', body: { deliveryId } });
+  }
+
   /** Logout passes the session's token explicitly and `skipReauth`. */
   removePushToken(
     token: string,

package/src/audio/voice.ts

@@ -0,0 +1,103 @@
+/**
+ * Voice notes (and any audio file) play inside the chat when the host app has
+ * `expo-audio`; without it they stay a file row that opens in the browser.
+ *
+ * Resolved once at module load, like the attachment pickers: each `require` is
+ * static so Metro can see it, and with `allowOptionalDependencies` (see
+ * metro.js) an uninstalled one bundles as a require that throws, which the
+ * `try` around it catches.
+ */
+
+let expoAudio: any = null;
+try {
+  const mod = require('expo-audio');
+  if (typeof mod?.useAudioPlayer === 'function' && typeof mod?.useAudioPlayerStatus === 'function') {
+    expoAudio = mod;
+  }
+} catch {
+  expoAudio = null;
+}
+
+// expo-audio 1.x (Expo SDK 54+) takes `{ updateInterval }`; 0.x (SDK 53) took
+// the interval itself. Passing the wrong shape would break the player.
+let takesOptionsObject = true;
+try {
+  const version: unknown = require('expo-audio/package.json')?.version;
+  if (typeof version === 'string') takesOptionsObject = Number(version.split('.')[0]) >= 1;
+} catch {
+  takesOptionsObject = true;
+}
+
+/** How often the playhead moves while a note plays. */
+const UPDATE_INTERVAL_MS = 100;
+
+/** The installed expo-audio module, or null when the app doesn't have it. */
+export function voicePlaybackModule(): any {
+  return expoAudio;
+}
+
+/** The second argument to `useAudioPlayer` for the installed expo-audio. */
+export function audioPlayerOptions(): unknown {
+  return takesOptionsObject ? { updateInterval: UPDATE_INTERVAL_MS } : UPDATE_INTERVAL_MS;
+}
+
+/** Audio the chat can play in place: an `audio/*` attachment with a web address. */
+export function isPlayableAudio(contentType: string | null | undefined, url: string | null | undefined): boolean {
+  return !!expoAudio && (contentType ?? '').toLowerCase().startsWith('audio/') && /^https?:\/\//i.test(url ?? '');
+}
+
+// ─── One note at a time ─────────────────────────────────────────────────────
+// Each bubble owns its own player, so starting a second note would otherwise
+// talk over the first.
+
+let playing: { pause: () => void } | null = null;
+
+/**
+ * Called as a note starts: pauses whichever note was playing and returns a
+ * release for this one's claim (call it when the note goes away).
+ */
+export function claimVoicePlayback(pause: () => void): () => void {
+  const claim = { pause };
+  const previous = playing;
+  playing = claim;
+  if (previous) {
+    try {
+      previous.pause();
+    } catch {
+      // Its player was released with its bubble: nothing is playing.
+    }
+  }
+  return () => {
+    if (playing === claim) playing = null;
+  };
+}
+
+// ─── Waveform ───────────────────────────────────────────────────────────────
+
+/**
+ * Bar heights (0.15–1) for a note's waveform. Workstation doesn't send the
+ * recorded loudness to visitors, so the pattern is made up — seeded from the
+ * attachment, so the same note always draws the same bars.
+ */
+export function voiceWaveformLevels(seed: string, count: number): number[] {
+  let h = 2166136261;
+  for (let i = 0; i < seed.length; i += 1) {
+    h ^= seed.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  const levels: number[] = [];
+  for (let i = 0; i < count; i += 1) {
+    h ^= h << 13;
+    h ^= h >>> 17;
+    h ^= h << 5;
+    const n = ((h >>> 0) % 1000) / 1000;
+    levels.push(0.15 + Math.pow(n, 0.85) * 0.85);
+  }
+  return levels;
+}
+
+/** `m:ss` for a playback position or length. */
+export function formatVoiceClock(seconds: number): string {
+  const s = Math.max(0, Math.floor(Number.isFinite(seconds) ? seconds : 0));
+  return `${Math.floor(s / 60)}:${(s % 60).toString().padStart(2, '0')}`;
+}

package/src/i18n.ts

@@ -70,6 +70,12 @@ export const DEFAULT_LABELS = {
   attachmentsTooLargeTogether:
     'Attachments are too large to send together — send some in another message',
   attachmentFailed: "Couldn't attach that file",
+  // A file in a message; tapping opens it. `{name}` is the file name.
+  openAttachment: 'Open {name}',
+  // Voice notes played in the chat (with expo-audio).
+  voicePlay: 'Play voice message',
+  voicePause: 'Pause voice message',
+  voiceSpeed: 'Playback speed',
   // Full-screen image viewer.
   imageLoadFailed: "Couldn't load this image",
   openImageExternally: 'Open image',

package/src/index.tsx

@@ -156,6 +156,17 @@ export type RepzoWidgetType = {
    * installed, `boot({ push: { enabled: true } })` handles everything).
    */
   setPushToken(options: { token: string; platform?: 'ios' | 'android'; bundleId?: string }): Promise<void>;
+
+  /**
+   * Hand over a tapped notification your app read itself (Firebase's
+   * `getInitialNotification` / `onNotificationOpenedApp`, or a notification
+   * you re-posted locally). Returns true when it's a Repzo Widget push — it
+   * opens (now, or once the session is ready) and your app should skip its
+   * own routing; false for your app's own pushes.
+   *
+   * @since 1.2.1
+   */
+  handlePushNotification(message: { messageId?: string; data?: Record<string, unknown> }): boolean;
 };
 
 const RepzoWidget: RepzoWidgetType = {
@@ -202,6 +213,8 @@ const RepzoWidget: RepzoWidgetType = {
   setSecureStorageAdapter: (adapter) => setSecureStorageAdapter(adapter),
 
   setPushToken: (options) => controller.store.push.setManualToken(options),
+
+  handlePushNotification: (message) => controller.store.push.handleNotification(message),
 };
 
 export default RepzoWidget;

package/src/locales.ts

@@ -29,6 +29,10 @@ const ar: LabelMap = {
   attachmentTooMany: 'يمكنك إرفاق {count} ملفات كحد أقصى',
   attachmentsTooLargeTogether: 'المرفقات كبيرة جدًا لإرسالها معًا — أرسل بعضها في رسالة أخرى',
   attachmentFailed: 'تعذر إرفاق هذا الملف',
+  openAttachment: 'فتح {name}',
+  voicePlay: 'تشغيل الرسالة الصوتية',
+  voicePause: 'إيقاف الرسالة الصوتية مؤقتًا',
+  voiceSpeed: 'سرعة التشغيل',
   imageLoadFailed: 'تعذر تحميل هذه الصورة',
   openImageExternally: 'فتح الصورة',
   cameraPermissionDenied: 'اسمح بالوصول إلى الكاميرا من الإعدادات لالتقاط صورة',

package/src/push/push-notifications.ts

@@ -15,6 +15,7 @@
 
 import { Platform } from 'react-native';
 import type { WidgetApiClient } from '../api/client';
+import { openExternalUrl } from '../ui/utils/safe-url';
 
 export interface WidgetPushOptions {
   /** Register this device for FCM pushes after every successful session init. */
@@ -90,6 +91,18 @@ function resolveMessaging(): MessagingHandle | null {
   }
 }
 
+const WIDGET_DOCUMENT_TYPES = new Set(['widget_message', 'send_post', 'send_push']);
+
+/** A push sent by Workstation for the widget (vs. one of the host app's own). */
+function isWidgetPush(data: any): data is Record<string, unknown> & { document_id: string } {
+  return (
+    !!data &&
+    WIDGET_DOCUMENT_TYPES.has(data.document_type) &&
+    typeof data.document_id === 'string' &&
+    !!data.document_id
+  );
+}
+
 export class PushManager {
   private options: WidgetPushOptions = {};
 
@@ -107,6 +120,12 @@ export class PushManager {
   /** Registrations still on the wire; unregister() waits for them. */
   private inflight = new Set<Promise<void>>();
 
+  /** Taps the host handed over before the session was ready; start() opens them. */
+  private pendingTaps: any[] = [];
+
+  /** The host and our own listener can both see one tap — open it once. */
+  private handledMessageIds = new Set<string>();
+
   constructor(
     private client: WidgetApiClient,
     private openConversation: (conversationId: string) => void,
@@ -125,6 +144,9 @@ export class PushManager {
    */
   async start(): Promise<void> {
     this.active = true;
+    const pending = this.pendingTaps;
+    this.pendingTaps = [];
+    pending.forEach((message) => this.handleTap(message));
     if (this.manualToken) {
       await this.register(this.manualToken);
     }
@@ -193,6 +215,8 @@ export class PushManager {
    */
   async unregister(authToken: string | null): Promise<void> {
     this.active = false;
+    // A tap held for this session must not open in the next user's.
+    this.pendingTaps = [];
     await Promise.all([...this.inflight]);
     const token = this.lastToken;
     this.lastToken = null;
@@ -228,29 +252,68 @@ export class PushManager {
   }
 
   private wireTapHandlers(messaging: MessagingHandle) {
+    // These listeners outlive logout, so taps go through the same session gate
+    // as host-forwarded ones: held until start(), and only marked handled then.
     // Background → tapped: the app was alive, just not in front.
     messaging.onNotificationOpenedApp((remoteMessage: any) => {
-      this.handleTap(remoteMessage);
+      this.handleNotification(remoteMessage);
     });
 
     // Killed → tapped: the click that launched the app.
     void messaging
       .getInitialNotification()
       .then((remoteMessage: any) => {
-        if (remoteMessage) this.handleTap(remoteMessage);
+        if (remoteMessage) this.handleNotification(remoteMessage);
       })
       .catch(() => {});
   }
 
+  /**
+   * A tap the host app read itself (`RepzoWidget.handlePushNotification`).
+   * Firebase hands out the notification that launched the app only once, so
+   * when the host reads it first our own listener gets nothing; the same goes
+   * for notifications the host re-posts locally while in the foreground.
+   * True when it's a widget push (so the host skips its own routing); it opens
+   * now, or once the session is ready.
+   */
+  handleNotification(message: any): boolean {
+    if (!isWidgetPush(message?.data)) return false;
+    if (this.active) this.handleTap(message);
+    else this.pendingTaps.push(message);
+    return true;
+  }
+
   /**
    * Only widget pushes are ours — host app notifications pass through. A team
-   * reply opens its conversation; a Send post opens the post.
+   * reply opens its conversation; a Send post opens the post; a Send mobile
+   * push reports the open and follows its link, if it has one.
    */
   private handleTap(remoteMessage: any) {
     const data = remoteMessage?.data;
-    const documentId = data?.document_id;
-    if (typeof documentId !== 'string' || !documentId) return;
+    if (!isWidgetPush(data)) return;
+    const messageId = remoteMessage?.messageId;
+    if (typeof messageId === 'string' && messageId) {
+      if (this.handledMessageIds.has(messageId)) return;
+      this.handledMessageIds.add(messageId);
+    }
+    const documentId = data.document_id;
     if (data?.document_type === 'widget_message') this.openConversation(documentId);
     else if (data?.document_type === 'send_post') this.openPost(documentId);
+    else if (data?.document_type === 'send_push') this.openSendPush(data);
+  }
+
+  /**
+   * The tap already opened the app. A link goes through the same gate as links
+   * in messages (`onOpenUrl` first, then web/mail/phone links), so the host can
+   * route `myapp://…` itself.
+   */
+  private openSendPush(data: Record<string, unknown>) {
+    const deliveryId = data.delivery_id;
+    if (typeof deliveryId === 'string' && deliveryId) {
+      this.client.reportPushOpened(deliveryId).catch(() => {
+        // Only the open count misses it; the visitor sees nothing.
+      });
+    }
+    if (typeof data.url === 'string' && data.url) void openExternalUrl(data.url);
   }
 }

package/src/state/use-widget-state.ts

@@ -4,7 +4,7 @@
  * component is mounted; this hook only subscribes to it.
  */
 
-import { useSyncExternalStore } from 'react';
+import { useRef, useSyncExternalStore } from 'react';
 
 import { controller } from '../controller';
 import type { WidgetState } from '../types';
@@ -18,3 +18,32 @@ export function useWidgetState(): WidgetState {
 export function useWidgetStore(): WidgetStore {
   return controller.store;
 }
+
+/**
+ * A slice of the state that re-renders only when the slice changes (by
+ * `isEqual`) — for UI that lives on the host's own screens, like the launcher,
+ * which shouldn't redraw on every message or typing event. Internal.
+ */
+export function useWidgetSelector<T>(
+  select: (state: WidgetState) => T,
+  isEqual: (previous: T, next: T) => boolean
+): T {
+  const store = controller.store;
+  const last = useRef<{ state: WidgetState; value: T } | null>(null);
+  const getSnapshot = () => {
+    const state = store.getState();
+    const previous = last.current;
+    if (previous && previous.state === state) return previous.value;
+    const value = select(state);
+    // Same slice from a newer state: keep the old value so React bails out.
+    last.current = { state, value: previous && isEqual(previous.value, value) ? previous.value : value };
+    return last.current.value;
+  };
+  return useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
+}
+
+/** Same keys, same values (by identity). */
+export function shallowEqual<T extends Record<string, unknown>>(previous: T, next: T): boolean {
+  const keys = Object.keys(previous);
+  return keys.length === Object.keys(next).length && keys.every((key) => Object.is(previous[key], next[key]));
+}

package/src/state/widget-store.ts

@@ -40,7 +40,7 @@ import type {
 import { setOpenUrlHandler } from '../ui/utils/safe-url';
 
 /** Sent on every init; must match `package.json` (tests/version.test.js checks). */
-const SDK_VERSION = '@repzo/widget-react-native@1.2.0';
+const SDK_VERSION = '@repzo/widget-react-native@1.2.2';
 
 /** The platform this session reports — mobile sessions get the Mobile SDKs overrides. */
 function sessionPlatform(): 'ios' | 'android' | 'web' {
@@ -67,6 +67,13 @@ const LOGOUT_REQUEST_TIMEOUT_MS = 5_000;
 const STREAM_REAUTH_MIN_INTERVAL_MS = 30_000;
 /** Live replies in the open thread advance the server read cursor, batched. */
 const MARK_READ_DEBOUNCE_MS = 1_000;
+/**
+ * Back from the background sooner than this, availability and the post are
+ * still current enough to skip re-asking. Reps hop to maps or the camera and
+ * back all day; the list and the open thread still catch up every time, since
+ * the stream was closed meanwhile.
+ */
+const FOREGROUND_REFRESH_AFTER_MS = 5 * 60_000;
 /** Live events held back while a draft's first send is creating its thread. */
 const DRAFT_EVENT_BUFFER_LIMIT = 50;
 /** How long a post stays up after a reaction, thanking them, before it goes. */
@@ -211,6 +218,9 @@ export class WidgetStore {
 
   private appStateSubscription: { remove(): void } | null = null;
 
+  /** When the app last went to the background (0: hasn't this session). */
+  private backgroundedAt = 0;
+
   private lastTypingPingAt = 0;
 
   private visitorTypingActive = false;
@@ -914,10 +924,14 @@ export class WidgetStore {
 
   private watchAppState() {
     if (this.appStateSubscription) return;
+    // Booted while already in the background (a push woke the app): coming
+    // to the foreground is a return from the background too.
+    if (AppState.currentState === 'background') this.backgroundedAt = Date.now();
     this.appStateSubscription = AppState.addEventListener('change', (status: AppStateStatus) => {
       if (status === 'active') {
         void this.resumeFromBackground();
       } else if (status === 'background') {
+        this.backgroundedAt = Date.now();
         this.realtime.close();
       }
     });
@@ -931,6 +945,12 @@ export class WidgetStore {
       if (this.state.error) await this.retry();
       return;
     }
+    // Only the background closes the stream. Back from merely inactive (a
+    // system sheet, Face ID, the notification shade) it never stopped, so
+    // there is nothing to catch up on.
+    if (!this.backgroundedAt) return;
+    const awayMs = Date.now() - this.backgroundedAt;
+    this.backgroundedAt = 0;
     const epoch = this.epoch;
     const token = await this.client.getToken();
     if (!token || this.isStale(epoch)) return;
@@ -938,6 +958,7 @@ export class WidgetStore {
     // The stream had a gap: refresh the list so unread/snippets are correct,
     // and the thread on screen so replies sent meanwhile show up.
     await Promise.all([this.refreshConversations(), this.refreshOpenThread()]);
+    if (awayMs < FOREGROUND_REFRESH_AFTER_MS) return;
     await this.refreshConfig();
     // A post may have gone live (or ended) while the app was away.
     if (!this.isStale(epoch)) this.loadPost();