@linktr.ee/messaging-react 4.2.0-rc-1787325710 → 4.2.0

package/dist/index.d.ts

@@ -13,6 +13,7 @@ import { FC } from 'react';
 import { InfiniteScrollProps } from 'stream-chat-react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { LocalMessage } from 'stream-chat';
+import { Logger } from '@linktr.ee/messaging-core';
 import { MessageCustomType } from '@linktr.ee/messaging-taxonomy';
 import { MessagingUser } from '@linktr.ee/messaging-core';
 import { OfficialCtaActionKind } from '@linktr.ee/messaging-taxonomy';
@@ -872,6 +873,8 @@ export declare interface LockedAttachmentSource {
     thumbnailUrl?: string;
 }
 
+export { Logger }
+
 declare interface MediaCardBaseProps {
     /** Attachment title. */
     title?: string;
@@ -1442,6 +1445,16 @@ declare interface MessagingContextValue {
     debug: boolean;
 }
 
+/**
+ * Provides the resolved logger sink to the messaging subtree. Rendered by
+ * `MessagingProvider`; usable standalone in tests or in a subtree that needs a
+ * different sink.
+ */
+export declare const MessagingLoggerProvider: default_2.FC<{
+    logger?: Logger;
+    children: default_2.ReactNode;
+}>;
+
 /**
  * Provider component that wraps messaging-core with React state management
  */
@@ -1463,6 +1476,13 @@ declare interface MessagingProviderBaseProps {
     user: MessagingUser | null;
     capabilities?: MessagingCapabilities;
     debug?: boolean;
+    /**
+     * Optional sink for the package's own log output. Levels left undefined fall
+     * back to console, which is also the default when the prop is omitted. In
+     * apiKey mode it is forwarded to the underlying StreamChatService unless
+     * `serviceConfig.logger` is set, which wins.
+     */
+    logger?: Logger;
 }
 
 /**
@@ -1825,6 +1845,12 @@ export declare function useCustomMessage<K extends keyof CustomMessageRegistry>(
  */
 export declare const useMessaging: () => MessagingContextValue;
 
+/**
+ * The logger sink for the current subtree. Falls back to console when no
+ * provider (or no `logger` prop) is present, so call sites never branch.
+ */
+export declare const useMessagingLogger: () => Required<Logger>;
+
 declare interface VideoAttachmentSharedProps extends MessageAttachmentBaseProps {
     /** Single video — convenience for the most common case. */
     src?: string;