res_stasis: Enable transfers and provide events when they occur.

This change enables transfers within ARI created bridges and adds events
for when they occur. Unlike other events these will be received if *any*
subscribed object is involved in the transfer.

(closes issue ASTERISK-22984)
Reported by: David M. Lee

Review: https://reviewboard.asterisk.org/r/3120/
........

Merged revisions 407153 from http://svn.asterisk.org/svn/asterisk/branches/12


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@407154 65c4cc65-6c06-0410-ace0-fbb531ad65f3

1 files changed, 100 insertions, 0 deletions

diff --git a/rest-api/api-docs/events.json b/rest-api/api-docs/events.json
index b841485b3..e26eaa6c6 100644
--- a/rest-api/api-docs/events.json
+++ b/rest-api/api-docs/events.json
@@ -86,6 +86,8 @@
 				"BridgeCreated",
 				"BridgeDestroyed",
 				"BridgeMerged",
+				"BridgeBlindTransfer",
+				"BridgeAttendedTransfer",
 				"ChannelCreated",
 				"ChannelDestroyed",
 				"ChannelEnteredBridge",
@@ -211,6 +213,104 @@
 				}
 			}
 		},
+		"BridgeBlindTransfer": {
+			"id": "BridgeBlindTransfer",
+			"description": "Notification that a blind transfer has occurred.",
+			"properties": {
+				"channel": {
+					"description": "The channel performing the blind transfer",
+					"required": true,
+					"type": "Channel"
+				},
+				"exten": {
+					"description": "The extension transferred to",
+					"required": true,
+					"type": "string"
+				},
+				"context": {
+					"description": "The context transferred to",
+					"required": true,
+					"type": "string"
+				},
+				"result": {
+					"description": "The result of the transfer attempt",
+					"required": true,
+					"type": "string"
+				},
+				"is_external": {
+					"description": "Whether the transfer was externally initiated or not",
+					"required": true,
+					"type": "boolean"
+				},
+				"bridge": {
+					"description": "The bridge being transferred",
+					"type": "Bridge"
+				}
+			}
+		},
+		"BridgeAttendedTransfer": {
+			"id": "BridgeAttendedTransfer",
+			"description": "Notification that an attended transfer has occurred.",
+			"properties": {
+				"transferer_first_leg": {
+					"description": "First leg of the transferer",
+					"required": true,
+					"type": "Channel"
+				},
+				"transferer_second_leg": {
+					"description": "Second leg of the transferer",
+					"required": true,
+					"type": "Channel"
+				},
+				"result": {
+					"description": "The result of the transfer attempt",
+					"required": true,
+					"type": "string"
+				},
+				"is_external": {
+					"description": "Whether the transfer was externally initiated or not",
+					"required": true,
+					"type": "boolean"
+				},
+				"transferer_first_leg_bridge": {
+					"description": "Bridge the transferer first leg is in",
+					"type": "Bridge"
+				},
+				"transferer_second_leg_bridge": {
+					"description": "Bridge the transferer second leg is in",
+					"type": "Bridge"
+				},
+				"destination_type": {
+					"description": "How the transfer was accomplished",
+					"required": true,
+					"type": "string"
+				},
+				"destination_bridge": {
+					"description": "Bridge that survived the merge result",
+					"type": "string"
+				},
+				"destination_application": {
+					"description": "Application that has been transferred into",
+					"type": "string"
+				},
+				"destination_link_first_leg": {
+					"description": "First leg of a link transfer result",
+					"type": "Channel"
+				},
+				"destination_link_second_leg": {
+					"description": "Second leg of a link transfer result",
+					"type": "Channel"
+				},
+				"destination_threeway_channel": {
+					"description": "Transferer channel that survived the threeway result",
+					"type": "Channel"
+				},
+				"destination_threeway_bridge": {
+					"description": "Bridge that survived the threeway result",
+					"type": "Bridge"
+				}
+			}
+		},
 		"ChannelCreated": {
 			"id": "ChannelCreated",
 			"description": "Notification that a channel has been created.",