From 5e744837bd9151a6d6e56056837c77a38a8162cd Mon Sep 17 00:00:00 2001
From: Andreas Holstenson <a@holstenson.se>
Date: Thu, 17 Jun 2021 11:24:44 +0200
Subject: [PATCH] docs(core): Update README with new services example

---
 packages/core/README.md | 37 +++++++++++++++++++++++++++++--------
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/packages/core/README.md b/packages/core/README.md
index 3ea2e25..e0a77b1 100644
--- a/packages/core/README.md
+++ b/packages/core/README.md
@@ -118,7 +118,7 @@ Services are supported via `ataraxia-services`, where objects can be registered
 and functions on them called remotely:
 
 ```javascript
-import { Services } from 'ataraxia-services';
+import { Services, ServiceContract, stringType } from 'ataraxia-services';
 
 const net = ... // setup network with at least one transport
 
@@ -133,14 +133,35 @@ await net.join();
 // Join the services on top of the network
 await services.join();
 
-// Register a service as a plain object
-const handle = services.register({
-  id: 'service-id',
-  
-  hello() {
-    return 'Hello world';
+// Use contracts to describe services
+const EchoService = new ServiceContract()
+  .defineMethod('echo', {
+    returnType: stringType,
+    parameters: [
+      {
+        name: 'message',
+        type: stringType
+      }
+    ]
+  });
+
+// Easily register and expose services to other nodes
+services.register('echo', EchoService.implement({
+  echo(message) {
+    return Promise.resolve(message);
   }
-});
+}));
+
+// Consume a service registered anywhere, local or remote
+const echoService = services.get('echo');
+if(echoService.available) {
+  // Call methods
+  await echoService.call('echo', 'Hello world');
+  
+  // Or create a proxy for a cleaner API
+  const proxied = echoService.as(EchoService);
+  await proxied.echo('Hello world');
+}
 ```
 
 ## API