docs: expanded the usage example

README.md

@@ -1,6 +1,6 @@
 # aw-client-js
 
-Client library for [ActivityWatch](http://activitywatch.net) in JavaScript.
+Client library for [ActivityWatch](http://activitywatch.net) in TypeScript/JavaScript.
 
 [![Build Status](https://github.com/ActivityWatch/aw-client-js/workflows/Build/badge.svg)](https://github.com/ActivityWatch/aw-client-js/actions)
 [![Known Vulnerabilities](https://snyk.io/test/github/ActivityWatch/aw-client-js/badge.svg)](https://snyk.io/test/github/ActivityWatch/aw-client-js)
@@ -13,10 +13,28 @@ npm install aw-client
 
 ## Usage
 
+The library uses Promises for almost everything, so either use `.then()` or the (recommended) async/aways syntax.
+
+The example below is written with `.then()` to make it easy to run in the node REPL.
+
 ```javascript
 const { AWClient } = require('aw-client');
+const client = new AWClient('test-client')
+
+// Get server info
+client.getInfo().then(console.log);
+
+// List buckets
+client.getBuckets().then(console.log);
+
+// Create bucket
+const bucketId = "test";
+client.createBucket(bucketId, "bucket-type", "your-hostname");
 
-const client = new AWClient(myClientName)
+// Send a heartbeat
+const nowStr = (new Date()).toISOString();
+const heartbeat = {timestamp: nowStr, duration: 0, data: { label: "just testing!" }};
+client.heartbeat(bucketId, 5, heartbeat);
 ```
 
 ## Contribute