fix: use type-specific methods in public clients, Value in internal clients (#90)

* fix: use dynamic in public clients, Value in internal clients

* dart format

* fix topics test

* provide String and Binary versions of methods that accept Values on public clients instead of using dynamic

* pass Strings directly to doc api examples

* add missing list collection docstrings

* Binary -> Bytes

Author: anitarua

example/doc_example_apis/doc_example_apis.dart

@@ -14,7 +14,8 @@ Future<void> example_API_InstantiateCacheClient() async {
   }
 }
 
-Future<void> example_API_CreateCache(CacheClient cacheClient, String cacheName) async {
+Future<void> example_API_CreateCache(
+    CacheClient cacheClient, String cacheName) async {
   final result = await cacheClient.createCache(cacheName);
   switch (result) {
     case CreateCacheAlreadyExists():
@@ -36,7 +37,8 @@ Future<void> example_API_ListCaches(CacheClient cacheClient) async {
   }
 }
 
-Future<void> example_API_DeleteCache(CacheClient cacheClient, String cacheName) async {
+Future<void> example_API_DeleteCache(
+    CacheClient cacheClient, String cacheName) async {
   final result = await cacheClient.deleteCache(cacheName);
   switch (result) {
     case DeleteCacheError():
@@ -47,7 +49,8 @@ Future<void> example_API_DeleteCache(CacheClient cacheClient, String cacheName)
   }
 }
 
-Future<void> example_API_Set(CacheClient cacheClient, String cacheName, Value key, Value value) async {
+Future<void> example_API_Set(
+    CacheClient cacheClient, String cacheName, String key, String value) async {
   final result = await cacheClient.set(cacheName, key, value);
   switch (result) {
     case SetError():
@@ -58,7 +61,8 @@ Future<void> example_API_Set(CacheClient cacheClient, String cacheName, Value ke
   }
 }
 
-Future<void> example_API_Get(CacheClient cacheClient, String cacheName, Value key) async {
+Future<void> example_API_Get(
+    CacheClient cacheClient, String cacheName, String key) async {
   final result = await cacheClient.get(cacheName, key);
   switch (result) {
     case GetMiss():
@@ -70,7 +74,8 @@ Future<void> example_API_Get(CacheClient cacheClient, String cacheName, Value ke
   }
 }
 
-Future<void> example_API_Delete(CacheClient cacheClient, String cacheName, Value key) async {
+Future<void> example_API_Delete(
+    CacheClient cacheClient, String cacheName, String key) async {
   final result = await cacheClient.delete(cacheName, key);
   switch (result) {
     case DeleteError():
@@ -88,8 +93,8 @@ Future<void> main() async {
       Duration(seconds: 30));
 
   final cacheName = "doc-example-apis-${Uuid().v4()}";
-  final key = StringValue("myKey");
-  final value = StringValue("myValue");
+  final key = "myKey";
+  final value = "myValue";
 
   await example_API_InstantiateCacheClient();
   await example_API_CreateCache(cacheClient, cacheName);

example/flutter_chat_app/lib/main.dart

@@ -77,8 +77,8 @@ class _MyHomePageState extends State<MyHomePage> {
   }
 
   Future<void> publishMessage() async {
-    final result = await _topicClient.publish(
-        "cache", "topic", StringValue(_textInputController.text));
+    final result =
+        await _topicClient.publish("cache", "topic", _textInputController.text);
     switch (result) {
       case TopicPublishSuccess():
         print("Successful publish");

example/quickstart/quickstart.dart

@@ -7,8 +7,8 @@ Future<void> main() async {
       Duration(seconds: 30));
 
   final cacheName = "cache";
-  final key = StringValue("key");
-  final value = StringValue("value");
+  final key = "key";
+  final value = "value";
 
   final setResp = await cacheClient.set(cacheName, key, value);
   switch (setResp) {

example/topics/advanced.dart

@@ -18,8 +18,7 @@ void main() async {
   Timer(const Duration(seconds: 2), () async {
     // publish 10 messages spaced 1 second apart
     for (final i in Iterable.generate(10)) {
-      var result =
-          await topicClient.publish("cache", "topic", StringValue("hi $i"));
+      var result = await topicClient.publish("cache", "topic", "hi $i");
       switch (result) {
         case TopicPublishSuccess():
           print("Successful publish!");

example/topics/basic_publisher.dart

@@ -8,8 +8,7 @@ void main() async {
 
   // publish 10 messages spaced 1 second apart
   for (final i in Iterable.generate(10)) {
-    var result =
-        await topicClient.publish("cache", "topic", StringValue("hi $i"));
+    var result = await topicClient.publish("cache", "topic", "hi $i");
     switch (result) {
       case TopicPublishSuccess():
         print("Successful publish!");