The Bondi messaging Module - Version 1.1

3.1. FindSMSsSuccessCallback

        [Callback=FunctionOnly, NoInterfaceObject] interface FindSMSsSuccessCallback {
                void onSuccess(in SMSArray obj);
        };

3.2. FindMMSsSuccessCallback

        [Callback=FunctionOnly, NoInterfaceObject] interface FindMMSsSuccessCallback {
                void onSuccess(in MMSArray obj);
        };

3.3. FindEmailsSuccessCallback

        [Callback=FunctionOnly, NoInterfaceObject] interface FindEmailsSuccessCallback {
                void onSuccess(in EmailArray obj);
        };

3.4. EmailAccountsSuccessCallback

        [Callback=FunctionOnly, NoInterfaceObject] interface EmailAccountsSuccessCallback {
                void onSuccess(in StringArray obj);
        };

3.5. SubscriptionSuccessCallback

        [Callback=FunctionOnly, NoInterfaceObject] interface SubscriptionSuccessCallback {
                void onSuccess(in unsigned long subscriptionID);
        };

3.6. OnIncomingSMS

        [Callback=FunctionOnly, NoInterfaceObject] interface OnIncomingSMS {
                void onEvent(in SMS message);
        };

3.7. OnIncomingBinarySMS

        [Callback=FunctionOnly, NoInterfaceObject] interface OnIncomingBinarySMS {
                void onEvent(in BinarySMS message);
        };

3.8. OnIncomingMMS

        [Callback=FunctionOnly, NoInterfaceObject] interface OnIncomingMMS {
                void onEvent(in MMS message);
        };

3.9. OnIncomingEmail

        [Callback=FunctionOnly, NoInterfaceObject] interface OnIncomingEmail {
                void onEvent(in Email message);
        };

3.10. MessagingError

        interface MessagingError : GenericError {

                const unsigned short OUT_OF_COVERAGE_ERROR = 1;

                const unsigned short MMS_VIDEO_SLIDE_ERROR = 2;

                const unsigned short MMS_MESSAGE_SIZE_EXCEEDED_ERROR = 3;
        };

3.11. MessagingManager

        interface MessagingManager {

                const unsigned short INBOX_FOLDER = 0;

                const unsigned short SENT_FOLDER = 1;

                const unsigned short OUTBOX_FOLDER = 2;

                const unsigned short DRAFTS_FOLDER = 3;

                SMS createSMS([Optional] in SMSProperties options) 
                        raises(DeviceAPIError);

                MMS createMMS([Optional] in MMSProperties options)
                        raises(DeviceAPIError);

                Email createEmail([Optional] in EmailProperties options)
                        raises(DeviceAPIError);

                BinarySMS createBinarySMS([Optional] in BinarySMSProperties options)
                        raises(DeviceAPIError);
                        
                        
                 PendingOperation updateSMS(in SuccessCallback successCallback, 
                                in ErrorCallback errorCallback,
                                in SMS sms);
                
                 PendingOperation updateMMS(in SuccessCallback successCallback, 
                                in ErrorCallback errorCallback,
                                in MMS mms);

                 
                 PendingOperation updateEmail(in SuccessCallback successCallback, 
                                in ErrorCallback errorCallback,
                                in Email email);                        
                                
                PendingOperation sendSMS(in SuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in SMS sms, [Optional] in boolean store);

                PendingOperation sendMMS(in SuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in MMS mms, [Optional] in boolean store);

                PendingOperation sendEmail(in SuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in Email email, [Optional] in boolean store);

                
                PendingOperation sendBinarySMS(in SuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in BinarySMS binary);
                        
                PendingOperation findSMSs(in FindSMSsSuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in ShortArray messageFolders,
                                [Optional]in SMSFilter filter);


                PendingOperation findMMSs(in FindMMSsSuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in ShortArray messageFolders,
                                [Optional]in MMSFilter filter);


                PendingOperation findEmails(in FindEmailsSuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in ShortArray messageFolders,
                                [Optional]in EmailFilter filter);

                unsigned long getNumberOfSMSs(in ShortArray messageFolders,
                                [Optional] in boolean unread)
                        raises(DeviceAPIError);

                unsigned long getNumberOfMMSs(in ShortArray messageFolders,
                                [Optional] in boolean unread)
                        raises(DeviceAPIError);

                unsigned long getNumberOfEmails(in ShortArray messageFolders,
                                [Optional] in boolean unread)
                        raises(DeviceAPIError);

                PendingOperation deleteSMS(in SuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in DOMString messageID, in unsigned short folder);

                PendingOperation deleteMMS(in SuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in DOMString messageID, in unsigned short folder);

                PendingOperation deleteEmail(in SuccessCallback successCallback,
                                in ErrorCallback errorCallback,
                                in DOMString messageID, in unsigned short folder);
                        
                PendingOperation getAvailableEmailAccounts(in EmailAccountsSuccessCallback successCallback,
                                in ErrorCallback errorCallback);

                PendingOperation subscribeToSMS (in SubscriptionSuccessCallback successCallback, 
                                in ErrorCallback errorCallback,
                                in OnIncomingSMS listener,
                                in SMSFilter filter,
                                in boolean exclusive);

                void unsubscribeFromSMS  (in unsigned long subscriptionID)
                        raises(SecurityError, DeviceAPIError);


                PendingOperation subscribeToBinarySMS (in SubscriptionSuccessCallback successCallback, 
                                in ErrorCallback errorCallback,
                                in OnIncomingBinarySMS listener,
                                in BinarySMSFilter filter,
                                in boolean exclusive);

                void unsubscribeFromBinarySMS  (in unsigned long subscriptionID)
                        raises(DeviceAPIError);




                PendingOperation subscribeToMMS (in SubscriptionSuccessCallback successCallback, 
                                in ErrorCallback errorCallback,
                                in OnIncomingMMS listener,
                                in MMSFilter filter,
                                in boolean exclusive);

                void unsubscribeFromMMS  (in unsigned long subscriptionID)
                        raises(DeviceAPIError);

                PendingOperation subscribeToEmail (in SubscriptionSuccessCallback successCallback, 
                                in ErrorCallback errorCallback,
                                in OnIncomingEmail listener,
                                in EmailFilter filter,
                                in boolean exclusive);

                void unsubscribeFromEmail  (in unsigned long subscriptionID)
                        raises(DeviceAPIError);

        };

3.12. SMS

        interface SMS : SMSProperties {

                readonly attribute DOMString id;

        };

3.13. MMSSlide

        interface MMSSlide {

                attribute unsigned long duration;

                attribute DOMString image
                        setraises(MessagingError);

                attribute unsigned long imageBegin;

                attribute unsigned long imageEnd;

                attribute DOMString audio
                        setraises(MessagingError);

                attribute unsigned long audioBegin;

                attribute unsigned long audioEnd;

                attribute DOMString text
                        setraises(MessagingError);

                attribute unsigned long textBegin;

                attribute unsigned long textEnd;

                attribute DOMString video;

                attribute unsigned long videoBegin;

                attribute unsigned long videoEnd;
        };

3.14. MMS

        interface MMS : MMSProperties {

                readonly attribute DOMString id;

                const unsigned short MULTIPART_MIXED = 0;

                const unsigned short MULTIPART_RELATED = 1;

                attribute unsigned short messageType;

                attribute MMSSlideArray slides;
        };

3.15. Email

        interface Email : EmailProperties {

                readonly attribute DOMString id;


        };

3.16. SMSProperties

        [NoInterfaceObject, Callback] interface SMSProperties {

                attribute StringArray to;


                readonly attribute DOMString from;
                
                readonly attribute Date datetime;

                attribute DOMString body;
                        
                readonly attribute unsigned short folder;

                readonly attribute boolean read;
                
        };

3.17. SMSFilter

        [NoInterfaceObject] interface SMSFilter : GenericFilter {
        };

        // Define the success callback.
        function successCallback(response) {
                var messages = response;
                // Get first message in the list of results
                var sms = messages[0];
        }

        // Define the error callback.
        function errorCallback(response) {
                alert( "The following error code is: " +  response.code);
        }

        // Get the SMSs for the specified filter.
        bondi.messaging.findSMSs(successCallback, errorCallback,
                [ bondi.messaging.INBOX_FOLDER, bondi.messaging.OUTBOX_FOLDER ],
                { to:"+34666666666", body:"Huesca"});
 

3.18. MMSProperties

        [NoInterfaceObject, Callback] interface MMSProperties {

                attribute StringArray to;

                attribute StringArray cc;

                attribute StringArray bcc;


                readonly attribute DOMString from;
                
                attribute DOMString subject;

                attribute StringArray attachments;
                
                readonly attribute Date datetime;

                attribute DOMString body;
                        
                readonly attribute unsigned long folder;

                readonly attribute boolean read;
        };

3.19. MMSFilter

        [NoInterfaceObject] interface MMSFilter : GenericFilter {
        };

        // Define the success callback.
        function successCallback(response) {
                var messages = response;
                // Get first message in the list of results
                var mms = messages[0];
        }

        // Define the error callback.
        function errorCallback(response) {
                alert( "The following error code is: " +  response.code);
        }

        // Get the MMSs for the specified filter.
        bondi.messaging.findMMSs(successCallback, errorCallback,
                [bondi.messaging.SENT_FOLDER],
                { to:"+34666666666", body:"Huesca"});
 

3.20. EmailProperties

        [NoInterfaceObject, Callback] interface EmailProperties {
                
                attribute StringArray to;

                attribute StringArray cc;

                attribute StringArray bcc;


                readonly attribute DOMString from;
                
                attribute DOMString subject;

                attribute StringArray attachments;
                
                readonly attribute Date datetime;

                attribute DOMString body;
                        
                readonly attribute unsigned long folder;

                readonly attribute boolean read;
        };

3.21. EmailFilter

        [NoInterfaceObject] interface EmailFilter : GenericFilter {
        };

        // Define the success callback.
        function successCallback(response) {
                var messages = response;
                // Get first message in the list of results
                var email = messages[0];
        }

        // Define the error callback.
        function errorCallback(response) {
                alert( "The following error code is: " +  response.code);
        }

        // Get the E-mails for the specified filter.
        bondi.messaging.findEmails(successCallback, errorCallback,
                [ bondi.messaging.INBOX_FOLDER, bondi.messaging.OUTBOX_FOLDER ],
                { from:"+34666666666", body:"Huesca"});
 

3.22. BinarySMSProperties

        [NoInterfaceObject, Callback] interface BinarySMSProperties {
                attribute DOMString to;

                attribute ByteArray payload;

                readonly attribute unsigned short port;

        };

3.23. BinarySMS

        interface BinarySMS : BinarySMSProperties {

                readonly attribute DOMString id;

        };

3.24. BinarySMSFilter

        [NoInterfaceObject] interface BinarySMSFilter : GenericFilter {
        };

        // Filter the incoming BinarySMS
        bondi.messaging.subscribeToBinarySMS (successCallback, errorCallback,
                        listener, { from:"+34666666666", port:20000}, true);
 

3.25. MessagingManagerObject

        interface MessagingManagerObject {
                readonly attribute MessagingManager messaging;
        };

        Bondi implements MessagingManagerObject;