stripe-dotnet v20.0

[ob-stripe]

This PR will be used for ongoing work on the library to merge multiple PRs introducing large breaking changes to the library

Done:

(❗️= breaking changes)

• ❗️ Properly re-architecture the library to handle various source abstractions (Properly re-architecture the library to handle various source abstractions #1275)
• ❗️ Fix usage of INestedOptions to properly use the parent property's JSON name (Rewrite parameter encoding logic #1276)
• ❗️ Fix naming for SourceTransactionCanceled event type (Rename event to match type name and add a related one. #1282)
• Handle DateTimes directly in the encoder ( Handle DateTimes directly in the encoder #1283)
• ❗️ Remove StripeDeleted and add Deleted to relevant resources instead (Remove StripeDeleted entirely. #1284)
• ❗️ Rename properties starting with a lower case letter (Rename two properties that start with a lower case letter #1285)
• ❗️ Rename all files and classes to remove the Stripe prefix (Remove Stripe prefix on all API classes #1252)
• ❗️ Fix services (Fix ScheduledQueryRun naming #1286, Fix signatures in InvoiceService and RefundService #1287, Fix FileUploadService #1288, BalanceTransactionService #1291)
• Use interfaces for common methods on services (Service interfaces #1269)
• Make all value types in options classes nullable (Make all value types in options classes nullable #1298)
• ❗️ Upgrade to API version 2018-09-24 (Upgrade to API version 2018-09-24 #1302)
• ❗️ Convert all options class to reflect the API level structure, and rename DateFilter to DateRangeOptions (Convert all options to have one class per level in the JSON params #1301)
• ❗️ Rename LiveMode to Livemode (Rename LiveMode to Livemode #1303)
• Sanitize files (Sanitize files #1304, Remove +x flag from source files #1306)
• Use BasicService for all services (Move all services to BasicService #1305)
• Sort service methods alphabetically (Sort service methods alphabetically #1307)
• Verify requests in tests (Verifying requests in tests #1310)
• ❗️ Better URL handling in services (Better URL handling in services #1308)
• Group files by API resource like we started for sources for example: (Group resources with sub-resources under one folder #1309, Move tests to their own folder #1312)
• ❗️ Add missing properties on resources and removed incorrect ones along with a few fields being renamed to match the API (Ensure all properties are on resources #1311)
• ❗️ Add support for the InvoiceItem resource and keep InvoiceLineItem to describe a line item on an invoice (Add support for InvoiceItem separate from InvoiceLineItem #1315)
• Automatically deserialize Unix timestamps into DateTimes (Automatically convert Unix timestamps to DateTimes #1316)
• Create coverage report and upload to coveralls.io (Create coverage report and upload to coveralls.io #1318, Fix artifacts path in appveyor.yml #1319)
• Revamp interfaces on Stripe model classes (Revamp interfaces on Stripe model classes #1317)
• ❗️ Interfaces for polymorphic API resources (Interfaces for polymorphic API resources (external accounts and payment sources) #1320, Replace BalanceTransactionSource class by IBalanceTransactionSource interface #1321, Use IHasObject interface instead of dynamic for data.object attribute of event objects #1322 )
• Fix warnings in .NET Framework specific code (Fix warnings in .NET Framework specific code #1323)
• Add some missing tests (Add some missing tests #1328)
• ❗️ Use an interface for PaymentIntentSourceAction (Use an interface for PaymentIntentSourceAction #1329)
• ❗️ Use longs instead of ints (Use longs instead of ints #1331)
• ❗️ Change the interface for UsageRecord methods to take a subscription item id (Usage record methods now take the subscription item id as a parameter #1340)
• ❗️ Renamed SourceTokenOrExistingSourceId to SourceId (Rename SourceTokenOrExistingSourceId to SourceId #1337)
• Add support for charge.expired (Add support for charge.expired #1345)

Fixes #1164 (via #1283).
Fixes #1260 (via #1269).
Fixes #1281 (via #1282).
Fixes #1330 (via #1331).
Fixes #1344 (via #1345).

We decided not to change how object expansion work for now. The current behaviour is more verbose but is clearer for the developers using the library so we will keep the approach of having 2 properties (a string ResourceId and the object Resource with the ResourceInternal that does the right handling).

[ob-stripe]

Okay, I've removed the WIP tag and rebased on master.

r? @remi-stripe for another set of 👀 before I pull this in

[ob-stripe]

Pulling this in 🎉

[ob-stripe]

Released as 20.0.0.

[buvinghausen]

Why was ISupportMetadata removed and nothing equivalent put in it's place? I have extension methods that use that interface in order to return strongly typed values from the meta data and now I have to write each extension method for each object separately. That's a giant pain in the ass I didn't need.

[ob-stripe]

@buvinghausen We removed it because it no longer served a purpose internally and we hadn't considered that it might be directly used by users. I don't see a problem with adding it back, though we'd rename it IHasMetadata to be consistent with the new IHasId and IHasObject interfaces.

[buvinghausen]

@ob-stripe I'm totally cool with an IHasMetadata replacement....