SkypeR 0.0.8 → 0.0.9

data/lib/skyper/exception.rb

@@ -0,0 +1,14 @@
+
+module SkypeR
+  module Exception
+    class Base < RuntimeError
+    end
+
+    class UnknownError < Base
+    end
+
+    class ParseError < Base
+    end
+    
+  end
+end

data/lib/skyper/object.rb

@@ -11,10 +11,93 @@ end
 
 module SkypeR
   module Object
-    class User
+
+    class Base
+      def update_attributes(attributes)
+      end
+    end
+=begin
+USER object
+
+NB! When you retrieve USER object records with SEARCH USERS command, the user profile data is guaranteed to be accessible with GET USER <user_id> <property_name> commands only until another SEARCH command is executed. The reason for this is that big SEARCH commands can and often trigger Skype's internal garbage collection routine that can clear out the data retreived by previous searches.
+
+The user object has the following properties:
+
+    * HANDLE - username, for example: USER pamela HANDLE pamela .
+    * FULLNAME - user's full name, for example: USER pamela FULLNAME Jane Doe .
+    * BIRTHDAY - user's birth date in YYYYMMDD format, for example: USER bitman BIRTHDAY 19780329 .
+    * SEX - example: USER pamela SEX UNKNOWN . Values:
+          o UNKNOWN - user has not specified sex in personal profile.
+          o MALE
+          o FEMALE 
+    * LANGUAGE - name of language, for example: USER mike LANGUAGE English . In protocol 4 with the ISO 639 prefix, example: USER mike LANGUAGE en English .
+    * COUNTRY - name of country, for example: USER mike COUNTRY Estonia . In protocol 4 with the ISO 3166 prefix, example: USER mike COUNTRY ee Estonia .
+    * PROVINCE - example: USER mike PROVINCE Harjumaa .
+    * CITY - example: USER mike CITY Tallinn .
+    * PHONE_HOME - example: USER mike PHONE_HOME 3721111111 .
+    * PHONE_OFFICE - example: USER mike PHONE_OFFICE 3721111111 .
+    * PHONE_MOBILE - example: USER mike PHONE_MOBILE 3721111111 .
+    * HOMEPAGE - example: USER mike HOMEPAGE http://www.joltid.com .
+    * ABOUT - example: USER mike ABOUT I am a nice person .
+    * HASCALLEQUIPMENT - always returns TRUE . Example: USER pamela HASCALLEQUIPMENT TRUE .
+    * IS_VIDEO_CAPABLE - possible values: True or False
+    * IS_VOICEMAIL_CAPABLE - possible values: True or False
+    * BUDDYSTATUS - example: USER pamela BUDDYSTATUS 2 . Possible BUDDYSTATUS values:
+          o 0 - never been in contact list.
+          o 1 - deleted from contact list. (read-write)
+          o 2 - pending authorisation. (read-write)
+          o 3 - added to contact list. 
+    * ISAUTHORIZED - (read-write) is user authorized by current user? Example: USER pamela ISAUTHORIZED TRUE . Values:
+          o TRUE
+          o FALSE 
+    * ISBLOCKED - (read-write) is user blocked by current user? Example: USER spammer ISBLOCKED TRUE . Values:
+          o TRUE
+          o FALSE 
+    * ONLINESTATUS - user online status, for example: USER mike ONLINESTATUS ONLINE . Possible values:
+          o UNKNOWN - unknown user.
+          o OFFLINE - user is offline (not connected). Will also be returned if current user is not authorized by other user to see his/her online status.
+          o ONLINE - user is online.
+          o AWAY - user is away (has been inactive for certain period).
+          o NA - user is not available.
+          o DND - user is in "Do not disturb" mode. 
+    * SkypeOut - user is in the SkypeOut contact list.
+    * SKYPEME (Protocol 2)
+    * LASTONLINETIMESTAMP - UNIX timestamp, available only for offline user. Example USER mike LASTONLINETIMESTAMP 1078959579 .
+    * CAN_LEAVE_VM - is it possible to send voicemail to user? Example: USER test CAN_LEAVE_VM TRUE . Possible values:
+          o TRUE
+          o FALSE 
+    * SPEEDDIAL - (read-write) speeddial code assigned to user.
+    * RECEIVEDAUTHREQUEST - text message for authorization request; available only when user asks for authorization.
+    * MOOD_TEXT - mood text for user (mood text is only visible to authorised users; visible in Skype for Windows 2.0).
+    * RICH_MOOD_TEXT - advanced version of user's mood message. See SET PROFILE RICH_MOOD_TEXT command for more information. Introduced in API version 3.0
+    * ALIASES <text> - list of assigned aliases (aliases are only visible as a result of a direct match for alias search).
+    * TIMEZONE <offset> - time offset from GMT in minutes; visible in Skype for Windows 2.0.
+    * IS_CF_ACTIVE - whether the user has Call Forwarding activated or not. Possible values:
+          o TRUE
+          o FALSE 
+    * NROF_AUTHED_BUDDIES - Stores the number of authorized contacts in the contact list. 
+
+Most user properties are read-only. The following properties are read-write and can be modified with the SET command:
+
+    * BUDDYSTATUS
+          o 1 - delete from buddylist
+          o 2 - add user into contactlist and ask for authorization: SET USER echo123 BUDDYSTATUS 2 Please authorize me 
+    * ISBLOCKED
+          o TRUE - block user
+          o FALSE - unblock user 
+    * ISAUTHORIZED
+          o TRUE - authorize user
+          o FALSE - dismiss authorization for user 
+    * SPEEDDIAL - speeddial code assigned to user
+    * DISPLAYNAME - By default this property is empty. If a value is assigned to this property with SET <skypename> DISPLAYNAME <value> then that value will be displayed in Skype UI instead of user's FULLNAME. 
+
+=end
+
+    class User < Base
       attr_accessor :handle, :fullname, :birthday, :sex, :language, :country, :buddystatus, :isauthorized, :isblocked, :onlinestatus, :lastonlinetimestamp, :can_leave_vm
       def initialize(args={})
         @handle = args[:handle] if args[:handle]
+        args[:property]
         @fullname = args[:fullname] if args[:fullname]
         @birthday = args[:birthday] if args[:birthday]
         @sex = args[:sex] if args[:sex]
@@ -27,9 +110,45 @@ module SkypeR
         @lastonlinetimestamp = args[:lastonlinetimestamp] if args[:lastonlinetimestamp]
         @can_leave_vm = args[:can_leave_vm] if args[:can_leave_vm]
       end
+
+      def execute(statement)
+        application = SkypeR::Service::Application.new('test', 'log/iskype.log')
+        command = SkypeR::Service::CommandMessage.new(statement)
+        application.invoke(command)
+      end
     end
 
-    class Profile
+=begin
+PROFILE object
+
+Use the GET PROFILE command to retrieve profile information. The PROFILE object has the following properties:
+
+    * PSTN_BALANCE - ( read only ) SkypeOut balance value. Note that the precision of profile balance value is currently fixed at 2 decimal places, regardless of currency or any other settings.
+    * PSTN_BALANCE_CURRENCY - ( read only ) SkypeOut currency value
+    * FULLNAME - text
+    * BIRTHDAY - yyyymmdd, 0 is returned if not set; no partial birthday allowed
+    * SEX - MALE | FEMALE | UNKNOWN
+    * LANGUAGES - [lang[ lang]*] -- lang is a two letter ISO code (en, de, et)
+    * COUNTRY - iso2 name, a two letter ISO code; name - country name
+    * IPCOUNTRY - GeoIP location, country code in two letter ISO format
+    * PROVINCE - text
+    * CITY - text
+    * PHONE_HOME - text
+    * PHONE_OFFICE - text
+    * PHONE_MOBILE - text
+    * HOMEPAGE - text
+    * ABOUT - text
+    * MOOD_TEXT - user's mood message (the plain text version).
+    * RICH_MOOD_TEXT - advanced version of user's mood message. See SET PROFILE RICH_MOOD_TEXT command for more information. Introduced in API version 3.0
+    * TIMEZONE - Offset is given in minutes from GMT.
+    * CALL_APPLY_CF - To enable/disable call forwarding - See Call forwarding
+    * CALL_NOANSWER_TIMEOUT - Time out on call - See Call forwarding
+    * CALL_FORWARD_RULES - See Call forwarding
+    * CALL_SEND_TO_VM - To enable/disable voicemail for forwarded calls - See Call forwarding
+    * SMS_VALIDATED_NUMBERS - A read-only property that contains a comma-separated list of phone numbers the user has registered for usage in reply-to field of SMS messages. See Setting mobile phone number on reply-to field in outgoing SMS messages section for further information. 
+=end
+
+    class Profile < Base
       attr_accessor :pstn_balance, :fullname, :birthday, :sex, :languages, :timezone
       def initialize(args={})
         @pstn_balance = args[:pstn_balance] if args[:pstn_balance]
@@ -41,7 +160,105 @@ module SkypeR
       end
     end
 
-    class Call
+=begin
+CALL object
+
+The CALL object has the following properties:
+
+    * TIMESTAMP - time when call was placed (UNIX timestamp), for example CALL 17 TIMESTAMP 1078958218
+    * PARTNER_HANDLE - for example CALL 17 PARTNER_HANDLE mike
+    * PARTNER_DISPNAME - for example CALL 17 PARTNER_DISPNAME Mike Mann
+    * TARGET_IDENTITY - This property is set when you a) have a SkypeIn number and b) receive an incoming PSTN call. The value of call's target identity property is then set to your own SkypeIn number. This property is not set if the incoming call is P2P. This property was introduced in API version 3.1
+    * CONF_ID - if the CONF_ID>0 the call is a conference call, for example: CALL 17 CONF_ID 0
+    * TYPE - call type, for example: CALL 17 TYPE OUTGOING_PSTN . Possible values:
+          o INCOMING_PSTN - incoming call from PSTN
+          o OUTGOING_PSTN - outgoing call to PSTN
+          o INCOMING_P2P - incoming call from P2P
+          o OUTGOING_P2P - outgoing call to P2P 
+    * STATUS - call status, for example: CALL 17 STATUS FAILED . Possible values:
+          o UNPLACED - call was never placed
+          o ROUTING - call is currently being routed
+          o EARLYMEDIA - with pstn it is possible that before a call is established, early media is played. For example it can be a calling tone or a waiting message such as all operators are busy.
+          o FAILED - call failed - try to get a FAILUREREASON for more information.
+          o RINGING - currently ringing
+          o INPROGRESS - call is in progress
+          o ONHOLD - call is placed on hold
+          o FINISHED - call is finished
+          o MISSED - call was missed
+          o REFUSED - call was refused
+          o BUSY - destination was busy
+          o CANCELLED (Protocol 2)
+          o TRANSFERRING - Refer to ALTER CALL TRANSFER command. Added in protocol 7 (API version 3.0)
+          o TRANSFERRED - Refer to ALTER CALL TRANSFER command. Added in protocol 7 (API version 3.0)
+          o VM_BUFFERING_GREETING - voicemail greeting is being downloaded
+          o VM_PLAYING_GREETING - voicemail greeting is being played
+          o VM_RECORDING - voicemail is being recorded
+          o VM_UPLOADING - voicemail recording is finished and uploaded into server
+          o VM_SENT - voicemail has successfully been sent
+          o VM_CANCELLED - leaving voicemail has been cancelled
+          o VM_FAILED - leaving voicemail failed; check FAILUREREASON
+          o WAITING_REDIAL_COMMAND - This status is set when your outgoing call to PSTN gets rejected by remote party. This state was added in version 3.5 (protocol 8).
+          o REDIAL_PENDING - This status is set when you press redial button on the Call Phones tab of the Skype interface. This state was added in version 3.5 (protocol 8). 
+    * VIDEO_STATUS - possible values:
+          o VIDEO_NONE
+          o VIDEO_SEND_ENABLED
+          o VIDEO_RECV_ENABLED
+          o VIDEO_BOTH_ENABLED 
+    * VIDEO_SEND_STATUS and VIDEO_RECEIVE_STATUS - possible values:
+          o NOT_AVAILABLE - the client does not have video capability because video is disabled or a webcam is unplugged).
+          o AVAILABLE - the client is video-capable but the video is not running (can occur during a manual send).
+          o STARTING - the video is sending but is not yet running at full speed.
+          o REJECTED - the receiver rejects the video feed (can occur during a manual receive).
+          o RUNNING - the video is actively running.
+          o STOPPING - the active video is in the process of stopping but has not halted yet.
+          o PAUSED - the video call is placed on hold. 
+    * FAILUREREASON - example: CALL 17 FAILUREREASON 1 (numeric).
+    * SUBJECT - not used.
+    * PSTN_NUMBER - example: CALL 17 PSTN_NUMBER 372123123 .
+    * DURATION - example: CALL 17 DURATION 0 .
+    * PSTN_STATUS - error string from gateway, in the case of a PSTN call, for example: CALL 26 PSTN_STATUS 6500 PSTN connection creation timeout .
+    * CONF_PARTICIPANTS_COUNT - number of non-hosts in the case of a conference call. Possible values are:
+          o 0 - call is not a conference. For the host, CONF_PARTICIPANTS_COUNT is always 0.
+          o 1 - call is a former conference.
+          o 2, 3, 4 - call is a conference. Note that from 2.5 and upwards, Skype API manages conference participation in a slightly different manner. In newer versions, after the call is finished, the CONF_PARTICIPANTS_COUNT reports highest number of participants the call had at any given time. 
+    * CONF_PARTICIPANT n - the username of the nth participant in a conference call, the call type and status and the displayname of participants who are not the host. For example: CALL 59 CONF_PARTICIPANT 1 echo123 INCOMING_P2P INPROGRESS Echo Test Service .
+    * VM_DURATION
+    * VM_ALLOWED_DURATION - maximum duration in seconds allowed to leave voicemail
+    * RATE – expressed as cost per minute (added in protocol 6).
+    * RATE_CURRENCY - EUR|USD.. This property gets populated from currency selected in Skype account details - PSTN_BALANCE_CURRENCY property of the PROFILE object. However, the value of PSTN_BALANCE_CURRENCY can change in time (added in protocol 6).
+    * RATE_PRECISION – the number of times to divide RATE by 10 to get the full currency unit. For example, a RATE of 1234 with RATE_PRECISION of 2 amounts to 12.34 (added in protocol 6).
+    * INPUT - New in API version 2.6 Refer to Voice Streams section for more information. Can have following values:
+          o SOUNDCARD="default" - default is currently the only acceptable value.
+          o PORT="port_no" - the ID of the audio port (1..65535)
+          o FILE="filename.wav" - the path and name of the audio file. 
+    * OUTPUT - can have all the same values as INPUT property. Refer to Voice Streams section for more information. New in API version 2.6
+    * CAPTURE_MIC - can have all the same values as INPUT and OUTPUT properties. Refer to Voice Streams section for more information. New in API version 2.6
+    * VAA_INPUT_STATUS - true|false, indicates if voice input is enabled. New in API version 2.6
+    * FORWARDED_BY - Contains identity of the user who forwarded a call. If the user who forwarded the call could not be identified then this property will be set to "?". New in API version 2.6
+    * TRANSFER_ACTIVE - Refer to ALTER CALL TRANSFER command. Added in protocol 7 (API version 3.0)
+    * TRANSFER_STATUS - Refer to ALTER CALL TRANSFER command. Added in protocol 7 (API version 3.0)
+    * TRANSFERRED_BY - Refer to ALTER CALL TRANSFER command. Added in protocol 7 (API version 3.0)
+    * TRANSFERRED_TO - Refer to ALTER CALL TRANSFER command. Added in protocol 7 (API version 3.0) 
+
+Notes
+
+    * Status values for voicemails ( VM_xxx ) and VM_DURATION/VM_ALLOWED_DURATION apply to calls which are forwarded into voicemail. This feature was introduced in protocol 5. 
+
+Most call properties are read-only. The following properties are read-write and can be modified with the SET command:
+
+    * STATUS - for call control. Possible values:
+          o ONHOLD - hold call
+          o INPROGRESS - answer or resume call
+          o FINISHED - hang up call 
+    * SEEN - sets call as seen, so that a missed call is seen and can be removed from the missed calls list.
+    * DTMF - sends VALUE as DTMF. Permitted symbols in VALUE are: {0..9,#,*}.
+    * JOIN_CONFERENCE - joins call with another call into conference. VALUE is the ID of another call.
+    * START_VIDEO_SEND - starts sending video on a call.
+    * STOP_VIDEO_SEND - stops sending video on a call.
+    * START_VIDEO_RECEIVE - starts receiving video on a call.
+    * STOP_VIDEO_RECEIVE - stops receiving video on a call. 
+=end
+    class Call < Base
       attr_accessor :timestamp, :partner_handle, :partner_dispname, :target_identity, :conf_id, :type, :status, :video_status, :video_send_status, :failurereason, :subject, :pstn_number, :duration, :pstn_status, :conf_participants_count, :conf_participant, :vm_duration, :vm_allowed_duration, :rate, :rate_currency, :rate_precision, :input, :output, :capture_mic, :vaa_input_status, :forwarded_by, :transfer_active, :transfer_status, :transferred_by, :transferred_to
 
       PROPERTIES = %w{TIMESTAMP  PARTNER_HANDLE   PARTNER_DISPNAME  TARGET_IDENTITY  CONF_ID  TYPE  STATUS  VIDEO_STATUS  VIDEO_SEND_STATUS  FAILUREREASON  SUBJECT  PSTN_NUMBER  DURATION  PSTN_STATUS  CONF_PARTICIPANTS_COUNT  CONF_PARTICIPANT  VM_DURATION  VM_ALLOWED_DURATION  RATE  RATE_CURRENCY  RATE_PRECISION  INPUT  OUTPUT  CAPTURE_MIC  VAA_INPUT_STATUS  FORWARDED_BY  TRANSFER_ACTIVE  TRANSFER_STATUS  TRANSFERRED_BY  TRANSFERRED_TO}
@@ -49,30 +266,259 @@ module SkypeR
       end
     end
 
-    class Chat
+=begin
+CHAT object
+
+Version
+
+    * Protocol 3 (updated in protocol 7) 
+
+Properties
+
+    * NAME - chat ID, for example CHAT #test_l/$6a072ce5537c4044 NAME #test_l/$6a072ce5537c4044
+    * TIMESTAMP - time when chat was created, for example CHAT #test_l/$6a072ce5537c4044 TIMESTAMP 1078958218
+    * ADDER - user who added the current user to chat, for example CHAT 1078958218 ADDER k6rberebane
+    * STATUS - chat status, for example CHAT #test_l/$6a072ce5537c4044 STATUS MULTI_SUBSCRIBED . Possible values:
+          o LEGACY_DIALOG - old style IM
+          o DIALOG - 1:1 chat.
+          o MULTI_SUBSCRIBED - participant in chat
+          o UNSUBSCRIBED - left chat 
+    * POSTERS - members who have posted messages, for example CHAT #test_l/$6a072ce5537c4044 POSTERS k6rberebane test_3
+    * MEMBERS - all users who have been there, for example CHAT #test_l/$6a072ce5537c4044 MEMBERS k6rberebane test test_2 test_3
+    * TOPIC - chat topic. Example: CHAT #test_l/$6a072ce5537c4044 TOPIC API testimine
+    * TOPICXML - set when a chat topic contains XML formatting elements (topic was changed with ALTER CHAT SETTOPICXML command) This property works in parallel with TOPIC property - when TOPICXML is set, the value is stripped of XML tags and updated in TOPIC.
+    * CHATMESSAGES - all messages IDs in this chat, for example CHAT #test_l/$6a072ce5537c4044 CHATMESSAGES 34, 35, 36, 38, 39
+    * ACTIVEMEMBERS - members who have stayed in chat, for example CHAT #test_l/$6a072ce5537c4044 ACTIVEMEMBERS k6rberebane test_2 test_3
+    * FRIENDLYNAME - name shown in chat window title, for example CHAT #test_l/$6a072ce5537c4044 FRIENDLYNAME Test Test XX | tere ise ka
+    * CHATMESSAGES - list of chatmessage identifiers
+    * RECENTCHATMESSAGES - list of missed/recent chatmessage identifiers
+    * BOOKMARKED - TRUE|FALSE (added in protocol version 6 / Skype API version 2.5) 
+
+Following properties were added to CHAT object in protocol 7 (API version 3.0):
+
+    * MEMBEROBJECTS - contains the list of CHATMEMBER object IDs. Refer to
+          o CHATMEMBER object for list of properties
+          o GET CHATMEMBER command on how to access those properties.
+          o GET CHAT MEMBEROBJECTS command on how to get a list of chatmember object IDs for a given chat. 
+    * PASSWORDHINT - contains password hint text for the chat object. Refer to ALTER CHAT SETPASSWORD command on how to set chat passwords.
+    * GUIDELINES - contains chat guidelines text. Refer to ALTER CHAT SETGUIDELINES command on how to set chat guidelines.
+    * OPTIONS - bitmap of chat options. Refer to ALTER CHAT SETOPTIONS command for more information.
+    * DESCRIPTION - currently used only for hidden synchronization channels for managing shared groups.
+    * DIALOG_PARTNER - the handle of the dialog partner for dialog type chats (chats with two participants).
+    * ACTIVITY_TIMESTAMP - the UNIX timestamp of last activity.
+    * TYPE - chat type with following possible values:
+          o LEGACY_DIALOG - no longer supported.
+          o DIALOG - a chat with only two participants.
+          o MULTICHAT - a chat with more than two participants.
+          o SHAREDGROUP - a chat used for synchronization of shared contact groups.
+          o LEGACY_UNSUBSCRIBED - no longer supported. 
+    * MYSTATUS - user's current status in chat. Possible values are:
+          o CONNECTING - status set when the system is trying to connect to the chat.
+          o WAITING_REMOTE_ACCEPT - set when a new user joins a public chat. When the chat has "participants need authorization to read messages" option, the MYSTATUS property of a new applicant will remain in this status until he gets accepted or rejected by a chat administrator. Otherwise user's MYSTATUS will automatically change to either LISTENER or USER, depending on public chat options.
+          o ACCEPT_REQUIRED - this status is used for shared contact groups functionality.
+          o PASSWORD_REQUIRED - status set when the system is waiting for user to supply the chat password.
+          o SUBSCRIBED - set when user joins the chat.
+          o UNSUBSCRIBED - set when user leaves the chat or chat ends.
+          o CHAT_DISBANDED - status set when the chat is disbanded.
+          o QUEUED_BECAUSE_CHAT_IS_FULL - currently the maximum number of people in the same chat is 100.
+          o APPLICATION_DENIED - set when public chat administrator has rejected user from joining.
+          o KICKED - status set when the user has been kicked from the chat. Note that it is possible for the user to re-join the chat after being kicked.
+          o BANNED - status set when the user has been banned from the chat.
+          o RETRY_CONNECTING - status set when connect to chat failed and system retries to establish connection. 
+    * MYROLE - user's privilege level in chat Refer to CHAT ROLES section for more information.
+    * BLOB - for public chats, this property contains encoded list of chat join-points. Contents of this field is used in public chat URLs.
+    * APPLICANTS - this property contains list of skypenames of people who have applied to join the chat but have not yet been accepted by a public chat administrator. Users only become applicants when the chat has JOINERS_BECOME_APPLICANTS option. Refer to ALTER CHAT SETOPTIONS command for more information. 
+
+=end
+    class Chat < Base
+      attr_accessor :name, :members, :timestamp, :status
+
       def initialize(args={})
         @name = args[:name] if args[:name]
+        @members = args[:members] if args[:members]
         @timestamp = args[:timestamp] if args[:timestamp]
         @status = args[:status] if args[:status]
       end
+
     end
 
-    class ChatMessage
+=begin
+CHATMESSAGE object
+
+Version
+
+    * Protocol 3. Supersedes the MESSAGE object. Updated in protocol 7. Note that when your application connects to Skype, "PROTOCOL 7" command must be sent to Skype before your client can recognize new message types added in protocol 7. Connecting with default protocol (protocol 1) will cause new message types being reported as UNKNOWN. 
+
+Properties
+
+    * TIMESTAMP - time when message was sent (UNIX timestamp), for example MESSAGE 21 TIMESTAMP 1078958218
+    * PARTNER_HANDLE - NB! This property is deprecated since API version 3.0 and replaced with FROM_HANDLE.
+    * PARTNER_DISPNAME - NB! This property is deprecated since API version 3.0 and replaced with FROM_DISPNAME.
+    * FROM_HANDLE - skypename of the originator of the chatmessage.
+    * FROM_DISPNAME - displayed name of the originator of the chatmessage.
+    * TYPE - message type, for example MESSAGE 21 TYPE TEXT . Possible values:
+          o SETTOPIC - change of chat topic
+          o SAID - IM
+          o ADDEDMEMBERS - invited someone to chat
+          o SAWMEMBERS - chat participant has seen other members
+          o CREATEDCHATWITH - chat to multiple people is created
+          o LEFT - someone left chat; can also be a notification if somebody cannot be added to chat
+          o POSTEDCONTACTS - system message that is sent or received when one user sends contacts to another. Added in protocol 7.
+          o GAP_IN_CHAT - messages of this type are generated locally, during synchronization, when a user enters a chat and it becomes apparent that it is impossible to update user's chat history completely. Chat history is kept only up to maximum of 400 messages or 2 weeks. When a user has been offline past that limit, GAP_IN_CHAT notification is generated. Added in protocol 7.
+          o SETROLE - system messages that are sent when a chat member gets promoted or demoted. Refer to ALTER CHATMEMBER SETROLETO command for more info on how to change chat member roles. Added in protocol 7.
+          o KICKED - system messages that are sent when a chat member gets kicked. Refer to ALTER CHAT KICK command for more information. Added in protocol 7.
+          o KICKBANNED - system messages that are sent when a chat member gets banned. Refer to ALTER CHAT KICKBAN command for more information. Added in protocol 7.
+          o SETOPTIONS - system messages that are sent when chat options are changed. Refer to ALTER CHAT SETOPTIONS command for more information. Added in protocol 7.
+          o SETPICTURE - system messages that are sent when a chat member has changed the public chat topic picture. Added in protocol 7.
+          o SETGUIDELINES - system messages that are sent when chat guidelines are changed. Refer to ALTER CHAT SETGUIDELINES command for more information. Added in protocol 7.
+          o JOINEDASAPPLICANT - notification message that gets sent in a public chat with JOINERS_BECOME_APPLICANTS options, when a new user joins the chat. See ALTER CHAT SETOPTIONS command for more information on chat options. Added in protocol 7.
+          o UNKNOWN - unknown message type, possibly due to connecting to Skype with older protocol. 
+    * STATUS - message status, for example MESSAGE 21 STATUS QUEUED . Possible values:
+          o SENDING - message is being sent
+          o SENT - message was sent
+          o RECEIVED - message has been received
+          o READ - message has been read 
+    * LEAVEREASON - used with LEFT type message, for example CHATMESSAGE 21 LEAVEREASON UNSUBSCRIBE . Possible values:
+          o USER_NOT_FOUND - user was not found
+          o USER_INCAPABLE - user has an older Skype version and cannot join multichat
+          o ADDER_MUST_BE_FRIEND - recipient accepts messages from contacts only and sender is not in his/her contact list
+          o ADDED_MUST_BE_AUTHORIZED - recipient accepts messages from authorized users only and sender is not authorized
+          o UNSUBSCRIBE - participant left chat 
+    * CHATNAME - chat that includes the message, for example #test_3/$b17eb511457e9d20
+    * USERS - people added to chat
+    * IS_EDITABLE - TRUE|FALSE Refer to SET CHATMESSAGE BODY command for more information on how to edit chat message text (BODY) and on what conditions is such editing permitted. This property was introduced in API version 3.0
+    * EDITED_BY - identity of the last user who edited the message. New in API version 3.0
+    * EDITED_TIMESTAMP - UNIX timestamp of the last edit. New in API version 3.0
+    * OPTIONS - numeric field that contains chat options bitmap in system messages that get sent out when a change is made to chat options (messages where TYPE is SETOPTIONS). In normal messages the value of this field is 0. Refer to ALTER CHAT SETOPTIONS command for more information.
+    * ROLE - used in system messages that get sent when a public chat administrator has promoted or demoted a chat member. The TYPE property of such messages is set to SETROLE. In these messages the value of this field is set to the new assigned role of the promoted or demoted chat member. In normal messages the value of this property is set to UNKNOWN. Refer to CHAT ROLES section for a list of different chat roles and ALTER CHATMEMBER SETROLETO command for how chat roles can be changed. New in API version 3.0 
+
+Most chatmessage properties are read-only. The following property is read-write and can be modified with the SET command:
+
+    * SEEN - mark missed chatmessage as seen and removes chat from missed events.
+    * BODY - message text. Note that this property was read-only prior to API version 3.0 
+=end
+    class ChatMessage < Base
       def initialize(args={})
         @timestamp = args[:timestamp] if args[:timestamp]
-        @partner_handle = args[:partner_handle] if args[:partner_handle]
+        @from_handle = args[:from_handle] if args[:from_handle]
+        @status = args[:from_handle] if args[:status] # SENDING | SENT | RECEIVED | READ
+        @body = args[:from_handle] if args[:body]
+        raise "deprecated"  if args[:partner_handle]
       end
     end
 
-    class Application
+=begin
+APPLICATION object
+
+Properties
+
+    * CONNECTABLE - query connectable users. NB! From API version 3.0, this property enters the deprecation process.
+
+      -> GET APPLICATION appname CONNECTABLE
+      <- APPLICATION appname CONNECTABLE [username[ username]*]
+
+    * CONNECTING - query on-going connection process after the connection is established. Username is removed from CONNECTING list.
+
+      -> GET APPLICATION appname CONNECTING
+      <- APPLICATION appname CONNECTING [username[ username]*]
+
+    * STREAMS - query open streams (connections)
+
+      -> GET APPLICATION appname STREAMS
+      <- APPLICATION appname STREAMS [username:id[ username:id]*]
+
+    * SENDING - query if currently sending any data. After the data is sent, the stream name is removed from the SENDING list
+
+      -> GET APPLICATION appname RECIEVED
+      <- APPLICATION appname SENDING [username:id=bytes [username:id bytes]*]
+
+    * Note: In Skype 1.4x, the number of bytes reported by the SENDING notification following an APPLICATION WRITE is 2 bytes longer than that which was written.
+
+      -> alter application exe write testtest20:1 w
+      <- ALTER APPLICATION exe WRITE testtest20:1
+      <- APPLICATION exe SENDING testtest20:1 3
+      -> alter application exe write testtest20:1 1234567890
+      <- ALTER APPLICATION exe WRITE testtest20:1
+      <- APPLICATION exe SENDING testtest20:1 12
+
+    * RECEIVED - query if there is data waiting in received buffer. After the data is read from the stream, the stream name is removed from the RECEIVED list.
+
+      -> GET APPLICATION appname RECEIVED
+      <- APPLICATION appname SENDING [username:id=bytes [username:id bytes]*]
+
+    * incoming datagram notification
+
+      <- APPLICATION appname DATAGRAM user:id text
+
+Version
+
+    * Protocol 5
+    * Skype for Windows 1.4 
+=end
+
+    class Application < Base
       def initialize(args={})
         @connectable = args[:connectable] if args[:connectable]
         @streams = args[:streams] if args[:streams]
         @sending = args[:sending] if args[:sending]
       end
     end
+=begin
+VOICEMAIL object
+
+Version
+
+    * Protocol 5 
+
+Properties
+
+    * TYPE - type of voicemail object
+          o INCOMING - voicemail received from partner
+          o OUTGOING - voicemail sent to partner
+          o DEFAULT_GREETING - Skype default greeting from partner
+          o CUSTOM_GREETING - partner's recorded custom greeting
+          o UNKNOWN 
+    * PARTNER_HANDLE - username for voicemail sender (for incoming) or recipient (for outgoing)
+    * PARTNER_DISPNAME - user displayname for partner
+    * STATUS - current status of voicemail object
+          o NOTDOWNLOADED - voicemail is stored on server (has not been downloaded yet)
+          o DOWNLOADING - downloading from server to local machine
+          o UNPLAYED - voicemail has been downloaded but not played back yet
+          o BUFFERING - buffering for playback
+          o PLAYING - currently played back
+          o PLAYED - voicemail has been played back
+          o BLANK - intermediate status when new object is created but recording has not begun
+          o RECORDING - voicemail currently being recorded
+          o RECORDED - voicemail recorded but not yet uploaded to the server
+          o UPLOADING - voicemail object is currently being uploaded to server
+          o UPLOADED - upload to server finished but not yet deleted; object is also locally stored
+          o DELETING - pending delete
+          o FAILED - downloading voicemail/greeting failed
+          o UNKNOWN 
+    * FAILUREREASON possible values
+          o MISC_ERROR
+          o CONNECT_ERROR
+          o NO_VOICEMAIL_PRIVILEGE
+          o NO_SUCH_VOICEMAIL
+          o FILE_READ_ERROR
+          o FILE_WRITE_ERROR
+          o RECORDING_ERROR
+          o PLAYBACK_ERROR
+          o UNKNOWN 
+    * SUBJECT - not used
+    * TIMESTAMP
+    * DURATION - actual voicemail duration in seconds
+    * ALLOWED_DURATION - maximum voicemail duration in seconds allowed to leave to partner
+    * INPUT - New in API version 3.5.0.202 Can have following values:
+          o SOUNDCARD="default" - default is currently the only acceptable value.
+          o PORT="port_no" - the ID of the audio port (1..65535)
+          o FILE="filename.wav" - the path and name of the audio file. 
+    * OUTPUT - can have all the same values as INPUT property. New in API version 3.5.0.202
+    * CAPTURE_MIC - can have all the same values as INPUT and OUTPUT properties. New in API version 3.5.0.202 
+
+=end
 
-    class VoiceMail
+    class VoiceMail < Base
     end
 
   end