@xmtp/node-bindings 1.5.5 → 1.6.0-dev.21f0ffd

package/dist/index.d.ts

@@ -15,12 +15,14 @@ export declare class Client {
   sendSyncRequest(): Promise<void>
   findInboxIdByIdentifier(identifier: Identifier): Promise<string | null>
   addressesFromInboxId(refreshFromNetwork: boolean, inboxIds: Array<string>): Promise<Array<InboxState>>
-  syncPreferences(): Promise<number>
+  syncPreferences(): Promise<GroupSyncSummary>
   apiStatistics(): ApiStats
   apiIdentityStatistics(): IdentityStats
   apiAggregateStatistics(): string
   clearAllStatistics(): void
   uploadDebugArchive(serverUrl: string): Promise<string>
+  deleteMessage(messageId: Uint8Array): number
+  enrichedMessage(messageId: Array<number>): Promise<DecodedMessage>
   setConsentStates(records: Array<Consent>): Promise<void>
   getConsentState(entityType: ConsentEntityType, entity: string): Promise<ConsentState>
   /**
@@ -50,11 +52,12 @@ export declare class Client {
 
 export declare class Conversation {
   id(): string
-  send(encodedContent: EncodedContent): Promise<string>
-  sendOptimistic(encodedContent: EncodedContent): string
+  send(encodedContent: EncodedContent, opts: SendMessageOpts): Promise<string>
+  sendOptimistic(encodedContent: EncodedContent, opts: SendMessageOpts): string
   publishMessages(): Promise<void>
   sync(): Promise<void>
   findMessages(opts?: ListMessagesOptions | undefined | null): Promise<Array<Message>>
+  countMessages(opts?: ListMessagesOptions | undefined | null): Promise<number>
   findMessagesWithReactions(opts?: ListMessagesOptions | undefined | null): Promise<Array<MessageWithReactions>>
   processStreamedGroupMessage(envelopeBytes: Uint8Array): Promise<Message>
   listMembers(): Promise<Array<GroupMember>>
@@ -94,6 +97,8 @@ export declare class Conversation {
   getHmacKeys(): Record<string, Array<HmacKey>>
   debugInfo(): Promise<ConversationDebugInfo>
   findDuplicateDms(): Promise<Array<Conversation>>
+  findEnrichedMessages(opts?: ListMessagesOptions | undefined | null): Promise<Array<DecodedMessage>>
+  getLastReadTimes(): Promise<Record<string, number>>
 }
 
 export declare class ConversationListItem {
@@ -113,7 +118,7 @@ export declare class Conversations {
   findMessageById(messageId: string): Message
   processStreamedWelcomeMessage(envelopeBytes: Uint8Array): Promise<Conversation>
   sync(): Promise<void>
-  syncAllConversations(consentStates?: Array<ConsentState> | undefined | null): Promise<bigint>
+  syncAllConversations(consentStates?: Array<ConsentState> | undefined | null): Promise<GroupSyncSummary>
   list(opts?: ListConversationsOptions | undefined | null): Array<ConversationListItem>
   getHmacKeys(): Record<string, Array<HmacKey>>
   stream(callback: (err: Error | null, result: Conversation | undefined) => void, onClose: () => void, conversationType?: ConversationType): StreamCloser
@@ -122,6 +127,37 @@ export declare class Conversations {
   streamPreferences(callback: (err: null | Error, result: any) => void, onClose: () => void): StreamCloser
 }
 
+export declare class DecodedMessage {
+  id: Array<number>
+  sentAtNs: number
+  kind: GroupMessageKind
+  senderInstallationId: Array<number>
+  senderInboxId: string
+  contentType: ContentTypeId
+  conversationId: Array<number>
+  fallbackText?: string
+  deliveryStatus: DeliveryStatus
+  numReplies: number
+  get reactions(): Array<DecodedMessage>
+  get textContent(): TextContent | null
+  get replyContent(): EnrichedReply | null
+  get reactionContent(): ReactionPayload | null
+  get attachmentContent(): Attachment | null
+  get remoteAttachmentContent(): RemoteAttachment | null
+  get multiRemoteAttachmentContent(): MultiRemoteAttachmentPayload | null
+  get transactionReferenceContent(): TransactionReference | null
+  get groupUpdatedContent(): GroupUpdated | null
+  get readReceiptContent(): ReadReceipt | null
+  get walletSendCallsContent(): WalletSendCalls | null
+  get customContent(): EncodedContent | null
+}
+
+export declare class EnrichedReply {
+  get referenceId(): string
+  get content(): DecodedMessageBody
+  get inReplyTo(): NodeDecodedMessage | null
+}
+
 export declare class GroupMember {
   inboxId: string
   accountIdentifiers: Array<Identifier>
@@ -175,7 +211,13 @@ export interface ApiStats {
   subscribeWelcomes: bigint
 }
 
-export declare export declare function applySignatureRequest(host: string, signatureRequest: SignatureRequestHandle): Promise<void>
+export declare export declare function applySignatureRequest(v3Host: string, gatewayHost: string | undefined | null, signatureRequest: SignatureRequestHandle): Promise<void>
+
+export interface Attachment {
+  filename?: string
+  mimeType: string
+  content: Array<number>
+}
 
 export interface Consent {
   entityType: ConsentEntityType
@@ -197,14 +239,15 @@ export declare const enum ConsentState {
 export declare const enum ContentType {
   Unknown = 0,
   Text = 1,
-  GroupMembershipChange = 2,
-  GroupUpdated = 3,
-  Reaction = 4,
-  ReadReceipt = 5,
-  Reply = 6,
-  Attachment = 7,
-  RemoteAttachment = 8,
-  TransactionReference = 9
+  LeaveRequest = 2,
+  GroupMembershipChange = 3,
+  GroupUpdated = 4,
+  Reaction = 5,
+  ReadReceipt = 6,
+  Reply = 7,
+  Attachment = 8,
+  RemoteAttachment = 9,
+  TransactionReference = 10
 }
 
 export interface ContentTypeId {
@@ -221,7 +264,7 @@ export interface ConversationDebugInfo {
   isCommitLogForked?: boolean
   localCommitLog: string
   remoteCommitLog: string
-  cursor: number
+  cursor: Array<XmtpCursor>
 }
 
 export declare const enum ConversationType {
@@ -238,7 +281,7 @@ export declare const enum ConversationType {
  * It can be one of: `debug`, `info`, `warn`, `error` or 'off'.
  * By default, logging is disabled.
  */
-export declare export declare function createClient(host: string, isSecure: boolean, dbPath: string | undefined | null, inboxId: string, accountIdentifier: Identifier, encryptionKey?: Uint8Array | undefined | null, deviceSyncServerUrl?: string | undefined | null, deviceSyncWorkerMode?: SyncWorkerMode | undefined | null, logOptions?: LogOptions | undefined | null, allowOffline?: boolean | undefined | null, disableEvents?: boolean | undefined | null, appVersion?: string | undefined | null): Promise<Client>
+export declare export declare function createClient(v3Host: string, gatewayHost: string | undefined | null, isSecure: boolean, dbPath: string | undefined | null, inboxId: string, accountIdentifier: Identifier, encryptionKey?: Uint8Array | undefined | null, deviceSyncServerUrl?: string | undefined | null, deviceSyncWorkerMode?: SyncWorkerMode | undefined | null, logOptions?: LogOptions | undefined | null, allowOffline?: boolean | undefined | null, disableEvents?: boolean | undefined | null, appVersion?: string | undefined | null): Promise<Client>
 
 export interface CreateDmOptions {
   messageDisappearingSettings?: MessageDisappearingSettings
@@ -253,6 +296,19 @@ export interface CreateGroupOptions {
   messageDisappearingSettings?: MessageDisappearingSettings
 }
 
+export interface DecodedMessageBody {
+  textContent?: TextContent
+  reactionContent?: ReactionPayload
+  attachmentContent?: Attachment
+  remoteAttachmentContent?: RemoteAttachment
+  multiRemoteAttachmentContent?: MultiRemoteAttachmentPayload
+  transactionReferenceContent?: TransactionReference
+  groupUpdatedContent?: GroupUpdated
+  readReceiptContent?: ReadReceipt
+  walletSendCallsContent?: WalletSendCalls
+  customContent?: EncodedContent
+}
+
 export declare export declare function decodeMultiRemoteAttachment(bytes: Uint8Array): MultiRemoteAttachment
 
 export declare export declare function decodeReaction(bytes: Uint8Array): Reaction
@@ -263,6 +319,8 @@ export declare const enum DeliveryStatus {
   Failed = 2
 }
 
+export declare export declare function deserializeEncodedContent(bytes: Uint8Array): EncodedContent
+
 export interface EncodedContent {
   type?: ContentTypeId
   parameters: Record<string, string>
@@ -277,13 +335,14 @@ export declare export declare function encodeReaction(reaction: Reaction): Uint8
 
 export declare export declare function generateInboxId(accountIdent: Identifier): string
 
-export declare export declare function getInboxIdForIdentifier(host: string, isSecure: boolean, identifier: Identifier): Promise<string | null>
+export declare export declare function getInboxIdForIdentifier(v3Host: string, gatewayHost: string | undefined | null, isSecure: boolean, identifier: Identifier): Promise<string | null>
 
 export declare const enum GroupMembershipState {
   Allowed = 0,
   Rejected = 1,
   Pending = 2,
-  Restored = 3
+  Restored = 3,
+  PendingRemove = 4
 }
 
 export declare const enum GroupMessageKind {
@@ -297,6 +356,18 @@ export declare const enum GroupPermissionsOptions {
   CustomPolicy = 2
 }
 
+export interface GroupSyncSummary {
+  numEligible: number
+  numSynced: number
+}
+
+export interface GroupUpdated {
+  initiatedByInboxId: string
+  addedInboxes: Array<Inbox>
+  removedInboxes: Array<Inbox>
+  metadataFieldChanges: Array<MetadataFieldChange>
+}
+
 export interface HmacKey {
   key: Uint8Array
   epoch: bigint
@@ -319,6 +390,10 @@ export interface IdentityStats {
   verifySmartContractWalletSignature: bigint
 }
 
+export interface Inbox {
+  inboxId: string
+}
+
 export interface InboxState {
   inboxId: string
   recoveryIdentifier: Identifier
@@ -326,7 +401,7 @@ export interface InboxState {
   identifiers: Array<Identifier>
 }
 
-export declare export declare function inboxStateFromInboxIds(host: string, inboxIds: Array<string>): Promise<Array<InboxState>>
+export declare export declare function inboxStateFromInboxIds(v3Host: string, gatewayHost: string | undefined | null, inboxIds: Array<string>): Promise<Array<InboxState>>
 
 export interface Installation {
   bytes: Uint8Array
@@ -334,9 +409,9 @@ export interface Installation {
   id: string
 }
 
-export declare export declare function isAddressAuthorized(host: string, inboxId: string, address: string): Promise<boolean>
+export declare export declare function isAddressAuthorized(host: string, gatewayHost: string | undefined | null, inboxId: string, address: string): Promise<boolean>
 
-export declare export declare function isInstallationAuthorized(host: string, inboxId: string, installationId: Uint8Array): Promise<boolean>
+export declare export declare function isInstallationAuthorized(host: string, gatewayHost: string | undefined | null, inboxId: string, installationId: Uint8Array): Promise<boolean>
 
 export interface KeyPackageStatus {
   lifetime?: Lifetime
@@ -364,7 +439,9 @@ export interface ListMessagesOptions {
   deliveryStatus?: DeliveryStatus
   direction?: SortDirection
   contentTypes?: Array<ContentType>
+  excludeContentTypes?: Array<ContentType>
   kind?: GroupMessageKind
+  excludeSenderInboxIds?: Array<string>
 }
 
 export declare const enum LogLevel {
@@ -413,10 +490,20 @@ export declare const enum MetadataField {
   ImageUrlSquare = 2
 }
 
+export interface MetadataFieldChange {
+  fieldName: string
+  oldValue?: string
+  newValue?: string
+}
+
 export interface MultiRemoteAttachment {
   attachments: Array<RemoteAttachmentInfo>
 }
 
+export interface MultiRemoteAttachmentPayload {
+  attachments: Array<RemoteAttachmentInfoPayload>
+}
+
 export interface PasskeySignature {
   publicKey: Array<number>
   signature: Array<number>
@@ -472,6 +559,14 @@ export declare const enum ReactionAction {
   Removed = 2
 }
 
+export interface ReactionPayload {
+  reference: string
+  referenceInboxId: string
+  action: ReactionAction
+  content: string
+  schema: ReactionSchema
+}
+
 export declare const enum ReactionSchema {
   Unknown = 0,
   Unicode = 1,
@@ -479,6 +574,21 @@ export declare const enum ReactionSchema {
   Custom = 3
 }
 
+export interface ReadReceipt {
+
+}
+
+export interface RemoteAttachment {
+  url: string
+  contentDigest: string
+  secret: Array<number>
+  salt: Array<number>
+  nonce: Array<number>
+  scheme: string
+  contentLength: number
+  filename?: string
+}
+
 export interface RemoteAttachmentInfo {
   secret: Uint8Array
   contentDigest: string
@@ -490,7 +600,24 @@ export interface RemoteAttachmentInfo {
   filename?: string
 }
 
-export declare export declare function revokeInstallationsSignatureRequest(host: string, recoveryIdentifier: Identifier, inboxId: string, installationIds: Array<Uint8Array>): Promise<SignatureRequestHandle>
+export interface RemoteAttachmentInfoPayload {
+  url: string
+  contentDigest: string
+  secret: Array<number>
+  salt: Array<number>
+  nonce: Array<number>
+  scheme: string
+  contentLength?: number
+  filename?: string
+}
+
+export declare export declare function revokeInstallationsSignatureRequest(v3Host: string, gatewayHost: string | undefined | null, recoveryIdentifier: Identifier, inboxId: string, installationIds: Array<Uint8Array>): SignatureRequestHandle
+
+export interface SendMessageOpts {
+  shouldPush: boolean
+}
+
+export declare export declare function serializeEncodedContent(content: EncodedContent): Uint8Array
 
 export declare const enum SortDirection {
   Ascending = 0,
@@ -502,4 +629,51 @@ export declare const enum SyncWorkerMode {
   disabled = 'disabled'
 }
 
+export interface TextContent {
+  content: string
+}
+
+export interface TransactionMetadata {
+  transactionType: string
+  currency: string
+  amount: number
+  decimals: number
+  fromAddress: string
+  toAddress: string
+}
+
+export interface TransactionReference {
+  namespace?: string
+  networkId: string
+  reference: string
+  metadata?: TransactionMetadata
+}
+
 export declare export declare function verifySignedWithPublicKey(signatureText: string, signatureBytes: Uint8Array, publicKey: Uint8Array): void
+
+export interface WalletCall {
+  to?: string
+  data?: string
+  value?: string
+  gas?: string
+  metadata?: WalletCallMetadata
+}
+
+export interface WalletCallMetadata {
+  description: string
+  transactionType: string
+  extra: Record<string, string>
+}
+
+export interface WalletSendCalls {
+  version: string
+  chainId: string
+  from: string
+  calls: Array<WalletCall>
+  capabilities?: Record<string, string>
+}
+
+export interface XmtpCursor {
+  originatorId: number
+  sequenceId: number
+}

package/dist/index.js

@@ -365,11 +365,13 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { Client, Conversation, ConversationListItem, Conversations, GroupMember, GroupMetadata, GroupPermissions, SignatureRequestHandle, StreamCloser, applySignatureRequest, ConsentEntityType, ConsentState, ContentType, ConversationType, createClient, decodeMultiRemoteAttachment, decodeReaction, DeliveryStatus, encodeMultiRemoteAttachment, encodeReaction, generateInboxId, getInboxIdForIdentifier, GroupMembershipState, GroupMessageKind, GroupPermissionsOptions, IdentifierKind, inboxStateFromInboxIds, isAddressAuthorized, isInstallationAuthorized, LogLevel, MetadataField, PermissionLevel, PermissionPolicy, PermissionUpdateType, ReactionAction, ReactionSchema, revokeInstallationsSignatureRequest, SortDirection, SyncWorkerMode, verifySignedWithPublicKey } = nativeBinding
+const { Client, Conversation, ConversationListItem, Conversations, DecodedMessage, EnrichedReply, GroupMember, GroupMetadata, GroupPermissions, SignatureRequestHandle, StreamCloser, applySignatureRequest, ConsentEntityType, ConsentState, ContentType, ConversationType, createClient, decodeMultiRemoteAttachment, decodeReaction, DeliveryStatus, deserializeEncodedContent, encodeMultiRemoteAttachment, encodeReaction, generateInboxId, getInboxIdForIdentifier, GroupMembershipState, GroupMessageKind, GroupPermissionsOptions, IdentifierKind, inboxStateFromInboxIds, isAddressAuthorized, isInstallationAuthorized, LogLevel, MetadataField, PermissionLevel, PermissionPolicy, PermissionUpdateType, ReactionAction, ReactionSchema, revokeInstallationsSignatureRequest, serializeEncodedContent, SortDirection, SyncWorkerMode, verifySignedWithPublicKey } = nativeBinding
 export { Client }
 export { Conversation }
 export { ConversationListItem }
 export { Conversations }
+export { DecodedMessage }
+export { EnrichedReply }
 export { GroupMember }
 export { GroupMetadata }
 export { GroupPermissions }
@@ -384,6 +386,7 @@ export { createClient }
 export { decodeMultiRemoteAttachment }
 export { decodeReaction }
 export { DeliveryStatus }
+export { deserializeEncodedContent }
 export { encodeMultiRemoteAttachment }
 export { encodeReaction }
 export { generateInboxId }
@@ -403,6 +406,7 @@ export { PermissionUpdateType }
 export { ReactionAction }
 export { ReactionSchema }
 export { revokeInstallationsSignatureRequest }
+export { serializeEncodedContent }
 export { SortDirection }
 export { SyncWorkerMode }
 export { verifySignedWithPublicKey }

package/dist/version.json

@@ -1,5 +1,5 @@
 {
-  "branch": "release/v1.5",
-  "version": "34eed53",
-  "date": "2025-10-09 18:22:46 +0000"
+  "branch": "HEAD",
+  "version": "21f0ffd",
+  "date": "2025-10-23 22:32:15 +0000"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmtp/node-bindings",
-  "version": "1.5.5",
+  "version": "1.6.0-dev.21f0ffd",
   "repository": {
     "type": "git",
     "url": "git+https://git@github.com/xmtp/libxmtp.git",