The Bondi commlog Module - Version 1.1

3.1. CommLogSMSSuccessCallback

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

3.2. CommLogMMSSuccessCallback

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

3.3. CommLogEmailSuccessCallback

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

3.4. CommLogCallSuccessCallback

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

3.5. CommLogManager

        interface CommLogManager {

                const unsigned short INBOX_FOLDER = 0;

                const unsigned short OUTBOX_FOLDER = 1;

                const unsigned short SENT_FOLDER  = 2;

                const unsigned short DRAFT_FOLDER = 3;

                const unsigned short MISSED_CALLS_FOLDER = 0;

                const unsigned short RECEIVED_CALLS_FOLDER = 1;

                const unsigned short INITIATED_CALLS_FOLDER = 2;

                const unsigned short MESSAGE_TYPE_SMS = 0;

                const unsigned short MESSAGE_TYPE_MMS = 1;

                const unsigned short MESSAGE_TYPE_EMAIL = 2;
                
                PendingOperation getSMSLog(in CommLogSMSSuccessCallback successCallback,
                                           in ErrorCallback errorCallback,
                                           in ShortArray messageFolders,
                                           [Optional]in SMSFilter filter)
                        raises(SecurityError, DeviceAPIError);


                PendingOperation getMMSLog(in CommLogMMSSuccessCallback successCallback,
                                           in ErrorCallback errorCallback,
                                           in ShortArray messageFolders,
                                           [Optional]in MMSFilter filter)
                        raises(SecurityError, DeviceAPIError);


                PendingOperation getEmailLog(in CommLogEmailSuccessCallback successCallback,
                                             in ErrorCallback errorCallback,
                                             in ShortArray messageFolders,
                                             [Optional]in EmailFilter filter)
                        raises(SecurityError, DeviceAPIError);


                PendingOperation getCallLog(in CommLogCallSuccessCallback successCallback,
                                            in ErrorCallback errorCallback,
                                            in ShortArray callFolder,
                                            [Optional]in CallFilter filter)
                        raises(SecurityError, DeviceAPIError);

                StringArray getSMSSupportedPropertyKeys();

                StringArray getMMSSupportedPropertyKeys();

                StringArray getEmailSupportedPropertyKeys();

                StringArray getCallSupportedPropertyKeys();
                
            unsigned long getNumberOfMessages(in unsigned short messageType, 
                                               in ShortArray messageFolders,
                                               [Optional] in boolean unread)                                    
                        raises(DeviceAPIError);                                        
        
            unsigned long getNumberOfCalls(in ShortArray callFolders)
                        raises(DeviceAPIError);      
                        
                PendingOperation clearMessageLog(in SuccessCallback successCallback, 
                                                 in ErrorCallback errorCallback,
                                                 in unsigned short messageType, 
                                                 in unsigned short messageFolder)
                        raises(SecurityError, DeviceAPIError);      
                
                PendingOperation clearCallLog(in SuccessCallback successCallback, 
                                              in ErrorCallback errorCallback,
                                              in unsigned short callFolder)
                        raises(SecurityError, DeviceAPIError);              
        };

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

        // Define the requestFeature success callback.
        function successCallback(response) {
                bondi.commlog.getSMSLog(smsSuccessCallback, errorCallback,
                        { bondi.commlog.INBOX_FOLDER, bondi.commlog.OUTBOX_FOLDER},
                        { Recipient:"+34666666666", Body:"Huesca"});
        }

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

        // Request the commlog feature.
        bondi.requestFeature(successCallback, errorCallback, "commlog");
 

3.6. Call

        [Callback] interface Call {
                readonly attribute DOMString phoneNumber;

                readonly attribute Date startTime;

                readonly attribute unsigned long duration;

                readonly attribute DOMString id;

                readonly attribute unsigned short folder;
        };

        // Define the success callback.
        function successCallback(response) {
                var calls = response;
                // Get first phone number in the list of results
                alert(call[0].phoneNumber);
        }

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

        // Get the missed calls log.
        bondi.commlog.getCallLog(successCallback, errorCallback,
                { bondi.commlog.MISSED_CALLS_FOLDER},
                { phoneNumber:"+34666666666"});
 

3.7. SMSFilter

        [NoInterfaceObject, Callback] interface SMSFilter {
                attribute DOMString body;
                
                attribute DOMString recipient;
                
                attribute Date initialDate;

                attribute Date finalDate;
    };

        // 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 SMS log for the specified filter.
        bondi.commlog.getSMSLog(successCallback, errorCallback,
                { bondi.commlog.INBOX_FOLDER, bondi.commlog.OUTBOX_FOLDER},
                { recipient:"+34666666666", body:"Huesca"});
 

3.8. MMSFilter

        [NoInterfaceObject, Callback] interface MMSFilter {
                attribute DOMString body;
                
                attribute DOMString recipient;
                
                attribute Date initialDate;

                attribute Date finalDate;
        };

        // 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 SMS log for the specified filter.
        bondi.commlog.getMMSLog(successCallback, errorCallback,
                { bondi.commlog.INBOX_FOLDER, bondi.commlog.OUTBOX_FOLDER},
                { recipient:"+34666666666", body:"Huesca"});
 

3.9. EmailFilter

        [NoInterfaceObject, Callback] interface EmailFilter {
                attribute DOMString from;
                
                attribute DOMString to;
                
                attribute DOMString cc;
                
          attribute DOMString bcc;
                
                attribute DOMString subject;
                
                attribute DOMString body;
                
                attribute Date initialDate;

                attribute Date finalDate;
        };

        // 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-mail log for the specified filter.
        bondi.commlog.getEmailLog(successCallback, errorCallback,
                { bondi.commlog.INBOX_FOLDER, bondi.commlog.OUTBOX_FOLDER},
                { from:"+34666666666", body:"Huesca"});
 

3.10. CallFilter

        [NoInterfaceObject, Callback] interface CallFilter {
                attribute DOMString phoneNumber;
                
                attribute unsigned long minDuration;
        };

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

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

        // Get the SMS log for the specified filter.
        bondi.commlog.getCallLog(successCallback, errorCallback,
                { bondi.commlog.RECEIVED_CALLS_FOLDER},
                { phoneNumber:"+34666666666"});
 

3.11. CommLogManagerObject

        interface CommLogManagerObject {
                readonly attribute CommLogManager commlogManager; 
        };

        Bondi implements CommLogManagerObject;