api: Add Subscription type, and deserialize at init

Author: gnprice

lib/api/model/initial_snapshot.dart

@@ -19,7 +19,11 @@ class InitialSnapshot {
 
   final List<CustomProfileField> custom_profile_fields;
 
-  // TODO many more
+  // TODO etc., etc.
+
+  final List<Subscription> subscriptions;
+
+  // TODO etc., etc.
 
   InitialSnapshot({
     this.queue_id,
@@ -29,6 +33,7 @@ class InitialSnapshot {
     this.zulip_merge_base,
     required this.alert_words,
     required this.custom_profile_fields,
+    required this.subscriptions,
   });
 
   factory InitialSnapshot.fromJson(Map<String, dynamic> json) =>

lib/api/model/initial_snapshot.g.dart

@@ -30,3 +30,72 @@ class CustomProfileField {
   factory CustomProfileField.fromJson(Map<String, dynamic> json) =>
       _$CustomProfileFieldFromJson(json);
 }
+
+/// As in `subscriptions` in the initial snapshot.
+@JsonSerializable()
+class Subscription {
+  final int stream_id;
+  final String name;
+  final String description;
+  final String rendered_description;
+  final int date_created;
+  final bool invite_only;
+
+  // final List<int> subscribers; // we register with include_subscribers false
+
+  final bool? desktop_notifications;
+  final bool? email_notifications;
+  final bool? wildcard_mentions_notify;
+  final bool? push_notifications;
+  final bool? audible_notifications;
+
+  final bool pin_to_top;
+
+  final String email_address;
+
+  final bool is_muted;
+
+  // final bool? in_home_view; // deprecated; ignore
+
+  // final bool? is_announcement_only; // deprecated; ignore
+  final bool? is_web_public; // TODO(server-??): doc doesn't say when added
+
+  final String color;
+
+  final int stream_post_policy; // TODO enum
+  final int? message_retention_days;
+  final bool history_public_to_subscribers;
+
+  final int? first_message_id;
+  final int? stream_weekly_traffic;
+
+  final int? can_remove_subscribers_group_id; // TODO(server-6)
+
+  Subscription({
+    required this.stream_id,
+    required this.name,
+    required this.description,
+    required this.rendered_description,
+    required this.date_created,
+    required this.invite_only,
+    this.desktop_notifications,
+    this.email_notifications,
+    this.wildcard_mentions_notify,
+    this.push_notifications,
+    this.audible_notifications,
+    required this.pin_to_top,
+    required this.email_address,
+    required this.is_muted,
+    this.is_web_public,
+    required this.color,
+    required this.stream_post_policy,
+    this.message_retention_days,
+    required this.history_public_to_subscribers,
+    this.first_message_id,
+    this.stream_weekly_traffic,
+    this.can_remove_subscribers_group_id,
+  });
+
+  factory Subscription.fromJson(Map<String, dynamic> json) =>
+      _$SubscriptionFromJson(json);
+}

lib/api/model/model.dart

@@ -93,6 +93,8 @@ class HomePage extends StatelessWidget {
           const SizedBox(height: 8),
           Text('Connected to: ${store.account.realmUrl}'),
           Text('Zulip server version: ${store.initialSnapshot.zulip_version}'),
+          Text(
+              'Subscribed to ${store.initialSnapshot.subscriptions.length} streams'),
         ])));
   }
 }