/* Jabber Protocol Plugin for Miranda NG Copyright (c) 2002-04 Santithorn Bunchua Copyright (c) 2005-08 George Hazan Copyright (c) 2007 Maxim Mluhov Copyright (c) 2008-09 Dmitriy Chervov Copyright (c) 2012-14 Miranda NG project (http://miranda-ng.org) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or ( at your option ) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ #ifndef M_JABBER_H__ #define M_JABBER_H__ #ifdef __cplusplus #include // Iq type flags enum { JABBER_IQ_TYPE_FAIL = 0, JABBER_IQ_TYPE_RESULT = 1, JABBER_IQ_TYPE_ERROR = 2, JABBER_IQ_TYPE_GET = 4, JABBER_IQ_TYPE_SET = 8, JABBER_IQ_TYPE_RESULT_ERROR = JABBER_IQ_TYPE_RESULT | JABBER_IQ_TYPE_ERROR, JABBER_IQ_TYPE_GOOD = JABBER_IQ_TYPE_RESULT | JABBER_IQ_TYPE_GET | JABBER_IQ_TYPE_SET, JABBER_IQ_TYPE_ANY = JABBER_IQ_TYPE_RESULT | JABBER_IQ_TYPE_ERROR | JABBER_IQ_TYPE_GET | JABBER_IQ_TYPE_SET }; // Message type flags enum { JABBER_MESSAGE_TYPE_FAIL = 0, JABBER_MESSAGE_TYPE_NORMAL = 1, JABBER_MESSAGE_TYPE_ERROR = 2, JABBER_MESSAGE_TYPE_CHAT = 4, JABBER_MESSAGE_TYPE_GROUPCHAT = 8, JABBER_MESSAGE_TYPE_HEADLINE = 0x10, JABBER_MESSAGE_TYPE_ANY = JABBER_MESSAGE_TYPE_NORMAL | JABBER_MESSAGE_TYPE_ERROR | JABBER_MESSAGE_TYPE_CHAT | JABBER_MESSAGE_TYPE_GROUPCHAT | JABBER_MESSAGE_TYPE_HEADLINE }; // Handler priority values. // All handler calls are ordered by priority specified when adding a handler. // For recv, it will go from lower to higher, so in this case: check ignore, default. // For send handlers, it will go in the opposite order: default, check ignore, send. // You may also use other values than specified here for your handler priority, if it's necessary. // IMPORTANT: In all incoming stanza handlers, return FALSE to continue processing the stanza (Jabber plugin will then call other handlers), or TRUE to stop processing the stanza (if you're sure noone else needs to process this stanza). // In an outgoing stanza handler it works in the same way: return TRUE to stop processing the stanza and abort sending. // All handlers may modify the stanza if it's necessary; these modifications will be passed to remaining handlers. enum { JH_PRIORITY_IGNORE = 50, JH_PRIORITY_DEFAULT = 1000, JH_PRIORITY_UNHANDLED = 5000 // useful for example to catch unhandled Iq stanzas to send a correct reply. }; struct JABBER_DISCO_FIELD { LPCTSTR category, type, name; }; typedef void* HJHANDLER; typedef BOOL (*JABBER_HANDLER_FUNC)(struct IJabberInterface *ji, HXML node, void *pUserData); // IJabberInterface::dwFlags values enum { JIF_UNICODE = 1 }; // Overall Jabber interface struct IJabberInterface { // Set of JIF_* flags. virtual DWORD STDMETHODCALLTYPE GetFlags() const = 0; // Returns version of IJabberInterface. virtual int STDMETHODCALLTYPE GetVersion() const = 0; // Returns Jabber plugin version. virtual DWORD STDMETHODCALLTYPE GetJabberVersion() const = 0; // Compares JIDs by their node@domain part (without resource name). virtual int STDMETHODCALLTYPE CompareJIDs(LPCTSTR jid1, LPCTSTR jid2) = 0; // Returns contact handle for given JID, or NULL on error. virtual HCONTACT STDMETHODCALLTYPE ContactFromJID(LPCTSTR jid) = 0; // Returns JID of hContact, or NULL on error. You must free the result using mir_free(). virtual LPTSTR STDMETHODCALLTYPE ContactToJID(HCONTACT hContact) = 0; // Returns best resource name for given JID, or NULL on error. You must free the result using mir_free(). virtual LPTSTR STDMETHODCALLTYPE GetBestResourceName(LPCTSTR jid) = 0; // Returns all resource names for a given JID in format "resource1\0resource2\0resource3\0\0" (all resources are separated by \0 character and the whole string is terminated with two \0 characters), or NULL on error. You must free returned string using mir_free(). virtual LPTSTR STDMETHODCALLTYPE GetResourceList(LPCTSTR jid) = 0; // Returns Jabber module name. DO NOT free the returned string. virtual char* STDMETHODCALLTYPE GetModuleName() const = 0; // Returns id that can be used for next message sent through SendXmlNode(). virtual int STDMETHODCALLTYPE SerialNext() = 0; // Sends XML node. virtual int STDMETHODCALLTYPE SendXmlNode(HXML node) = 0; // Registers incoming handler. Returns handler handle on success or NULL on error. virtual HJHANDLER STDMETHODCALLTYPE AddPresenceHandler(JABBER_HANDLER_FUNC Func, void *pUserData = NULL, int iPriority = JH_PRIORITY_DEFAULT) = 0; // Registers incoming handler for messages of types specified by iMsgTypes. iMsgTypes is a combination of JABBER_MESSAGE_TYPE_* flags. Returns handler handle on success or NULL on error. virtual HJHANDLER STDMETHODCALLTYPE AddMessageHandler(JABBER_HANDLER_FUNC Func, int iMsgTypes, LPCTSTR szXmlns, LPCTSTR szTag, void *pUserData = NULL, int iPriority = JH_PRIORITY_DEFAULT) = 0; // Registers incoming handler. iIqTypes is a combination of JABBER_IQ_TYPE_* flags. Returns handler handle on success or NULL on error. virtual HJHANDLER STDMETHODCALLTYPE AddIqHandler(JABBER_HANDLER_FUNC Func, int iIqTypes, LPCTSTR szXmlns, LPCTSTR szTag, void *pUserData = NULL, int iPriority = JH_PRIORITY_DEFAULT) = 0; // Registers temporary handler for incoming stanza of type iIqType with id iIqId. iIqTypes is a combination of JABBER_IQ_TYPE_* flags. Returns handler handle on success or NULL on error. // If dwTimeout milliseconds pass and no Iq stanza with the specified iIqId is received, Jabber plugin will call Func() with NULL node. virtual HJHANDLER STDMETHODCALLTYPE AddTemporaryIqHandler(JABBER_HANDLER_FUNC Func, int iIqTypes, int iIqId, void *pUserData = NULL, DWORD dwTimeout = 30000, int iPriority = JH_PRIORITY_DEFAULT) = 0; // Registers handler for outgoing nodes. Returns handler handle on success or NULL on error. // Return FALSE in the handler to continue, or TRUE to abort sending. virtual HJHANDLER STDMETHODCALLTYPE AddSendHandler(JABBER_HANDLER_FUNC Func, void *pUserData = NULL, int iPriority = JH_PRIORITY_DEFAULT) = 0; // Unregisters handler by its handle. virtual int STDMETHODCALLTYPE RemoveHandler(HJHANDLER hHandler) = 0; // Entity capabilities support (see xep-0115) // Registers feature so that it's displayed with proper description in other users' details. Call this function in your ME_SYSTEM_MODULESLOADED handler. Returns TRUE on success or FALSE on error. virtual int STDMETHODCALLTYPE RegisterFeature(LPCTSTR szFeature, LPCTSTR szDescription) = 0; // Adds features to the list of features supported by the client. szFeatures is a list of features separated by \0 character and terminated with two \0 characters. You can call this function at any time. Returns TRUE on success or FALSE on error. virtual int STDMETHODCALLTYPE AddFeatures(LPCTSTR szFeatures) = 0; // Removes features from the list of features supported by the client. szFeatures is a list of features separated by \0 character and terminated with two \0 characters. You can call this function at any time. virtual int STDMETHODCALLTYPE RemoveFeatures(LPCTSTR szFeatures) = 0; // Returns features supported by JID in format "feature1\0feature2\0...\0featureN\0\0" (a list of features separated by \0 character and terminated with two \0 characters), or NULL on error. JID may contain resource name to get features of a specific resource. If there's no resource name, GetResourceFeatures() returns features for the same resource as IJabberSysInterface::GetBestResourceName() returns. If a feature you're checking for is not supported by Jabber plugin natively, you must register it with RegisterFeature(), otherwise GetContactFeatures() won't be able to return it. You must free returned string using mir_free(). virtual LPTSTR STDMETHODCALLTYPE GetResourceFeatures(LPCTSTR jid) = 0; // Returns the connection handle virtual HANDLE STDMETHODCALLTYPE GetHandle(void) = 0; }; /* A service to obtain Jabber API for a given account. If you store the pointer to the interface for later use, you must also hook ME_PROTO_ACCLISTCHANGED and update the pointer to prevent calling API for a removed account. wParam = 0; lParam = (LPARAM)(IJabberInterface**). Returns FALSE if all is Ok, and TRUE otherwise. */ #define JS_GETJABBERAPI "/GetJabberApi" __forceinline IJabberInterface *getJabberApi(const char *szAccount) { IJabberInterface *ji; if (!CallProtoService(szAccount, JS_GETJABBERAPI, 0, (LPARAM)&ji)) return ji; return NULL; } #endif // __cplusplus /* A menu hook to be called during Jabber protocol menu initialization. wParam = (HGENMENU)m_hMenuRoot; lParam = (LPARAM)(IJabberInterface*). Returns FALSE if all is Ok, and TRUE otherwise. */ #define ME_JABBER_MENUINIT "Jabber/ProtoMenuInit" /* A hook to be called during extensions list's creation wParam = (WPARAM)(LIST*) - extensions list to be populated; lParam = (LPARAM)(IJabberInterface*). Returns FALSE if all is Ok, and TRUE otherwise. */ #define ME_JABBER_EXTLISTINIT "Jabber/ExtListInit" /* A hook to be called during server disco info parsing wParam = (WPARAM)(JABBER_DISCO_FIELD*) lParam = (LPARAM)(IJabberInterface*). Returns FALSE if all is Ok, and TRUE otherwise. */ #define ME_JABBER_SRVDISCOINFO "Jabber/ServerDiscoInfo" #endif // M_JABBER_H__