[Connect SDK] Enable downloads in the Connect SDK

[simond-stripe]

Summary

Adds a download listener so that when the user attempts to download a file via the webhook, it downloads in the background and shows a toast when it's done.

Note that we don't need storage permissions because the downloading is delegated to a system service that has higher permissions: https://developer.android.com/reference/android/app/DownloadManager.Request#setDestinationUri(android.net.Uri)

Motivation

Certain embedded components, such as the Payouts Component, provide the user the ability to download files.

Testing

• Added tests
• Modified tests
• Manually verified

Screenshots

demo-1731262880.mp4

[github-actions]

Diffuse output:

OLD: identity-example-release-base.apk (signature: V1, V2)
NEW: identity-example-release-pr.apk (signature: V1, V2)

          │          compressed          │         uncompressed         
          ├───────────┬───────────┬──────┼───────────┬───────────┬──────
 APK      │ old       │ new       │ diff │ old       │ new       │ diff 
──────────┼───────────┼───────────┼──────┼───────────┼───────────┼──────
      dex │     2 MiB │     2 MiB │  0 B │   4.1 MiB │   4.1 MiB │  0 B 
     arsc │     1 MiB │     1 MiB │  0 B │     1 MiB │     1 MiB │  0 B 
 manifest │   2.3 KiB │   2.3 KiB │  0 B │     8 KiB │     8 KiB │  0 B 
      res │ 301.8 KiB │ 301.8 KiB │  0 B │ 455.5 KiB │ 455.5 KiB │  0 B 
   native │   6.2 MiB │   6.2 MiB │  0 B │  15.8 MiB │  15.8 MiB │  0 B 
    asset │   7.1 KiB │   7.1 KiB │  0 B │   6.9 KiB │   6.9 KiB │  0 B 
    other │  90.2 KiB │  90.2 KiB │ +6 B │ 170.3 KiB │ 170.3 KiB │  0 B 
──────────┼───────────┼───────────┼──────┼───────────┼───────────┼──────
    total │   9.6 MiB │   9.6 MiB │ +6 B │  21.5 MiB │  21.5 MiB │  0 B 

 DEX     │ old   │ new   │ diff      
─────────┼───────┼───────┼───────────
   files │     1 │     1 │ 0         
 strings │ 19966 │ 19966 │ 0 (+0 -0) 
   types │  6188 │  6188 │ 0 (+0 -0) 
 classes │  4979 │  4979 │ 0 (+0 -0) 
 methods │ 29759 │ 29759 │ 0 (+0 -0) 
  fields │ 17526 │ 17526 │ 0 (+0 -0) 

 ARSC    │ old  │ new  │ diff 
─────────┼──────┼──────┼──────
 configs │  164 │  164 │  0   
 entries │ 3622 │ 3622 │  0

APK

   compressed    │  uncompressed   │                        
──────────┬──────┼──────────┬──────┤                        
 size     │ diff │ size     │ diff │ path                   
──────────┼──────┼──────────┼──────┼────────────────────────
 28.4 KiB │ +8 B │ 62.9 KiB │  0 B │ ∆ META-INF/CERT.SF     
  1.2 KiB │ -1 B │  1.2 KiB │  0 B │ ∆ META-INF/CERT.RSA    
 25.3 KiB │ -1 B │ 62.8 KiB │  0 B │ ∆ META-INF/MANIFEST.MF 
──────────┼──────┼──────────┼──────┼────────────────────────
 54.9 KiB │ +6 B │  127 KiB │  0 B │ (total)

[seankenkeremath-stripe]

i'd pass in the main scope like you're doing with io Scope to make it more testable

[seankenkeremath-stripe]

passing in all these lambdas feels a bit strange here. is there some kind of interface you can use here to abstract away the OS level functionality? that way you can just mock the interface.

This will likely make the code a lot easier to follow too

[seankenkeremath-stripe]

Maybe abstracting away and creating components for the following? Then this service could call StripeDownloadManager and you could mock all of these for your tests

StripeDownloadManager:

• startDownload(url, ua, ...,) : DownloadMetadata
• getDownloadProgress(Id): DownloadStatus

DownloadMetadata:

• id
• fileName

ToastManager

• showToast(string)

[seankenkeremath-stripe]

this static method feels like it should be behind some kind of interface if we want this class to be testable

[seankenkeremath-stripe]

I think the interface for the DownloadListener can be cleaned up a bit here. It doesn't have to be what i'm suggesting, but I think it's worth taking a stab at. Let me know what you think

[simond-stripe]

I think the interface for the DownloadListener can be cleaned up a bit here. It doesn't have to be what i'm suggesting, but I think it's worth taking a stab at. Let me know what you think

Good point, I think abstracting these behind an interface is a good idea.

@seankenkeremath-stripe I've updated the code and I find it's more idiomatic and easier to read now, but still pretty lightweight - let me know what you think

[seankenkeremath-stripe]

you may actually just want to make the toast manager call mainScope so you don't need to worry about it here. it will never be called on any other thread anyway

[seankenkeremath-stripe]

does this need to be part of the interface? sort of feels like an implementation detail

[seankenkeremath-stripe]

same with this one, with both of these it seems like the end result is just that you want the file name, and i'm wondering if you could just return that along with the ID when you start the DL request

[seankenkeremath-stripe]

Looks good! A few non-blocking suggestions

[seankenkeremath-stripe]

nice 👍