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.

Draft: This page is not complete.

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 <browser type="content-conversation">, 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)	?