Update docs to include JsonWebClient in web_client.dart

Author: mythz

README.md

@@ -29,7 +29,7 @@ To make API calls we need to use the `JsonServiceClient`, installed by adding th
 
 ```yaml
 dependencies:
-  servicestack: ^1.0.4
+  servicestack: ^1.0.5
 ```
 
 Saving `pubspec.yaml` in VS Code with the [Dart Code Extension](https://dartcode.org) automatically calls `pub get` or `flutter packages get` (in Flutter projects) to add any new dependencies to your project.
@@ -51,6 +51,30 @@ main() async {
 
 Like C#, Dart has Generics and Type Inference so the `response` returned is the typed `HelloResponse` DTO giving us rich intelli-sense and compiler type safety. 
 
+### JsonWebClient
+
+For browser projects you would instead use the `JsonWebClient` from `web_client.dart`, e.g:
+
+```dart
+import 'package:servicestack/web_client.dart';
+
+var client = new JsonWebClient("https://www.techstacks.io");
+```
+
+The `JsonWebClient` performs HTTP Requests using [dart:html BrowserClient](https://webdev.dartlang.org/angular/guide/server-communication) to use the browsers built-in `XMLHttpRequest` object. Despite their implementation differences `JsonWebClient` also supports the same feature-set as the Dart VM's `JsonServiceClient` above. 
+
+#### Concrete-specific functionality
+
+In addition to implementing the `IServiceClient` above, each Service Client includes additional concrete specific functionality allowing for finer-grained access to their underlying HTTP Clients, e.g. as the Request/Response filters have different Type signatures (dart:io's `HttpClientResponse` vs Browser's `Response`) they can't be declared in the shared `IServiceClient` interface, but thanks to Dart's type inference many of the extended concrete APIs are still source-compatible, e.g:
+
+```dart
+var vmClient = new JsonServiceClient(baseUrl)
+    ..responseFilter = (res) => print(res.headers["X-Args"]);
+
+var webClient = new JsonWebClient(baseUrl)
+    ..responseFilter = (res) => print(res.headers["X-Args"]);
+```
+
 ### Rich Generated Models
 
 Thanks to the direct C# to Dart model code generation we're able to create the ideal idiomatic message-based APIs utilizing rich typed models with broad support for many of the C#/.NET features used when defining DTOs inc. Generics, Inheritance, multiple Interfaces, Enums (inc. int and Flag Enums), Tuples, metadata Attributes emitted in comments (emitting additional documentation in the generated models) whilst also taking care of mapping built-in C# Types like `DateTime`, `TimeSpan`, `byte[]` and `Stream` into their equivalent native Dart [DateTime](https://api.dartlang.org/stable/1.24.3/dart-core/DateTime-class.html), [Duration](https://api.dartlang.org/stable/1.24.3/dart-core/Duration-class.html) and [Uint8List](https://api.dartlang.org/stable/1.24.3/dart-typed_data/Uint8List-class.html) types, C# generic collections are also converted into their equivalent Dart generic collection Type.
@@ -183,7 +207,7 @@ Then to use `JsonServiceClient` add the `servicestack` dependency to your apps [
 
 ```yaml
 dependencies:
-  servicestack: ^1.0.4
+  servicestack: ^1.0.5
 ```
 
 Saving `pubspec.yaml` automatically runs [flutter packages get](https://flutter.io/using-packages/) to install any new dependencies in your App. 
@@ -467,6 +491,126 @@ To display the image we assign the response to the `imageBytes` field within the
 
 ![](https://raw.githubusercontent.com/ServiceStack/docs/master/docs/images/dart/flutter/helloflutter-06.png)
 
+### Angular Dart
+
+The [HelloAngularDart](https://github.com/ServiceStackApps/HelloAngularDart) project demonstrates the same functionality in an AngularDart Web App running inside a Web Browser.
+
+The only difference is having to import `servicestack/web_client.dart` containing the `JsonWebClient`:
+
+```dart
+import 'package:servicestack/web_client.dart';
+```
+
+and changing the clients to use the `JsonWebClient` instead, e.g:
+
+```dart
+var testClient = new JsonWebClient(TestBaseUrl);
+var techstacksClient = new JsonWebClient(TechStacksBaseUrl);
+```
+
+But otherwise the actual client source code for all of the Typed API requests remains exactly the same. 
+
+The `HelloAngularDart` App is contained within the [hello_world](https://github.com/ServiceStackApps/HelloAngularDart/tree/master/lib/src/hello_world) component with all Dart logic in:
+
+#### [hello_world.dart](https://github.com/ServiceStackApps/HelloAngularDart/blob/master/lib/src/hello_world/hello_world.dart)
+
+```dart
+import 'dart:typed_data';
+import 'dart:convert';
+
+import 'package:angular/angular.dart';
+import 'package:servicestack/web_client.dart';
+
+import '../dtos/test.dtos.dart';
+import '../dtos/techstacks.dtos.dart';
+
+@Component(
+  selector: 'hello-world',
+  styleUrls: const ['hello_world.css'],
+  templateUrl: 'hello_world.html',
+)
+class HelloWorldComponent {
+  var result = "";
+  var imageSrc = "data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw=="; // 1x1 pixel
+  static const TestBaseUrl = "http://test.servicestack.net";
+  static const TechStacksBaseUrl = "https://www.techstacks.io";
+  var testClient = new JsonWebClient(TestBaseUrl);
+  var techstacksClient = new JsonWebClient(TechStacksBaseUrl);
+
+  doAsync() async {
+    var r = await testClient.get(new Hello(name: "Async"));
+    result = r.result;
+  }
+
+  doAuth() async {
+    var auth = await testClient.post(new Authenticate(
+        provider: "credentials", userName: "test", password: "test"));
+    var r = await testClient.get(new HelloAuth(name: "Auth"));
+    result = "${r.result} your JWT is: ${auth.bearerToken}";
+  }
+
+  doJWT() async {
+    var auth = await testClient.post(new Authenticate(
+        provider: "credentials", userName: "test", password: "test"));
+
+    var newClient = new JsonWebClient(TestBaseUrl)
+      ..refreshToken = auth.refreshToken;
+    var r = await newClient.get(new HelloAuth(name: "JWT"));
+    result = "${r.result} your RefreshToken is: ${auth.refreshToken}";
+  }
+
+  doQuery() async {
+    var techs = await techstacksClient
+        .get(new FindTechnologies(), args: {"slug": "flutter"});
+    var posts = await techstacksClient.get(new QueryPosts(
+        anyTechnologyIds: [techs.results[0].id],
+        types: ['Announcement', 'Showcase'])
+      ..take = 1);
+    result = "Latest Flutter Announcement:\n“${posts.results[0].title}”";
+  }
+
+  doBatch() async {
+    var requests = ['foo', 'bar', 'qux'].map((name) => new Hello(name: name));
+    var responses = await testClient.sendAll(requests);
+    result = "Batch Responses:\n${responses.map((r) => r.result).join('\n')}";
+  }
+
+  doImage() async {
+    Uint8List bytes = await testClient.get(new HelloImage(
+        name: "Flutter",
+        fontFamily: "Roboto",
+        background: "#0091EA",
+        width: 500,
+        height: 170));
+
+    result = "";
+    imageSrc = "data:image/png;base64," + base64.encode(bytes);
+  }
+}
+```
+
+#### [hello_world.html](https://github.com/ServiceStackApps/HelloAngularDart/blob/master/lib/src/hello_world/hello_world.html)
+
+Which uses this template markup to render its UI:
+
+```html
+<div>
+    <button (click)="doAsync()">Async</button>
+    <button (click)="doAuth()">Auth</button>
+    <button (click)="doJWT()">JWT</button>
+    <button (click)="doQuery()">Query</button>
+    <button (click)="doBatch()">Batch</button>
+    <button (click)="doImage()">Image</button>
+</div>
+
+<div id="result">{{result}}</div>
+
+<img src="{{imageSrc}}">
+```
+
+Where it runs a functionally equivalent App in a browser:
+
+![](https://raw.githubusercontent.com/ServiceStack/docs/master/docs/images/dart/angulardart/helloangulardart-01.png)
 
 ## DTO Customization Options