@ethora/chat-component 26.2.9 → 26.2.11

package/README.md

@@ -108,6 +108,36 @@ export default function App() {
 }
 ```
 
+`XmppProvider` also accepts a `pushNotifications` prop for headless push setup (works even if `Chat` is not rendered yet):
+
+```tsx
+import { XmppProvider } from '@ethora/chat-component';
+
+export default function App() {
+  return (
+    <XmppProvider
+      config={{ baseUrl: 'https://api.ethoradev.com/v1', initBeforeLoad: true }}
+      pushNotifications={{
+        enabled: true,
+        softAsk: false,
+        vapidPublicKey: 'PLACEHOLDER_VAPID_PUBLIC_KEY',
+        firebaseConfig: {
+          apiKey: 'PLACEHOLDER_API_KEY',
+          authDomain: 'PLACEHOLDER_AUTH_DOMAIN',
+          projectId: 'PLACEHOLDER_PROJECT_ID',
+          storageBucket: 'PLACEHOLDER_STORAGE_BUCKET',
+          messagingSenderId: 'PLACEHOLDER_MESSAGING_SENDER_ID',
+          appId: 'PLACEHOLDER_APP_ID',
+        },
+      }}
+    >
+      {/* Chat can be mounted later or omitted */}
+      <div>App shell</div>
+    </XmppProvider>
+  );
+}
+```
+
 ### 3. Run
 
 ```bash

package/dist/context/xmppProvider.d.ts

@@ -11,6 +11,7 @@ interface XmppContextType {
 interface XmppProviderProps {
     children: ReactNode;
     config?: IConfig;
+    pushNotifications?: IConfig['pushNotifications'];
 }
 export declare const XmppProvider: React.FC<XmppProviderProps>;
 export declare const useXmppClient: () => XmppContextType;

package/dist/helpers/ethoraLogger.d.ts

@@ -2,5 +2,6 @@ export declare const ethoraLogger: {
     log: (...args: unknown[]) => void;
     info: (...args: unknown[]) => void;
     debug: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
     always: (...args: unknown[]) => void;
 };

package/dist/hooks/usePushNotifications.d.ts

@@ -36,6 +36,21 @@ interface UsePushNotificationsOptions {
      * Default: false (immediate request after login).
      */
     softAsk?: boolean;
+    /**
+     * Optional push click handler. When provided, has priority over
+     * config.pushNotifications.onClick from Redux config.
+     */
+    onClick?: (params: {
+        roomJID?: string;
+        messageId?: string;
+        url?: string;
+        data?: Record<string, any>;
+        notification?: {
+            title?: string;
+            body?: string;
+        };
+        source?: 'service_worker' | 'foreground';
+    }) => void | Promise<void>;
 }
 interface UsePushNotificationsResult {
     /** Manually trigger the permission + subscription flow (for soft-ask UIs). */