From d0ae74356b68cd80b6464cfa96a830aea687f7ab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ros=C3=A1rio=20Pereira=20Fernandes?=
 <rosariofernandes51@gmail.com>
Date: Thu, 13 Aug 2020 18:39:20 +0200
Subject: [PATCH] docs(fdl-ktx): document kotlin destructuring declarations

---
 docs/ktx/dynamic-links.md | 37 +++++++++++++++++++++++++++++++++----
 1 file changed, 33 insertions(+), 4 deletions(-)

diff --git a/docs/ktx/dynamic-links.md b/docs/ktx/dynamic-links.md
index 61f4c99b013..187dade8b41 100644
--- a/docs/ktx/dynamic-links.md
+++ b/docs/ktx/dynamic-links.md
@@ -102,6 +102,11 @@ FirebaseDynamicLinks.getInstance().createDynamicLink()
             // Short link created
             val shortLink = result.shortLink
             val flowchartLink = result.previewLink
+            val warnings = result.warnings
+
+            // do something with the links and warnings
+            showLinks(shortLink, flowchartLink)
+            displayWarnings(warnings)
         }
         .addOnFailureListener {
             // Error
@@ -114,10 +119,10 @@ FirebaseDynamicLinks.getInstance().createDynamicLink()
 Firebase.dynamicLinks.shortLinkAsync {
     longLink = Uri.parse("https://example.page.link/?link=" +
         "https://www.example.com/&apn=com.example.android&ibn=com.example.ios")
-}.addOnSuccessListener { result ->
-    // Short link created
-    val shortLink = result.shortLink
-    val flowchartLink = result.previewLink
+}.addOnSuccessListener { (shortLink, flowchartLink, warnings) ->
+    // do something with the links and warnings
+    showLinks(shortLink, flowchartLink)
+    displayWarnings(warnings)
 }.addOnFailureListener {
     // Error
     // ...
@@ -139,3 +144,27 @@ val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync(ShortDynamicLink.Suffix
     // ...
 }
 ```
+
+### Receive deep links
+
+**Kotlin**
+```kotlin
+Firebase.dynamicLinks
+        .getDynamicLink(intent)
+        .addOnSuccessListener(this) { pendingDynamicLinkData ->
+            val deepLink = pendingDynamicLinkData.link
+            val minAppVersion = pendingDynamicLinkData.minimumAppVersion
+            val clickTimestamp = pendingDynamicLinkData.clickTimestamp
+
+            // TODO(developer): handle the deepLink
+        }.addOnFailureListener { /* ... */ }
+```
+
+**Kotlin + KTX**
+```kotlin
+Firebase.dynamicLinks
+        .getDynamicLink(intent)
+        .addOnSuccessListener(this) { (deepLink, minAppVersion, clickTimestamp) ->
+            // TODO(developer): handle the deepLink
+        }.addOnFailureListener { /* ... */ }
+```