@lazyneoaz/metachat 5.0.0 → 5.1.0

package/dist/index.d.mts

@@ -1128,6 +1128,12 @@ declare function startRecovery(ctx: any, runtime: RecoveryRuntime, options?: Rec
 declare const SILENT_WINDOW_MS: number;
 /** How long to wait for traffic after an active ping before declaring death. */
 declare const PING_GRACE_MS: number;
+interface RealtimeHealthOptions {
+    /** Silent window before a socket is considered suspect (default 30 min). */
+    silentWindowMs?: number;
+    /** Grace after a ping before the socket may be declared dead (default 60 s). */
+    pingGraceMs?: number;
+}
 interface RealtimeHealthState {
     /** Whether the transport currently reports itself connected. */
     connected: boolean;
@@ -1155,7 +1161,11 @@ declare class RealtimeHealth {
     private forcedReconnects;
     private lastPingAt;
     private startedAt;
-    constructor(now?: () => number);
+    private silentWindowMs;
+    private pingGraceMs;
+    /** Consecutive pings sent without any resulting frame. */
+    private silentPings;
+    constructor(now?: () => number, options?: RealtimeHealthOptions);
     /** Record any inbound frame (message, pong, anything from the broker). */
     noteFrame(): void;
     /** Record a successful connect. */
@@ -1169,8 +1179,8 @@ declare class RealtimeHealth {
      * Decide what to do about the current socket.
      *
      * - `disconnected` — the transport already knows it is down; reconnect.
-     * - `dead` — connected on paper, silent past the window, and a ping raised no
-     *   traffic within the grace period; reconnect.
+     * - `dead` — connected on paper, silent well past the window, and repeated
+     *   pings raised no traffic at all; reconnect.
      * - `suspect` — silent past the window but a ping was only just sent; wait.
      * - `quiet` — silent but inside the window; normal.
      * - `healthy` — recent traffic.
@@ -1182,7 +1192,7 @@ declare class RealtimeHealth {
     noteForcedReconnect(): void;
 }
 interface RealtimeSupervisorOptions {
-    /** How often to evaluate the socket. Jittered. Default 3 min. */
+    /** How often to evaluate the socket. Jittered. Default 10 min. */
     intervalMs?: number;
     /** Ask the transport to reconnect (fresh socket) — must be idempotent. */
     reconnect: (reason: string) => void;
@@ -1192,6 +1202,11 @@ interface RealtimeSupervisorOptions {
     isConnected: () => boolean;
     /** Observe verdict changes (logging). */
     onVerdict?: (state: RealtimeHealthState) => void;
+    /** Silent window / ping grace overrides. */
+    silentWindowMs?: number;
+    pingGraceMs?: number;
+    /** Use an existing health tracker instead of creating a private one. */
+    health?: RealtimeHealth;
 }
 /**
  * A lightweight supervisor that keeps ONE realtime socket honest: it pings a
@@ -1235,6 +1250,36 @@ interface AcquireResult {
  */
 declare function acquireCookies(jar: any, credentials: LoginCredentials$1, globalOptions: LoginOptions$1): Promise<AcquireResult>;
 
+interface UploadedAttachment {
+    [key: string]: any;
+}
+declare function cleanJsonResponse(value: any): any;
+declare function uploadMercuryAttachment(ctx: any, defaultFuncs: any, attachment: any): Promise<UploadedAttachment>;
+/**
+ * Upload a single image for use as a group/thread image. Uses the Mercury
+ * `images_only=true` endpoint so Facebook returns an `image_id`.
+ */
+declare function uploadGroupImage(ctx: any, defaultFuncs: any, image: any): Promise<any>;
+
+/**
+ * Shared reaction validation for every surface that sends a reaction.
+ * Facebook accepts any single emoji; a whitelist silently rejects valid picks.
+ */
+declare const CORE_REACTIONS: string[];
+declare const REACTION_ALIASES: Record<string, string>;
+declare function isReactionEmoji(value: unknown): boolean;
+declare function normalizeReaction(value: unknown, options?: {
+    allowRemove?: boolean;
+    forceCustom?: boolean;
+}): string;
+
+/**
+ * Facebook "non-critical" errors (e.g. 1357004) are retryable and must not be
+ * treated as auth failures or checkpoints.
+ */
+declare function isNonCriticalError(value: any): boolean;
+declare function retryOnNonCritical<T = any>(operation: () => Promise<T>, refresh: () => void | Promise<void>): Promise<T>;
+
 type ApiContext = ApiContext$1;
 type ApiInternal = Api;
 type DefaultFuncs = DefaultFuncs$1;
@@ -1245,4 +1290,4 @@ declare const _default: typeof login$1 & {
     default: typeof login$1;
 };
 
-export { type API, type AddedStickerPackInfo, type AiTheme, type AnyAttachment, type ApiContext, type ApiInternal, type Attachment, type AudioAttachment, type BrowserProfile, type Callback, type CommentMessage, type CommentResult, type Coordinates, type DefaultFuncs, type EmojiEvent, type Event, type FileAttachment, type GroupNameEvent, type ListenEvent, type LivenessHandle, type LivenessState, type LoginCredentials, type LoginOptions, type Mention, type Message, type MessageID, type MessageObject, type MessageReply, type MusicTag, type MusicTrack, type NicknameEvent, PING_GRACE_MS, type PhotoAttachment, type Reaction, RealtimeHealth, type RealtimeHealthState, type RecoveryEvent, type RecoveryOptions, type RecoveryRuntime, type RecoveryState, RecoverySupervisor, SILENT_WINDOW_MS, type SearchMusicOptions, type SearchMusicResult, type ShareAttachment, type ShareResult, type StickerAttachment, type StickerInfo, type StickerPackInfo, type ThreadID, type ThreadInfo, type ThreadThemeEvent, type TypingIndicator, type UnsendMessageEvent, type UserID, type UserInfo, type VideoAttachment, type WarmUpResult, acquireCookies, applySetCookie, awaitProactiveSlot, canActProactively, collectSessionCookies, _default as default, defaultBrowserProfile, ensureCometTokens, extractCookies, extractCookiesFromBody, extractCookiesFromJar, extractCookiesFromSetCookie, extractCurrentUser, getFingerprintParams, getHeaders, getWebSocketHeaders, hasAuthenticatedSession, humanDelay, invalidateCometTokens, isAuthFailure, isBreakerOpen, isLoggedOutDocument, isStaleTokenError, login$1 as login, missingSessionCookies, normalizeBrowserProfile, noteAction, noteAuthFailure, noteCheckpoint, noteRateLimit, paceRequest, publicTypes, randomUserAgent, refreshSessionCookies, repairSession, reserveRequest, resetBreaker, resolveProfile, retryDelay, safetySnapshot, sleep, startLiveness, startRealtimeSupervisor, startRecovery, tripBreaker, warmUpSession, withCometTokens, withSessionRetry };
+export { type API, type AddedStickerPackInfo, type AiTheme, type AnyAttachment, type ApiContext, type ApiInternal, type Attachment, type AudioAttachment, type BrowserProfile, CORE_REACTIONS, type Callback, type CommentMessage, type CommentResult, type Coordinates, type DefaultFuncs, type EmojiEvent, type Event, type FileAttachment, type GroupNameEvent, type ListenEvent, type LivenessHandle, type LivenessState, type LoginCredentials, type LoginOptions, type Mention, type Message, type MessageID, type MessageObject, type MessageReply, type MusicTag, type MusicTrack, type NicknameEvent, PING_GRACE_MS, type PhotoAttachment, REACTION_ALIASES, type Reaction, RealtimeHealth, type RealtimeHealthState, type RecoveryEvent, type RecoveryOptions, type RecoveryRuntime, type RecoveryState, RecoverySupervisor, SILENT_WINDOW_MS, type SearchMusicOptions, type SearchMusicResult, type ShareAttachment, type ShareResult, type StickerAttachment, type StickerInfo, type StickerPackInfo, type ThreadID, type ThreadInfo, type ThreadThemeEvent, type TypingIndicator, type UnsendMessageEvent, type UserID, type UserInfo, type VideoAttachment, type WarmUpResult, acquireCookies, applySetCookie, awaitProactiveSlot, canActProactively, cleanJsonResponse, collectSessionCookies, _default as default, defaultBrowserProfile, ensureCometTokens, extractCookies, extractCookiesFromBody, extractCookiesFromJar, extractCookiesFromSetCookie, extractCurrentUser, getFingerprintParams, getHeaders, getWebSocketHeaders, hasAuthenticatedSession, humanDelay, invalidateCometTokens, isAuthFailure, isBreakerOpen, isLoggedOutDocument, isNonCriticalError, isReactionEmoji, isStaleTokenError, login$1 as login, missingSessionCookies, normalizeBrowserProfile, normalizeReaction, noteAction, noteAuthFailure, noteCheckpoint, noteRateLimit, paceRequest, publicTypes, randomUserAgent, refreshSessionCookies, repairSession, reserveRequest, resetBreaker, resolveProfile, retryDelay, retryOnNonCritical, safetySnapshot, sleep, startLiveness, startRealtimeSupervisor, startRecovery, tripBreaker, uploadGroupImage, uploadMercuryAttachment, warmUpSession, withCometTokens, withSessionRetry };

package/dist/index.d.ts

@@ -1128,6 +1128,12 @@ declare function startRecovery(ctx: any, runtime: RecoveryRuntime, options?: Rec
 declare const SILENT_WINDOW_MS: number;
 /** How long to wait for traffic after an active ping before declaring death. */
 declare const PING_GRACE_MS: number;
+interface RealtimeHealthOptions {
+    /** Silent window before a socket is considered suspect (default 30 min). */
+    silentWindowMs?: number;
+    /** Grace after a ping before the socket may be declared dead (default 60 s). */
+    pingGraceMs?: number;
+}
 interface RealtimeHealthState {
     /** Whether the transport currently reports itself connected. */
     connected: boolean;
@@ -1155,7 +1161,11 @@ declare class RealtimeHealth {
     private forcedReconnects;
     private lastPingAt;
     private startedAt;
-    constructor(now?: () => number);
+    private silentWindowMs;
+    private pingGraceMs;
+    /** Consecutive pings sent without any resulting frame. */
+    private silentPings;
+    constructor(now?: () => number, options?: RealtimeHealthOptions);
     /** Record any inbound frame (message, pong, anything from the broker). */
     noteFrame(): void;
     /** Record a successful connect. */
@@ -1169,8 +1179,8 @@ declare class RealtimeHealth {
      * Decide what to do about the current socket.
      *
      * - `disconnected` — the transport already knows it is down; reconnect.
-     * - `dead` — connected on paper, silent past the window, and a ping raised no
-     *   traffic within the grace period; reconnect.
+     * - `dead` — connected on paper, silent well past the window, and repeated
+     *   pings raised no traffic at all; reconnect.
      * - `suspect` — silent past the window but a ping was only just sent; wait.
      * - `quiet` — silent but inside the window; normal.
      * - `healthy` — recent traffic.
@@ -1182,7 +1192,7 @@ declare class RealtimeHealth {
     noteForcedReconnect(): void;
 }
 interface RealtimeSupervisorOptions {
-    /** How often to evaluate the socket. Jittered. Default 3 min. */
+    /** How often to evaluate the socket. Jittered. Default 10 min. */
     intervalMs?: number;
     /** Ask the transport to reconnect (fresh socket) — must be idempotent. */
     reconnect: (reason: string) => void;
@@ -1192,6 +1202,11 @@ interface RealtimeSupervisorOptions {
     isConnected: () => boolean;
     /** Observe verdict changes (logging). */
     onVerdict?: (state: RealtimeHealthState) => void;
+    /** Silent window / ping grace overrides. */
+    silentWindowMs?: number;
+    pingGraceMs?: number;
+    /** Use an existing health tracker instead of creating a private one. */
+    health?: RealtimeHealth;
 }
 /**
  * A lightweight supervisor that keeps ONE realtime socket honest: it pings a
@@ -1235,6 +1250,36 @@ interface AcquireResult {
  */
 declare function acquireCookies(jar: any, credentials: LoginCredentials$1, globalOptions: LoginOptions$1): Promise<AcquireResult>;
 
+interface UploadedAttachment {
+    [key: string]: any;
+}
+declare function cleanJsonResponse(value: any): any;
+declare function uploadMercuryAttachment(ctx: any, defaultFuncs: any, attachment: any): Promise<UploadedAttachment>;
+/**
+ * Upload a single image for use as a group/thread image. Uses the Mercury
+ * `images_only=true` endpoint so Facebook returns an `image_id`.
+ */
+declare function uploadGroupImage(ctx: any, defaultFuncs: any, image: any): Promise<any>;
+
+/**
+ * Shared reaction validation for every surface that sends a reaction.
+ * Facebook accepts any single emoji; a whitelist silently rejects valid picks.
+ */
+declare const CORE_REACTIONS: string[];
+declare const REACTION_ALIASES: Record<string, string>;
+declare function isReactionEmoji(value: unknown): boolean;
+declare function normalizeReaction(value: unknown, options?: {
+    allowRemove?: boolean;
+    forceCustom?: boolean;
+}): string;
+
+/**
+ * Facebook "non-critical" errors (e.g. 1357004) are retryable and must not be
+ * treated as auth failures or checkpoints.
+ */
+declare function isNonCriticalError(value: any): boolean;
+declare function retryOnNonCritical<T = any>(operation: () => Promise<T>, refresh: () => void | Promise<void>): Promise<T>;
+
 type ApiContext = ApiContext$1;
 type ApiInternal = Api;
 type DefaultFuncs = DefaultFuncs$1;
@@ -1245,4 +1290,4 @@ declare const _default: typeof login$1 & {
     default: typeof login$1;
 };
 
-export { type API, type AddedStickerPackInfo, type AiTheme, type AnyAttachment, type ApiContext, type ApiInternal, type Attachment, type AudioAttachment, type BrowserProfile, type Callback, type CommentMessage, type CommentResult, type Coordinates, type DefaultFuncs, type EmojiEvent, type Event, type FileAttachment, type GroupNameEvent, type ListenEvent, type LivenessHandle, type LivenessState, type LoginCredentials, type LoginOptions, type Mention, type Message, type MessageID, type MessageObject, type MessageReply, type MusicTag, type MusicTrack, type NicknameEvent, PING_GRACE_MS, type PhotoAttachment, type Reaction, RealtimeHealth, type RealtimeHealthState, type RecoveryEvent, type RecoveryOptions, type RecoveryRuntime, type RecoveryState, RecoverySupervisor, SILENT_WINDOW_MS, type SearchMusicOptions, type SearchMusicResult, type ShareAttachment, type ShareResult, type StickerAttachment, type StickerInfo, type StickerPackInfo, type ThreadID, type ThreadInfo, type ThreadThemeEvent, type TypingIndicator, type UnsendMessageEvent, type UserID, type UserInfo, type VideoAttachment, type WarmUpResult, acquireCookies, applySetCookie, awaitProactiveSlot, canActProactively, collectSessionCookies, _default as default, defaultBrowserProfile, ensureCometTokens, extractCookies, extractCookiesFromBody, extractCookiesFromJar, extractCookiesFromSetCookie, extractCurrentUser, getFingerprintParams, getHeaders, getWebSocketHeaders, hasAuthenticatedSession, humanDelay, invalidateCometTokens, isAuthFailure, isBreakerOpen, isLoggedOutDocument, isStaleTokenError, login$1 as login, missingSessionCookies, normalizeBrowserProfile, noteAction, noteAuthFailure, noteCheckpoint, noteRateLimit, paceRequest, publicTypes, randomUserAgent, refreshSessionCookies, repairSession, reserveRequest, resetBreaker, resolveProfile, retryDelay, safetySnapshot, sleep, startLiveness, startRealtimeSupervisor, startRecovery, tripBreaker, warmUpSession, withCometTokens, withSessionRetry };
+export { type API, type AddedStickerPackInfo, type AiTheme, type AnyAttachment, type ApiContext, type ApiInternal, type Attachment, type AudioAttachment, type BrowserProfile, CORE_REACTIONS, type Callback, type CommentMessage, type CommentResult, type Coordinates, type DefaultFuncs, type EmojiEvent, type Event, type FileAttachment, type GroupNameEvent, type ListenEvent, type LivenessHandle, type LivenessState, type LoginCredentials, type LoginOptions, type Mention, type Message, type MessageID, type MessageObject, type MessageReply, type MusicTag, type MusicTrack, type NicknameEvent, PING_GRACE_MS, type PhotoAttachment, REACTION_ALIASES, type Reaction, RealtimeHealth, type RealtimeHealthState, type RecoveryEvent, type RecoveryOptions, type RecoveryRuntime, type RecoveryState, RecoverySupervisor, SILENT_WINDOW_MS, type SearchMusicOptions, type SearchMusicResult, type ShareAttachment, type ShareResult, type StickerAttachment, type StickerInfo, type StickerPackInfo, type ThreadID, type ThreadInfo, type ThreadThemeEvent, type TypingIndicator, type UnsendMessageEvent, type UserID, type UserInfo, type VideoAttachment, type WarmUpResult, acquireCookies, applySetCookie, awaitProactiveSlot, canActProactively, cleanJsonResponse, collectSessionCookies, _default as default, defaultBrowserProfile, ensureCometTokens, extractCookies, extractCookiesFromBody, extractCookiesFromJar, extractCookiesFromSetCookie, extractCurrentUser, getFingerprintParams, getHeaders, getWebSocketHeaders, hasAuthenticatedSession, humanDelay, invalidateCometTokens, isAuthFailure, isBreakerOpen, isLoggedOutDocument, isNonCriticalError, isReactionEmoji, isStaleTokenError, login$1 as login, missingSessionCookies, normalizeBrowserProfile, normalizeReaction, noteAction, noteAuthFailure, noteCheckpoint, noteRateLimit, paceRequest, publicTypes, randomUserAgent, refreshSessionCookies, repairSession, reserveRequest, resetBreaker, resolveProfile, retryDelay, retryOnNonCritical, safetySnapshot, sleep, startLiveness, startRealtimeSupervisor, startRecovery, tripBreaker, uploadGroupImage, uploadMercuryAttachment, warmUpSession, withCometTokens, withSessionRetry };