@xmtp/browser-sdk 6.4.1 → 7.0.0-dev.57a7203

package/README.md

@@ -57,6 +57,23 @@ pnpm install @xmtp/browser-sdk
 yarn add @xmtp/browser-sdk
 ```
 
+## Signer utilities
+
+The SDK exports `createEOASigner` and `createSCWSigner` helper functions for creating XMTP-compatible signers. These require `viem` as a peer dependency, which is optional and only needs to be installed if you use these utilities.
+
+```bash
+npm install viem
+```
+
+**Example**
+
+```ts
+import { createEOASigner } from "@xmtp/browser-sdk";
+
+// Create an EOA signer (generates a random key if none provided)
+const eoaSigner = createEOASigner();
+```
+
 ## Developing
 
 Run `yarn dev` to build the SDK and watch for changes, which will trigger a rebuild.

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _xmtp_wasm_bindings from '@xmtp/wasm-bindings';
-import { ContentTypeId as ContentTypeId$1, DeliveryStatus, GroupMessageKind, Reaction, DecodedMessage as DecodedMessage$1, LeaveRequest, ReadReceipt, Attachment, RemoteAttachment, TransactionReference, WalletSendCalls, Actions, Intent, MultiRemoteAttachment, GroupUpdated, DeletedMessage, Backend, LogLevel, Identifier, Conversations as Conversations$1, ConsentState, ListConversationsOptions, CreateGroupOptions, CreateDmOptions, Conversation as Conversation$1, ConversationType, Message, Client as Client$1, Consent, ConsentEntityType, UserPreferenceUpdate, SignatureRequestHandle, KeyPackageStatus, ArchiveOptions, GroupMember, PermissionUpdateType, PermissionPolicy, MetadataField, EncodedContent, SendMessageOpts, Reply, ListMessagesOptions, MessageDisappearingSettings, HmacKey, ConversationDebugInfo, GroupPermissionsOptions, PermissionPolicySet, GroupMetadata, ApiStats, IdentityStats, InboxState, GroupSyncSummary } from '@xmtp/wasm-bindings';
-export { Action, ActionStyle, Actions, ApiStats, ArchiveOptions, Attachment, Backend, BackendBuilder, BackupElementSelectionOption, Consent, ConsentEntityType, ConsentState, ContentType, ConversationDebugInfo, ConversationListItem, ConversationType, CreateDmOptions, CreateGroupOptions, Cursor, DeliveryStatus, EncryptedAttachment, GroupMember, GroupMembershipState, GroupMessageKind, GroupMetadata, GroupPermissions, GroupPermissionsOptions, GroupSyncSummary, GroupUpdated, HmacKey, Identifier, IdentifierKind, IdentityStats, Inbox, InboxState, Installation, Intent, KeyPackageStatus, LeaveRequest, Lifetime, ListConversationsOptions, ListConversationsOrderBy, ListMessagesOptions, LogLevel, LogOptions, Message, MessageDisappearingSettings, MessageSortBy, MetadataField, MetadataFieldChange, MultiRemoteAttachment, PermissionLevel, PermissionPolicy, PermissionPolicySet, PermissionUpdateType, Reaction, ReactionAction, ReactionSchema, ReadReceipt, RemoteAttachment, Reply, SendMessageOpts, SignatureRequestHandle, SortDirection, TransactionMetadata, TransactionReference, UserPreferenceUpdate, WalletCall, WalletSendCalls } from '@xmtp/wasm-bindings';
+import { ContentTypeId as ContentTypeId$1, DeliveryStatus, GroupMessageKind, Reaction, DecodedMessage as DecodedMessage$1, LeaveRequest, ReadReceipt, Attachment, RemoteAttachment, TransactionReference, WalletSendCalls, Actions, Intent, MultiRemoteAttachment, GroupUpdated, DeletedMessage, Backend, LogLevel, WorkerConfigOptions, WasmVisibilityConfirmationOptions, Identifier, Conversations as Conversations$1, ConsentState, ListConversationsOptions, CreateGroupOptions, CreateDmOptions, Conversation as Conversation$1, ConversationType, Message, Client as Client$1, Consent, ConsentEntityType, UserPreferenceUpdate, SignatureRequestHandle, KeyPackageStatus, ArchiveOptions, AvailableArchiveInfo, ArchiveMetadata, GroupSyncSummary, GroupMember, PermissionUpdateType, PermissionPolicy, MetadataField, EncodedContent, SendMessageOpts, SendOpts, Reply, ListMessagesOptions, MessageDisappearingSettings, HmacKey, ConversationDebugInfo, GroupPermissionsOptions, PermissionPolicySet, GroupMetadata, ApiStats, IdentityStats, InboxState } from '@xmtp/wasm-bindings';
+export { Action, ActionStyle, Actions, ApiStats, ArchiveMetadata, ArchiveOptions, Attachment, AvailableArchiveInfo, Backend, BackendBuilder, BackupElementSelectionOption, Consent, ConsentEntityType, ConsentState, ContentType, ConversationDebugInfo, ConversationListItem, ConversationType, CreateDmOptions, CreateGroupOptions, Cursor, DeliveryStatus, EncryptedAttachment, GroupMember, GroupMembershipState, GroupMessageKind, GroupMetadata, GroupPermissions, GroupPermissionsOptions, GroupSyncSummary, GroupUpdated, HmacKey, Identifier, IdentifierKind, IdentityStats, Inbox, InboxState, Installation, Intent, KeyPackageStatus, LeaveRequest, Lifetime, ListConversationsOptions, ListConversationsOrderBy, ListMessagesOptions, LogLevel, LogOptions, Message, MessageDisappearingSettings, MessageSortBy, MetadataField, MetadataFieldChange, MultiRemoteAttachment, PermissionLevel, PermissionPolicy, PermissionPolicySet, PermissionUpdateType, Reaction, ReactionAction, ReactionSchema, ReadReceipt, RemoteAttachment, Reply, SendMessageOpts, SendOpts, SignatureRequestHandle, SortDirection, TransactionMetadata, TransactionReference, UserPreferenceUpdate, WalletCall, WalletSendCalls, WorkerConfigOptions, WorkerIntervalOverride, WorkerKind } from '@xmtp/wasm-bindings';
 import { ContentCodec, ContentTypeId } from '@xmtp/content-type-primitives';
 
 type ResolveValue<T> = {
@@ -131,6 +131,7 @@ declare class DecodedMessage<ContentTypes = unknown> {
     constructor(codecRegistry: CodecRegistry, message: DecodedMessage$1);
 }
 
+type VisibilityConfirmationOptions = WasmVisibilityConfirmationOptions;
 type XmtpEnv = "local" | "dev" | "production" | "testnet-staging" | "testnet-dev" | "testnet" | "mainnet";
 /**
  * Network options
@@ -214,10 +215,25 @@ type OtherOptions = {
      * Logging level
      */
     loggingLevel?: LogLevel;
+    /**
+     * Tuning for the background worker scheduler (intervals, jitter, per-worker
+     * overrides, and disabled workers). All fields are optional; omitting this
+     * object preserves the default worker behavior.
+     *
+     * Intervals are specified in nanoseconds.
+     */
+    workerConfig?: WorkerConfigOptions;
     /**
      * Disable automatic registration when creating a client
      */
     disableAutoRegister?: boolean;
+    /**
+     * Options for waiting until client registration is visible on the network.
+     *
+     * When set, `registerIdentity` will wait for the specified quorum of nodes
+     * to confirm the registration before resolving.
+     */
+    waitForRegistrationVisible?: VisibilityConfirmationOptions;
 };
 type ClientOptions = (NetworkOptions | {
     backend: Backend;
@@ -263,6 +279,8 @@ type SafeSigner = {
     chainId: bigint;
     blockNumber?: bigint;
 };
+declare const createEOASigner: (key?: `0x${string}`) => Signer;
+declare const createSCWSigner: (address: `0x${string}`, signMessage: (message: string) => Promise<string> | string, chainId: bigint) => Signer;
 declare const toSafeSigner: (signer: Signer, signature: Uint8Array) => Promise<SafeSigner>;
 
 declare class WorkerConversations {
@@ -331,6 +349,8 @@ declare class WorkerClient {
     get debugInformation(): WorkerDebugInformation;
     get preferences(): WorkerPreferences;
     canMessage(identifiers: Identifier[]): Promise<Map<string, boolean>>;
+    fetchLatestInboxUpdatesCount(inboxIds: string[]): Promise<Record<string, number>>;
+    fetchOwnInboxUpdatesCount(): Promise<number>;
     addSignature(signatureRequest: SignatureRequestHandle, signer: SafeSigner): Promise<void>;
     applySignatureRequest(signatureRequest: SignatureRequestHandle): Promise<void>;
     processSignatureRequest(signer: SafeSigner, signatureRequest: SignatureRequestHandle): Promise<void>;
@@ -340,13 +360,20 @@ declare class WorkerClient {
     revokeAllOtherInstallationsSignatureRequest(): Promise<SignatureRequestHandle | undefined>;
     revokeInstallationsSignatureRequest(installationIds: Uint8Array[]): Promise<SignatureRequestHandle>;
     changeRecoveryIdentifierSignatureRequest(identifier: Identifier): Promise<SignatureRequestHandle>;
-    registerIdentity(signer: SafeSigner, signatureRequest: SignatureRequestHandle): Promise<void>;
+    registerIdentity(signer: SafeSigner, signatureRequest: SignatureRequestHandle, visibilityConfirmationOptions?: VisibilityConfirmationOptions): Promise<void>;
     getInboxIdByIdentifier(identifier: Identifier): Promise<string | undefined>;
     signWithInstallationKey(signatureText: string): Uint8Array<ArrayBufferLike>;
     verifySignedWithInstallationKey(signatureText: string, signatureBytes: Uint8Array): boolean;
     verifySignedWithPublicKey(signatureText: string, signatureBytes: Uint8Array, publicKey: Uint8Array): boolean;
     fetchKeyPackageStatuses(installationIds: string[]): Promise<Map<string, KeyPackageStatus>>;
     sendSyncRequest(options: ArchiveOptions, serverUrl: string): Promise<void>;
+    sendSyncArchive(options: ArchiveOptions, serverUrl: string, pin: string): Promise<void>;
+    processSyncArchive(archivePin?: string | null): Promise<void>;
+    listAvailableArchives(daysCutoff: number): AvailableArchiveInfo[];
+    createArchive(opts: ArchiveOptions, key: Uint8Array): Promise<Uint8Array>;
+    importArchive(data: Uint8Array, key: Uint8Array): Promise<void>;
+    archiveMetadata(data: Uint8Array, key: Uint8Array): Promise<ArchiveMetadata>;
+    syncAllDeviceSyncGroups(): Promise<GroupSyncSummary>;
 }
 
 declare class WorkerConversation {
@@ -386,19 +413,20 @@ declare class WorkerConversation {
     addSuperAdmin(inboxId: string): Promise<void>;
     removeSuperAdmin(inboxId: string): Promise<void>;
     publishMessages(): Promise<void>;
+    processStreamedMessage(envelopeBytes: Uint8Array): Promise<Message[]>;
     send(encodedContent: EncodedContent, opts?: SendMessageOpts): Promise<string>;
-    sendText(text: string, isOptimistic?: boolean): Promise<string>;
-    sendMarkdown(markdown: string, isOptimistic?: boolean): Promise<string>;
-    sendReaction(reaction: Reaction, isOptimistic?: boolean): Promise<string>;
-    sendReadReceipt(isOptimistic?: boolean): Promise<string>;
-    sendReply(reply: Reply, isOptimistic?: boolean): Promise<string>;
-    sendTransactionReference(transactionReference: TransactionReference, isOptimistic?: boolean): Promise<string>;
-    sendWalletSendCalls(walletSendCalls: WalletSendCalls, isOptimistic?: boolean): Promise<string>;
-    sendActions(actions: Actions, isOptimistic?: boolean): Promise<string>;
-    sendIntent(intent: Intent, isOptimistic?: boolean): Promise<string>;
-    sendAttachment(attachment: Attachment, isOptimistic?: boolean): Promise<string>;
-    sendMultiRemoteAttachment(multiRemoteAttachment: MultiRemoteAttachment, isOptimistic?: boolean): Promise<string>;
-    sendRemoteAttachment(remoteAttachment: RemoteAttachment, isOptimistic?: boolean): Promise<string>;
+    sendText(text: string, opts?: SendOpts): Promise<string>;
+    sendMarkdown(markdown: string, opts?: SendOpts): Promise<string>;
+    sendReaction(reaction: Reaction, opts?: SendOpts): Promise<string>;
+    sendReadReceipt(opts?: SendOpts): Promise<string>;
+    sendReply(reply: Reply, opts?: SendOpts): Promise<string>;
+    sendTransactionReference(transactionReference: TransactionReference, opts?: SendOpts): Promise<string>;
+    sendWalletSendCalls(walletSendCalls: WalletSendCalls, opts?: SendOpts): Promise<string>;
+    sendActions(actions: Actions, opts?: SendOpts): Promise<string>;
+    sendIntent(intent: Intent, opts?: SendOpts): Promise<string>;
+    sendAttachment(attachment: Attachment, opts?: SendOpts): Promise<string>;
+    sendMultiRemoteAttachment(multiRemoteAttachment: MultiRemoteAttachment, opts?: SendOpts): Promise<string>;
+    sendRemoteAttachment(remoteAttachment: RemoteAttachment, opts?: SendOpts): Promise<string>;
     messages(options?: ListMessagesOptions): Promise<DecodedMessage$1[]>;
     countMessages(options?: ListMessagesOptions): Promise<bigint>;
     consentState(): ConsentState;
@@ -532,6 +560,7 @@ type ClientAction = {
     data: {
         signer: SafeSigner;
         signatureRequestId: string;
+        waitForRegistrationVisible?: VisibilityConfirmationOptions;
     };
 } | {
     action: "client.addAccount";
@@ -589,6 +618,18 @@ type ClientAction = {
     data: {
         identifiers: Identifier[];
     };
+} | {
+    action: "client.fetchLatestInboxUpdatesCount";
+    id: string;
+    result: Record<string, number>;
+    data: {
+        inboxIds: string[];
+    };
+} | {
+    action: "client.fetchOwnInboxUpdatesCount";
+    id: string;
+    result: number;
+    data: Record<string, never>;
 } | {
     action: "client.getInboxIdByIdentifier";
     id: string;
@@ -635,6 +676,58 @@ type ClientAction = {
         options: ArchiveOptions;
         serverUrl: string;
     };
+} | {
+    action: "client.sendSyncArchive";
+    id: string;
+    result: undefined;
+    data: {
+        options: ArchiveOptions;
+        serverUrl: string;
+        pin: string;
+    };
+} | {
+    action: "client.processSyncArchive";
+    id: string;
+    result: undefined;
+    data: {
+        archivePin?: string | null;
+    };
+} | {
+    action: "client.listAvailableArchives";
+    id: string;
+    result: AvailableArchiveInfo[];
+    data: {
+        daysCutoff: number;
+    };
+} | {
+    action: "client.createArchive";
+    id: string;
+    result: Uint8Array;
+    data: {
+        opts: ArchiveOptions;
+        key: Uint8Array;
+    };
+} | {
+    action: "client.importArchive";
+    id: string;
+    result: undefined;
+    data: {
+        data: Uint8Array;
+        key: Uint8Array;
+    };
+} | {
+    action: "client.archiveMetadata";
+    id: string;
+    result: ArchiveMetadata;
+    data: {
+        data: Uint8Array;
+        key: Uint8Array;
+    };
+} | {
+    action: "client.syncAllDeviceSyncGroups";
+    id: string;
+    result: GroupSyncSummary;
+    data: undefined;
 };
 
 type ConversationAction = {
@@ -660,6 +753,14 @@ type ConversationAction = {
     data: {
         id: string;
     };
+} | {
+    action: "conversation.processStreamedMessage";
+    id: string;
+    result: Message[];
+    data: {
+        id: string;
+        envelopeBytes: Uint8Array;
+    };
 } | {
     action: "conversation.messages";
     id: string;
@@ -783,7 +884,7 @@ type ConversationAction = {
     data: {
         id: string;
         text: string;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendMarkdown";
@@ -792,7 +893,7 @@ type ConversationAction = {
     data: {
         id: string;
         markdown: string;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendReaction";
@@ -801,7 +902,7 @@ type ConversationAction = {
     data: {
         id: string;
         reaction: Reaction;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendReadReceipt";
@@ -809,7 +910,7 @@ type ConversationAction = {
     result: string;
     data: {
         id: string;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendReply";
@@ -818,7 +919,7 @@ type ConversationAction = {
     data: {
         id: string;
         reply: Reply;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendTransactionReference";
@@ -827,7 +928,7 @@ type ConversationAction = {
     data: {
         id: string;
         transactionReference: TransactionReference;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendWalletSendCalls";
@@ -836,7 +937,7 @@ type ConversationAction = {
     data: {
         id: string;
         walletSendCalls: WalletSendCalls;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendActions";
@@ -845,7 +946,7 @@ type ConversationAction = {
     data: {
         id: string;
         actions: Actions;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendIntent";
@@ -854,7 +955,7 @@ type ConversationAction = {
     data: {
         id: string;
         intent: Intent;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendAttachment";
@@ -863,7 +964,7 @@ type ConversationAction = {
     data: {
         id: string;
         attachment: Attachment;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendMultiRemoteAttachment";
@@ -872,7 +973,7 @@ type ConversationAction = {
     data: {
         id: string;
         multiRemoteAttachment: MultiRemoteAttachment;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 } | {
     action: "conversation.sendRemoteAttachment";
@@ -881,7 +982,7 @@ type ConversationAction = {
     data: {
         id: string;
         remoteAttachment: RemoteAttachment;
-        isOptimistic?: boolean;
+        opts?: SendOpts;
     };
 };
 
@@ -1397,6 +1498,13 @@ declare class Conversation<ContentTypes = unknown> {
      * @returns Promise that resolves when publishing is complete
      */
     publishMessages(): Promise<void>;
+    /**
+     * Decodes, decrypts, and persists a raw envelope from a group message stream.
+     *
+     * @param envelopeBytes - Raw protobuf-encoded envelope bytes from the stream
+     * @returns The processed and stored messages
+     */
+    processStreamedMessage(envelopeBytes: Uint8Array): Promise<_xmtp_wasm_bindings.Message[]>;
     /**
      * Sends a message
      *
@@ -1404,8 +1512,10 @@ declare class Conversation<ContentTypes = unknown> {
      * @param options - Optional send options
      * @param options.shouldPush - Indicates whether this message should be
      * included in push notifications
-     * @param options.isOptimistic - Indicates whether this message should be
+     * @param options.optimistic - Indicates whether this message should be
      * sent optimistically and published later via `publishMessages`
+     * @param options.idempotencyKey - Optional idempotency key; re-sending
+     * identical content with the same key produces the same deduplicated message id
      * @returns Promise that resolves with the message ID after it has been sent
      */
     send(content: EncodedContent, options?: SendMessageOpts): Promise<string>;
@@ -1413,97 +1523,97 @@ declare class Conversation<ContentTypes = unknown> {
      * Sends a text message
      *
      * @param text - The text to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendText(text: string, isOptimistic?: boolean): Promise<string>;
+    sendText(text: string, opts?: SendOpts): Promise<string>;
     /**
      * Sends a markdown message
      *
      * @param markdown - The markdown to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendMarkdown(markdown: string, isOptimistic?: boolean): Promise<string>;
+    sendMarkdown(markdown: string, opts?: SendOpts): Promise<string>;
     /**
      * Sends a reaction message
      *
      * @param reaction - The reaction to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendReaction(reaction: Reaction, isOptimistic?: boolean): Promise<string>;
+    sendReaction(reaction: Reaction, opts?: SendOpts): Promise<string>;
     /**
      * Sends a read receipt message
      *
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendReadReceipt(isOptimistic?: boolean): Promise<string>;
+    sendReadReceipt(opts?: SendOpts): Promise<string>;
     /**
      * Sends a reply message
      *
      * @param reply - The reply to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendReply(reply: Reply, isOptimistic?: boolean): Promise<string>;
+    sendReply(reply: Reply, opts?: SendOpts): Promise<string>;
     /**
      * Sends a transaction reference message
      *
      * @param transactionReference - The transaction reference to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendTransactionReference(transactionReference: TransactionReference, isOptimistic?: boolean): Promise<string>;
+    sendTransactionReference(transactionReference: TransactionReference, opts?: SendOpts): Promise<string>;
     /**
      * Sends a wallet send calls message
      *
      * @param walletSendCalls - The wallet send calls to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendWalletSendCalls(walletSendCalls: WalletSendCalls, isOptimistic?: boolean): Promise<string>;
+    sendWalletSendCalls(walletSendCalls: WalletSendCalls, opts?: SendOpts): Promise<string>;
     /**
      * Sends an actions message
      *
      * @param actions - The actions to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendActions(actions: Actions, isOptimistic?: boolean): Promise<string>;
+    sendActions(actions: Actions, opts?: SendOpts): Promise<string>;
     /**
      * Sends an intent message
      *
      * @param intent - The intent to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendIntent(intent: Intent, isOptimistic?: boolean): Promise<string>;
+    sendIntent(intent: Intent, opts?: SendOpts): Promise<string>;
     /**
      * Sends an attachment message
      *
      * @param attachment - The attachment to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendAttachment(attachment: Attachment, isOptimistic?: boolean): Promise<string>;
+    sendAttachment(attachment: Attachment, opts?: SendOpts): Promise<string>;
     /**
      * Sends a multi remote attachment message
      *
      * @param multiRemoteAttachment - The multi remote attachment to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendMultiRemoteAttachment(multiRemoteAttachment: MultiRemoteAttachment, isOptimistic?: boolean): Promise<string>;
+    sendMultiRemoteAttachment(multiRemoteAttachment: MultiRemoteAttachment, opts?: SendOpts): Promise<string>;
     /**
      * Sends a remote attachment message
      *
      * @param remoteAttachment - The remote attachment to send
-     * @param isOptimistic - Whether to send the message optimistically
+     * @param opts - Send options (optimistic delivery, idempotency key)
      * @returns Promise that resolves with the message ID after it has been sent
      */
-    sendRemoteAttachment(remoteAttachment: RemoteAttachment, isOptimistic?: boolean): Promise<string>;
+    sendRemoteAttachment(remoteAttachment: RemoteAttachment, opts?: SendOpts): Promise<string>;
     /**
      * Lists messages in this conversation
      *
@@ -2401,6 +2511,19 @@ declare class Client<ContentTypes = ExtractCodecContentTypes> {
      * @returns Whether the client can message the identifiers
      */
     canMessage(identifiers: Identifier[]): Promise<Map<string, boolean>>;
+    /**
+     * Fetches the latest inbox updates count for the specified inbox IDs
+     *
+     * @param inboxIds - The inbox IDs to check
+     * @returns Map of inbox IDs to their updates count
+     */
+    fetchLatestInboxUpdatesCount(inboxIds: string[]): Promise<Map<string, number>>;
+    /**
+     * Fetches the latest inbox updates count for the client's inbox
+     *
+     * @returns The latest inbox updates count
+     */
+    fetchOwnInboxUpdatesCount(): Promise<number>;
     /**
      * Checks if the specified identifiers can be messaged
      *
@@ -2419,6 +2542,27 @@ declare class Client<ContentTypes = ExtractCodecContentTypes> {
      * of `XmtpEnv`.
      */
     static canMessage(identifiers: Identifier[], env?: XmtpEnv): Promise<Map<string, boolean>>;
+    /**
+     * Fetches the latest inbox updates count for the specified inbox IDs
+     * without a client
+     *
+     * @param inboxIds - The inbox IDs to check
+     * @param backend - Optional `Backend` instance created with `createBackend()`
+     * @returns Map of inbox IDs to their updates count
+     */
+    static fetchLatestInboxUpdatesCount(inboxIds: string[], backendOrEnv?: Backend | XmtpEnv): Promise<Map<string, number>>;
+    /**
+     * Fetches the latest inbox updates count for the specified inbox IDs
+     * without a client
+     *
+     * @param inboxIds - The inbox IDs to check
+     * @param env - Optional XMTP environment
+     * @param gatewayHost - Optional gateway host
+     * @returns Map of inbox IDs to their updates count
+     * @deprecated Pass a `Backend` instance created with `createBackend()` instead
+     * of `XmtpEnv` and `gatewayHost`.
+     */
+    static fetchLatestInboxUpdatesCount(inboxIds: string[], env?: XmtpEnv, gatewayHost?: string): Promise<Map<string, number>>;
     /**
      * Fetches the inbox ID for a given identifier from the local database
      * If not found, fetches from the network
@@ -2462,11 +2606,67 @@ declare class Client<ContentTypes = ExtractCodecContentTypes> {
     /**
      * Send a sync request to other devices on the network
      *
-     * @param options - Archive options specifying what to sync
-     * @param serverUrl - The server URL for the sync request
+     * @param options - Archive options specifying what to sync (defaults to consent and messages)
+     * @param serverUrl - The server URL for the sync request (defaults to environment-specific URL)
      * @returns Promise that resolves when the sync request is sent
      */
-    sendSyncRequest(options: ArchiveOptions, serverUrl: string): Promise<void>;
+    sendSyncRequest(options?: ArchiveOptions, serverUrl?: string): Promise<void>;
+    /**
+     * Send a sync archive to the sync group
+     *
+     * @param pin - The pin used for reference when importing
+     * @param options - Archive options specifying what to sync (defaults to consent and messages)
+     * @param serverUrl - The server URL for the sync archive (defaults to environment-specific URL)
+     * @returns Promise that resolves when the sync archive is sent
+     */
+    sendSyncArchive(pin: string, options?: ArchiveOptions, serverUrl?: string): Promise<void>;
+    /**
+     * Process a sync archive that matches the pin given
+     *
+     * @param archivePin - Optional pin to match. If not provided, processes the last archive sent
+     * @returns Promise that resolves when the archive is processed
+     */
+    processSyncArchive(archivePin?: string | null): Promise<void>;
+    /**
+     * List the archives available for import in the sync group
+     *
+     * You may need to manually sync the sync group before calling
+     * this function to see recently uploaded archives.
+     *
+     * @param daysCutoff - Number of days to look back for archives
+     * @returns Promise that resolves with array of available archive information
+     */
+    listAvailableArchives(daysCutoff: number): Promise<AvailableArchiveInfo[]>;
+    /**
+     * Export archive data to bytes for later restoration
+     *
+     * @param key - Encryption key for the archive
+     * @param opts - Archive options specifying what to include (defaults to consent and messages)
+     * @returns Promise that resolves with the archive data as bytes
+     */
+    createArchive(key: Uint8Array, opts?: ArchiveOptions): Promise<Uint8Array>;
+    /**
+     * Import an archive from bytes
+     *
+     * @param data - The archive data as bytes
+     * @param key - Encryption key for the archive
+     * @returns Promise that resolves when the archive is imported
+     */
+    importArchive(data: Uint8Array, key: Uint8Array): Promise<void>;
+    /**
+     * Load the metadata for an archive to see what it contains
+     *
+     * @param data - The archive data as bytes
+     * @param key - Encryption key for the archive
+     * @returns Promise that resolves with the archive metadata
+     */
+    archiveMetadata(data: Uint8Array, key: Uint8Array): Promise<ArchiveMetadata>;
+    /**
+     * Manually sync all device sync groups
+     *
+     * @returns Promise that resolves with a summary of the sync operation
+     */
+    syncAllDeviceSyncGroups(): Promise<GroupSyncSummary>;
 }
 
 declare class Opfs {
@@ -2619,5 +2819,5 @@ declare const isIntent: (m: DecodedMessage) => m is DecodedMessage<Intent>;
 declare const isActions: (m: DecodedMessage) => m is DecodedMessage<Actions>;
 declare const isMarkdown: (m: DecodedMessage) => m is DecodedMessage<string>;
 
-export { AccountAlreadyAssociatedError, ApiUrls, Client, ClientNotInitializedError, Conversation, Conversations, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY, DecodedMessage, Dm, Group, GroupNotFoundError, HistorySyncUrls, InboxReassignError, Opfs, OpfsInitializationError, OpfsNotInitializedError, SignerUnavailableError, StreamFailedError, StreamInvalidRetryAttemptsError, StreamNotFoundError, contentTypeActions, contentTypeAttachment, contentTypeGroupUpdated, contentTypeIntent, contentTypeLeaveRequest, contentTypeMarkdown, contentTypeMultiRemoteAttachment, contentTypeReaction, contentTypeReadReceipt, contentTypeRemoteAttachment, contentTypeReply, contentTypeText, contentTypeTransactionReference, contentTypeWalletSendCalls, createBackend, createStream, decryptAttachment, encodeActions, encodeAttachment, encodeIntent, encodeMarkdown, encodeMultiRemoteAttachment, encodeReaction, encodeReadReceipt, encodeRemoteAttachment, encodeText, encodeTransactionReference, encodeWalletSendCalls, encryptAttachment, generateInboxId, getInboxIdForIdentifier, isActions, isAttachment, isGroupUpdated, isIntent, isLeaveRequest, isMarkdown, isMultiRemoteAttachment, isReaction, isReadReceipt, isRemoteAttachment, isReply, isText, isTextReply, isTransactionReference, isWalletSendCalls, metadataFieldName, toSafeConversation, toSafeSigner };
-export type { AsyncStreamProxy, BuiltInContentTypes, ClientOptions, ContentOptions, DeviceSyncOptions, EOASigner, EnrichedReply, ExtractCodecContentTypes, HmacKeys, LastReadTimes, NetworkOptions, OtherOptions, SCWSigner, SafeConversation, SafeSigner, Signer, StorageOptions, StreamCallback, StreamFunction, StreamOptions, StreamValueMutator, XmtpEnv };
+export { AccountAlreadyAssociatedError, ApiUrls, Client, ClientNotInitializedError, Conversation, Conversations, DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAY, DecodedMessage, Dm, Group, GroupNotFoundError, HistorySyncUrls, InboxReassignError, Opfs, OpfsInitializationError, OpfsNotInitializedError, SignerUnavailableError, StreamFailedError, StreamInvalidRetryAttemptsError, StreamNotFoundError, contentTypeActions, contentTypeAttachment, contentTypeGroupUpdated, contentTypeIntent, contentTypeLeaveRequest, contentTypeMarkdown, contentTypeMultiRemoteAttachment, contentTypeReaction, contentTypeReadReceipt, contentTypeRemoteAttachment, contentTypeReply, contentTypeText, contentTypeTransactionReference, contentTypeWalletSendCalls, createBackend, createEOASigner, createSCWSigner, createStream, decryptAttachment, encodeActions, encodeAttachment, encodeIntent, encodeMarkdown, encodeMultiRemoteAttachment, encodeReaction, encodeReadReceipt, encodeRemoteAttachment, encodeText, encodeTransactionReference, encodeWalletSendCalls, encryptAttachment, generateInboxId, getInboxIdForIdentifier, isActions, isAttachment, isGroupUpdated, isIntent, isLeaveRequest, isMarkdown, isMultiRemoteAttachment, isReaction, isReadReceipt, isRemoteAttachment, isReply, isText, isTextReply, isTransactionReference, isWalletSendCalls, metadataFieldName, toSafeConversation, toSafeSigner };
+export type { AsyncStreamProxy, BuiltInContentTypes, ClientOptions, ContentOptions, DeviceSyncOptions, EOASigner, EnrichedReply, ExtractCodecContentTypes, HmacKeys, LastReadTimes, NetworkOptions, OtherOptions, SCWSigner, SafeConversation, SafeSigner, Signer, StorageOptions, StreamCallback, StreamFunction, StreamOptions, StreamValueMutator, VisibilityConfirmationOptions, XmtpEnv };