/* 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-22 Miranda NG team (https://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 { LPCSTR category, type, name; }; typedef void* HJHANDLER; typedef BOOL (*JABBER_HANDLER_FUNC)(struct IJabberInterface *ji, const TiXmlElement *node, void *pUserData); // IJabberInterface::dwFlags values enum { JIF_UNICODE = 1 }; // Overall Jabber interface struct IJabberInterface { // Set of JIF_* flags. virtual uint32_t STDMETHODCALLTYPE GetFlags() const = 0; // Returns version of IJabberInterface. virtual int STDMETHODCALLTYPE GetVersion() const = 0; // Returns Jabber plugin version. virtual uint32_t STDMETHODCALLTYPE GetJabberVersion() const = 0; // Returns contact handle for given JID, or NULL on error. virtual MCONTACT STDMETHODCALLTYPE ContactFromJID(LPCSTR jid) = 0; // Returns JID of hContact, or NULL on error. You must free the result using mir_free(). virtual char* STDMETHODCALLTYPE ContactToJID(MCONTACT hContact) = 0; // Returns best resource name for given JID, or NULL on error. You must free the result using mir_free(). virtual char* STDMETHODCALLTYPE GetBestResourceName(LPCSTR 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 char* STDMETHODCALLTYPE GetResourceList(LPCSTR 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; // Registers incoming handler. Returns handler handle on success or NULL on error. virtual HJHANDLER STDMETHODCALLTYPE AddPresenceHandler(JABBER_HANDLER_FUNC Func, void *pUserData = nullptr, 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, LPCSTR szXmlns, LPCSTR szTag, void *pUserData = nullptr, 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, LPCSTR szXmlns, LPCSTR szTag, void *pUserData = nullptr, 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 = nullptr, 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(LPCSTR szFeature, LPCSTR 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(LPCSTR 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(LPCSTR 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 char* STDMETHODCALLTYPE GetResourceFeatures(LPCSTR jid) = 0; // Returns the connection handle virtual HNETLIBUSER 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 nullptr; } #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__