Notifications

This is a page for documenting the notifications from Chat Core in Thunderbird. This is likely out of date. Notifications are grouped by interface you need to attach the observer to.

{% hint style=”warning” %} Draft: This page is not complete. {% endhint %}

nsIObserverService

Topic Subject Data Added Comment
account-added imIAccount null <1.0 a new account has been created
account-connected imIAccount null <1.0 the account has connected
account-connecting imIAccount null <1.0 the account has started a connection attempt
account-connect-error imIAccount null <1.0 the account has disconnecting with an error
account-connect-progress imIAccount null <1.0 the account is attempting to connect
account-disconnected imIAccount null <1.0 the account has disconnected
account-disconnecting imIAccount null <1.0 the account is disconnecting without an error reason
account-list-updated imIAccountsService null <1.0 the list of accounts has been updated
account-removed imIAccount null <1.0 an account is about to be removed
account-updated imIAccount null <1.0
app-handler-pane-loaded nsIDOMWindow null <1.0 Applications pane in preferences window is loaded
autologin-processed imICoreService null <1.0 imICoreService::processAutoLogin() is complete
browser-request prplIRequestBrowser null <1.0 Used by protocol plugins to bring up a browser window (e.g. for an OAuth request)
closing-conversation prplIConversation null <1.0
contact-moved

imIContactsService
imIContact

 null <1.0 when a contact has been moved (removed from one tag, added to another, or both)
contact-tag-added imIContact tag.id <1.0 when a tag is added to a contact
contact-tag-removed imIContact tag.id <1.0 when a tag is removed from a contact
conversation-closed prplIConversation null <1.0 conversation going away
conversation-left-chat prplIConversation null <1.0 the user has left the conversation (but it might remain visible)
conversation-loaded nsISupports null or details <1.0 subject is a \, if fired because an existing conversation is moved from one window to another, the data parameter (“details”) will contain the string “imported”.
im-sent prplIConversation message text <1.0 on sending an IM (whether or not it succeeded)
new-conversation prplIConversation null <1.0 conversation created
new-ui-conversation imIConversation null <1.0
prpl-quit imICoreService null 1.2 Core shutdown, was previously purple-quit
status-changed imICoreService status text <1.0 user (not buddy) status change
tag-hidden imITag null <1.0 fired when a tag is hidden
tag-shown imITag null <1.0 fired when a tag is set to be shown (unhiding it)
ui-conversation-closed null <1.0
unread-im-count-changed count of unread messages <1.0 fired when the number of unread messages changes
new-text imIMessage null 1.5 New message is about to be displayed.
new-directed-incoming-message imIMessage null 1.5 New incoming message that is either a direct message or highlights the user.
ui-conversation-replaced imIConversation null 91 The subject UI conversation is about to be replaced by a new instance (with different interfaces but the same ID).
conversation-update-type imIConversation null 91 The type of the underlying prplIConversation has changed. Is always preceded by a ui-conversation-replaced notification that disposes of the old UIConversation instance, while this will have the new one as subject.
account-sessions-changed imIAccount null 91 The account session list has changed
account-encryption-status-changed imIAccount null 91 The account encryption status info has changed

imIBuddy

Topic Subject Data Added Notes
account-buddy-availability-changed prplIAccountBuddy null <1.0 Possibly fired on account buddy status change
account-buddy-display-name-changed

imIContactsService
imIAccountBuddy

 old serverAlias <1.0 Fired when setting imIAccountBuddy::serverAlias
account-buddy-icon-changed imIAccountBuddy null <1.0 Fired when setting imIAccountBuddy::buddyIconFilename
account-buddy-signed-off imIAccountBuddy null <1.0 Possibly fired on account buddy status change
account-buddy-signed-on imIAccountBuddy null <1.0 Possibly fired on account buddy status change
account-buddy-status-changed imIAccountBuddy null <1.0 Possibly fired on account buddy status change
buddy-added imIBuddy null <1.0 In response to account-buddy-added if the buddy previously had no account buddies
buddy-availability-changed imIBuddy null <1.0 possibly fired on imIBuddy status updates
buddy-display-name-changed imIBuddy old serverAlias <1.0 possibly in response to account-buddy-display-name-changed on the preferred account
buddy-preferred-account-changed

imIContactsService
imIBuddy

 null <1.0 when setting imIBuddy::preferredAccountBuddy (internally)
buddy-removed imIBuddy null <1.0 In response to account-buddy-removed if the buddy no longer has any account buddies
buddy-signed-off imIBuddy null <1.0 possibly fired on imIBuddy status updates
buddy-signed-on imIBuddy null <1.0 possibly fired on imIBuddy status updates
buddy-status-changed imIBuddy null <1.0 possibly fired on imIBuddy status updates

imIContact

Note: all imIContact notifications also go to any imITag it belongs to, as well as nsIObserverService.

Topic Subject Data Added Notes
contact-added imIContact null <1.0 When a new buddy is created with no other contact
contact-availability-changed imIContact null <1.0 Possibly fired on contact status updates
contact-display-name-changed imIContact null <1.0 Fired on setting imIContact::Alias or imIContact::preferredBuddy, or the preferred buddy’s display name changed
contact-no-longer-dummy imIContact null <1.0 Fired when a contact is being loaded?
contact-preferred-buddy-changed imIContact null <1.0 Fired on setting imIContact::preferredBuddy
contact-removed imIContact null <1.0 When the last buddy for the contact is removed
contact-signed-off imIContact null <1.0 Possibly fired on contact status updates
contact-signed-on imIContact null <1.0 Possibly fired on contact status updates
contact-status-changed imIContact null <1.0 Possibly fired on contact status updates

imITag

Topic Subject Data Added Notes
contact-moved-in imIContact null <1.0 When a contact has been moved into the tag
contact-moved-out imIContact null <1.0 When a contact has been moved out of the tag
tag-hidden imIContact null <1.0 fired when a tag is hidden
tag-shown imIContact null <1.0 fired when a tag is set to be shown (unhiding it)

prplIConversation

Topic Subject Data Added Notes
chat-buddy-add nsISimpleEnumerator null <1.0 When users join a chat. The enumerator elements are prplIConvChatBuddy.
chat-buddy-removed nsISimpleEnumerator null <1.0 When chat buddies leave a chat. The enumerator elements are nsISupportsString of the user name.
chat-buddy-update prplIConvChatBuddy old name, if the chat buddy is being renamed <1.0 data is null if this is not a rename
chat-buddy-topic null <1.0 The chat topic was updated
new-text prplIMessage null <1.0 A new message will be written to a conversation. This can be an incoming, outgoing or system message. Subject was purpleIMessage until 1.2.
update-text prplIMessage null 91 An existing message is updated based on the remoteId of the message.
update-buddy-status null <1.0 away-ness or online/offline
update-conv-chatleft null <1.0 the user has left the chat (it might remain visible)
update-conv-title null <1.0
update-typing null <1.0
preparing-message imIOutgoingMessage null 1.5 Outgoing message before it’s been prepared for sending by the protocol
sending-message imIOutgoingMessage null 1.5 Outgoing message was prepared (and potentially split into multiple messages) and will be sent by the protocol after this observer.
chat-update-type null null 91 Conversation changed between being a chat and a direct message conv (isChat toggled).
update-conv-icon prplIConversation null 91 The convIconFilename of the conversation changed.
update-conv-encryption prplIConversation null 91 The encryptionState of the conversation changed.

imIConversation

Topic Subject Data Added Notes
received-message imIMessage null 1.5 New message is about to be prepared for display.
new-text imIMessage null 1.5 New message is about to be displayed. (Before 1.5 probably just passed along the prplIMessage)
new-directed-incoming-message imIMessage null 1.5 New incoming message that is either a direct message or highlights the user.

imIUserStatusInfo

Topic Subject Data Added Notes
status-changed imIUserStatusInfo Status Text (string) ?
user-icon-changed imIUserStatusInfo New icon file name (string) ?
user-display-name-changed imIUserStatusInfo New display name (string) ?
idle-time-changed imIUserStatusInfo New idle time (number) ?