ajaxter-chat 3.0.15 → 3.0.17

package/src/types/index.ts

@@ -59,6 +59,16 @@ export interface WidgetConfig {
    * @example https://api.example.com/widgets/reenable-request
    */
   reenableRequestUrl?: string;
+  /**
+   * Current presence from your API/DB (include in chatData or a session payload).
+   * When set, it initializes the status control and overrides session-only cache.
+   */
+  presenceStatus?: PresenceStatus;
+  /**
+   * Production: `POST` JSON `{ widgetId, apiKey, viewerUid?, status }` to save presence in your database.
+   * The client still mirrors to sessionStorage as a local fallback.
+   */
+  presenceUpdateUrl?: string;
 }
 
 export interface RemoteChatData {
@@ -89,6 +99,9 @@ export type Screen       =
 export type UserListContext = 'support' | 'conversation';
 export type MessageType = 'text' | 'voice' | 'attachment' | 'emoji';
 
+/** Home status selector; persist via `presenceUpdateUrl` in production */
+export type PresenceStatus = 'ACTIVE' | 'AWAY' | 'DND';
+
 // ─── User ───────────────────────────────────────────────────────────────────
 export interface ChatUser {
   uid: string;

package/src/utils/presenceStatus.ts

@@ -0,0 +1,56 @@
+import type { PresenceStatus } from '../types';
+
+const key = (widgetId: string) => `ajaxter_presence_${widgetId}`;
+
+export function loadPresenceStatus(widgetId: string): PresenceStatus {
+  if (typeof sessionStorage === 'undefined') return 'ACTIVE';
+  try {
+    const v = sessionStorage.getItem(key(widgetId));
+    if (v === 'ACTIVE' || v === 'AWAY' || v === 'DND') return v;
+  } catch {
+    /* */
+  }
+  return 'ACTIVE';
+}
+
+export function savePresenceStatus(widgetId: string, status: PresenceStatus): void {
+  try {
+    sessionStorage.setItem(key(widgetId), status);
+  } catch {
+    /* quota */
+  }
+}
+
+/** Prefer server value from DB when the host includes it in config */
+export function resolveInitialPresence(
+  widgetId: string,
+  serverStatus: PresenceStatus | undefined,
+): PresenceStatus {
+  if (serverStatus === 'ACTIVE' || serverStatus === 'AWAY' || serverStatus === 'DND') return serverStatus;
+  return loadPresenceStatus(widgetId);
+}
+
+export interface PresenceSyncPayload {
+  widgetId: string;
+  apiKey: string;
+  viewerUid?: string;
+  status: PresenceStatus;
+}
+
+/** Call your backend to persist presence (production DB). */
+export async function syncPresenceToServer(url: string, payload: PresenceSyncPayload): Promise<void> {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      Accept: 'application/json',
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(payload),
+    mode: 'cors',
+    credentials: 'omit',
+  });
+  if (!res.ok) {
+    const t = await res.text().catch(() => '');
+    throw new Error(t || `Presence sync failed (${res.status})`);
+  }
+}