Merge pull request #38 from solid-software/sources

Add customer/:id/sources resource partial models, list request

Author: yurii-prykhodko-solid

lib/messages.dart

@@ -53,6 +53,7 @@ part 'src/messages/requests/update_subscription.dart';
 part 'src/messages/requests/update_subscription_item.dart';
 part 'src/messages/requests/update_subscription_schedule.dart';
 part 'src/messages/shipping_specification.dart';
+part 'src/messages/source.dart';
 part 'src/messages/stripe_api_error.dart';
 part 'src/messages/subscription.dart';
 part 'src/messages/subscription_item.dart';

lib/messages.g.dart

@@ -4,3 +4,5 @@ export 'enums/payment_behavior.dart';
 export 'enums/proration_behavior.dart';
 export 'enums/stripe_api_error_type.dart';
 export 'enums/pause_collection_behavior.dart';
+export 'enums/source_type.dart';
+export 'enums/source_status.dart';

lib/src/messages/enums.dart

@@ -0,0 +1,18 @@
+import 'package:json_annotation/json_annotation.dart';
+
+@Deprecated('''Stripe doesn't recommend using the deprecated Sources API.
+We recommend that you adopt the PaymentMethods API.
+This newer API provides access to our latest features and payment method types.
+''')
+enum SourceStatus {
+  @JsonValue('canceled')
+  canceled,
+  @JsonValue('chargeable')
+  chargeable,
+  @JsonValue('consumed')
+  consumed,
+  @JsonValue('failed')
+  failed,
+  @JsonValue('pending')
+  pending,
+}

lib/src/messages/enums/source_status.dart

@@ -0,0 +1,40 @@
+import 'package:json_annotation/json_annotation.dart';
+
+@Deprecated('''Stripe doesn't recommend using the deprecated Sources API.
+We recommend that you adopt the PaymentMethods API.
+This newer API provides access to our latest features and payment method types.
+''')
+enum SourceType {
+  @JsonValue('ach_credit_transfer')
+  achCreditTransfer,
+  @JsonValue('ach_debit')
+  achDebit,
+  @JsonValue('alipay')
+  alipay,
+  @JsonValue('bancontact')
+  bancontact,
+  @JsonValue('card')
+  card,
+  @JsonValue('card_present')
+  cardPresent,
+  @JsonValue('eps')
+  eps,
+  @JsonValue('giropay')
+  giropay,
+  @JsonValue('ideal')
+  ideal,
+  @JsonValue('multibanco')
+  multibanco,
+  @JsonValue('klarna')
+  klarna,
+  @JsonValue('p24')
+  p24,
+  @JsonValue('sepa_debit')
+  sepaDebit,
+  @JsonValue('sofort')
+  sofort,
+  @JsonValue('three_d_secure')
+  threeDSecure,
+  @JsonValue('wechat')
+  wechat,
+}

lib/src/messages/enums/source_type.dart

@@ -0,0 +1,47 @@
+part of '../../messages.dart';
+
+/// Source objects allow you to accept a variety of payment methods.
+/// They represent a customer’s payment instrument,
+/// and can be used with the Stripe API just like a Card object:
+/// once chargeable, they can be charged, or can be attached to customers.
+@Deprecated('''Stripe doesn't recommend using the deprecated Sources API.
+We recommend that you adopt the PaymentMethods API. 
+This newer API provides access to our latest features and payment method types.
+''')
+@JsonSerializable()
+class Source extends Message {
+  final String id;
+  final String object;
+  final int? amount;
+
+  @TimestampConverter()
+  final DateTime created;
+  final String? currency;
+  final String? customer;
+  final String? flow;
+  final bool livemode;
+  final String? statementDescriptor;
+  final String status;
+  final SourceType type;
+  final String usage;
+
+  const Source({
+    required this.id,
+    required this.object,
+    required this.amount,
+    required this.created,
+    required this.currency,
+    required this.customer,
+    required this.flow,
+    required this.livemode,
+    required this.statementDescriptor,
+    required this.status,
+    required this.type,
+    required this.usage,
+  });
+
+  factory Source.fromJson(Map<String, dynamic> json) => _$SourceFromJson(json);
+
+  @override
+  Map<String, dynamic> toJson() => _$SourceToJson(this);
+}

lib/src/messages/source.dart

@@ -1,12 +1,17 @@
 import 'dart:async';
 
 import 'package:stripe/messages.dart';
+import 'package:stripe/src/resources/source.dart';
 
 import '../client.dart';
 import '_resource.dart';
 
 class CustomerResource extends Resource<Customer> {
-  CustomerResource(Client client) : super(client);
+  final Client _client;
+
+  CustomerResource(Client client)
+      : _client = client,
+        super(client);
 
   Future<Customer> create(CreateCustomerRequest request) async {
     final response = await post('customers', data: request.toJson());
@@ -40,4 +45,12 @@ class CustomerResource extends Resource<Customer> {
 
     return customer;
   }
+
+  @Deprecated('''Stripe doesn't recommend using the deprecated Sources API.
+We recommend that you adopt the PaymentMethods API.
+This newer API provides access to our latest features and payment method types.
+''')
+  SourceResource sources(String customerId) {
+    return SourceResource(_client, customerId);
+  }
 }

lib/src/resources/customer.dart

@@ -0,0 +1,28 @@
+import 'dart:async';
+
+import 'package:stripe/messages.dart';
+
+import '../client.dart';
+import '_resource.dart';
+
+/// Source objects allow you to accept a variety of payment methods.
+/// They represent a customer’s payment instrument,
+/// and can be used with the Stripe API just like a Card object:
+/// once chargeable, they can be charged, or can be attached to customers.
+@Deprecated('''Stripe doesn't recommend using the deprecated Sources API.
+We recommend that you adopt the PaymentMethods API.
+This newer API provides access to our latest features and payment method types.
+''')
+class SourceResource extends Resource<Subscription> {
+  final String customerId;
+
+  String get _resourcePath => 'customers/$customerId/sources';
+
+  SourceResource(Client client, this.customerId) : super(client);
+
+  Future<DataList<Source>> list() async {
+    final map = await get(_resourcePath);
+    return DataList<Source>.fromJson(
+        map, (value) => Source.fromJson(value as Map<String, dynamic>));
+  }
+}