@openclaw/crabline 0.1.11 → 0.1.13

package/dist/src/servers/whatsapp-baileys-websocket.d.ts

@@ -1,6 +1,7 @@
 import { Buffer } from "node:buffer";
 import type { Server } from "node:http";
 import { type KeyPair, type SignedKeyPair } from "./whatsapp-wire/crypto.js";
+import { type BinaryNode } from "./whatsapp-wire/binary-node.js";
 import type { ServerRequestEvent } from "./http.js";
 export declare const MAX_WHATSAPP_NOISE_FRAME_BYTES: number;
 export declare const MAX_WHATSAPP_WEBSOCKET_BUFFERED_BYTES: number;
@@ -10,7 +11,11 @@ export declare const MAX_WHATSAPP_NOISE_FRAMES_PER_MESSAGE = 1024;
 export declare const WHATSAPP_WEBSOCKET_SEND_TIMEOUT_MS = 5000;
 export declare const MAX_WHATSAPP_WEBSOCKET_FRAGMENTS = 1024;
 export declare const MAX_WHATSAPP_SIGNAL_BUNDLES = 1024;
+export declare const MAX_WHATSAPP_SIGNAL_PREKEYS_PER_BUNDLE = 32;
+export declare const MAX_WHATSAPP_SIGNAL_SESSIONS_PER_BUNDLE = 32;
 export declare const MAX_WHATSAPP_WEBSOCKET_CLOSE_REASON_BYTES = 123;
+export declare const WHATSAPP_MESSAGE_ACCEPTANCE_TIMEOUT_MS = 5000;
+export declare const WHATSAPP_SIGNAL_PREKEY_RESERVATION_TTL_MS: number;
 type NodeBuffer = Buffer<ArrayBufferLike>;
 type WhatsAppWebSocketRawData = NodeBuffer | ArrayBuffer | NodeBuffer[];
 type WhatsAppWebSocketSendTarget = {
@@ -28,6 +33,7 @@ export type WhatsAppBaileysWebSocketServerParams = {
     appendEvent(event: ServerRequestEvent): Promise<void>;
     httpServer: Server;
     maxPendingInboundMessages?: number | undefined;
+    messageAcceptanceTimeoutMs?: number | undefined;
     path: string;
     selfJid: string;
 };
@@ -56,12 +62,47 @@ export type MockSignalBundle = {
     registrationId: number;
     signedPreKey: SignedKeyPair;
 };
+export type WhatsAppSignalDecryptResult<T> = {
+    status: "accepted";
+    value: T;
+} | {
+    error: unknown;
+    status: "decrypt-failed";
+} | {
+    status: "unavailable";
+} | {
+    status: "rejected";
+};
+export type WhatsAppSignalBundleStoreOptions = {
+    maxPreKeysPerBundle?: number | undefined;
+    maxSessionsPerBundle?: number | undefined;
+    messageAcceptanceTimeoutMs?: number | undefined;
+    preKeyReservationTtlMs?: number | undefined;
+};
+type WhatsAppMessageAcceptanceOptions = {
+    onTerminalTimeout?: (() => void) | undefined;
+    signal?: AbortSignal | undefined;
+    terminalDrain?: (() => Promise<"acknowledged" | "persisted" | "retryable">) | undefined;
+    timeoutMs?: number | undefined;
+};
 export declare class WhatsAppSignalBundleStore {
     #private;
     private readonly maxBundles;
-    constructor(maxBundles?: number);
+    private readonly maxPendingAcknowledgements;
+    private readonly maxRecentAcknowledgements;
+    private readonly maxPendingAcknowledgementAgeMs;
+    private readonly now;
+    constructor(maxBundles?: number, maxPendingAcknowledgements?: number, maxRecentAcknowledgements?: number, maxPendingAcknowledgementAgeMs?: number, now?: () => number, options?: WhatsAppSignalBundleStoreOptions);
     get size(): number;
+    get lidMappingSize(): number;
+    get sessionCount(): number;
+    acceptMessageOnce(messageKey: string, operation: (signal: AbortSignal) => Promise<boolean>, options?: WhatsAppMessageAcceptanceOptions): Promise<boolean>;
+    markMessageAcknowledged(peerJid: string, messageId: string): void;
+    hasPersistedMessage(messageKey: string): boolean;
+    clearPersistedMessage(messageKey: string): void;
+    releaseMessagePreKeyProtection(messageKey: string): void;
     associateLid(phoneNumberJid: string, lidJid: string): void;
+    resolveAssociatedLid(phoneNumberJid: string): string | undefined;
     resolveMany(jids: string[]): MockSignalBundle[];
     decryptDirectMessage(params: {
         ciphertext: Uint8Array;
@@ -69,6 +110,15 @@ export declare class WhatsAppSignalBundleStore {
         remoteJid: string;
         type: "msg" | "pkmsg";
     }): Promise<Buffer | undefined>;
+    transactDirectMessage<T>(params: {
+        accept(plaintext: Buffer): Promise<T | undefined>;
+        ciphertext: Uint8Array;
+        messageKey?: string | undefined;
+        recipientJid: string;
+        remoteJid: string;
+        signal?: AbortSignal | undefined;
+        type: "msg" | "pkmsg";
+    }): Promise<WhatsAppSignalDecryptResult<T>>;
 }
 export declare function createSerializedMessageHandler<T>(processMessage: (message: T) => Promise<void>, onError: (error: unknown) => void, options?: {
     maxPendingBytes?: number | undefined;
@@ -87,5 +137,14 @@ export declare function resolveWhatsAppWebSocketClose(error: unknown): {
 };
 export declare function attachWhatsAppBaileysWebSocketServer(params: WhatsAppBaileysWebSocketServerParams): WhatsAppBaileysWebSocketServer;
 export declare function parseWhatsAppWebSocketUpgradeUrl(requestTarget: string | undefined): URL | undefined;
+export declare function persistAcceptedBaileysMessage(params: {
+    acceptanceSignal?: AbortSignal | undefined;
+    appendEvent(event: ServerRequestEvent): Promise<void>;
+    node: BinaryNode;
+    onAcceptanceTimeout?: (() => void) | undefined;
+    path: string;
+    remoteJid: string;
+    signalBundles: WhatsAppSignalBundleStore;
+}): Promise<boolean>;
 export declare function signalBundleIdentityKey(jid: string): string;
 export {};