u8-mqtt 0.1.3 → 0.3.0

package/README.md

@@ -33,68 +33,36 @@ Targeting [MQTT-3.1.1 (v4)][spec-3.1.1] and [MQTT-5.0.0 (v5)][spec-5.0.0] compat
 
 ## Use
 
-```javascript
-// using NodeJS
-import mqtt_client from 'u8-mqtt/esm/node/v4.mjs'
-
-// or using Deno
-import mqtt_client from 'u8-mqtt/esm/deno/v4.mjs'
-
-// or using WebSockets
-import mqtt_client from 'u8-mqtt/esm/web/v4.mjs'
-
-
-const my_mqtt = mqtt_client()
-
-
-// Connect using NodeJS or Deno
-my_mqtt.with_tcp(1883, '127.0.0.1')
+- from [Web CDN](./use_from_web_cdn.md)
+- from [Web bundler](./use_from_web_bundler.md) like [Rollup][] or [ESBuild][]
+- from [NodeJS](./use_from_nodejs.md)
+- from [Deno](./use_from_deno.md)
 
-// or connect using WebSockets
-my_mqtt.with_websock('ws://127.0.0.1:9001')
+ [Rollup]: https://rollupjs.org
+ [ESBuild]: https://esbuild.github.io
 
 
-// use on_live to converse with the MQTT server
-my_mqtt.on_live = somewhere_in_your_code
-
-
-// ...
-async function somewhere_in_your_code(my_mqtt) {
-  my_mqtt
-    .on_topic('u8-mqtt-demo/topic/:arg', (pkt, params, ctx) => {
-      console.log('topic:', params, [params.arg, pkt.utf8()])
-    })
-    .on_topic('u8-mqtt-demo/another/:first/:second', (pkt, params, ctx) => {
-      console.log('another:', params, [params.first, params.second, pkt.utf8()])
-    })
-    .subscribe_topic('u8-mqtt-demo/bye', (pkt, params, ctx) => {
-      console.log('other mqtt said bye:', params, [pkt.utf8()])
-    })
-
+```javascript
+import mqtt_client from 'https://cdn.jsdelivr.net/npm/u8-mqtt/esm/web/index.js'
+// or import mqtt_client from 'u8-mqtt'
 
-  await my_mqtt.connect({
-    client_id: ['my-mqtt--', '--demo'],
-    will: {
-      topic: 'u8-mqtt-demo/bye',
-      payload: 'gone!',
-    }
-  })
+let my_mqtt = mqtt_client()
+  .with_websock('wss://test.mosquitto.org:8081')
+  // or .with_tcp('tcp://test.mosquitto.org:1883')
+  .with_autoreconnect()
 
-  await my_mqtt.subscribe([
-    'u8-mqtt-demo/another/#',
-    'u8-mqtt-demo/topic/+',
-  ])
+await my_mqtt.connect()
 
-  my_mqtt.publish({
-    topic: 'u8-mqtt-demo/topic/node-side-fun-test',
-    payload: 'awesome from both web and node',
+my_mqtt.subscribe_topic(
+  'u8-mqtt/demo-simple/:topic',
+  (pkt, params, ctx) => {
+    console.log('topic packet', params, pkt, pkt.json())
   })
 
-  my_mqtt.send(
-    'u8-mqtt-demo/another/apple/orange',
-    'MQTT Fruity fun')
-
-}
+await my_mqtt.json_send(
+  'u8-mqtt/demo-simple/live',
+  { note: 'from README example',
+    live: new Date().toISOString() })
 ```
 
 ## Sizes
@@ -105,7 +73,7 @@ Built for small footprint with ES Modules (ESM) using embedded [u8-mqtt-packet][
 |-------|-----|------------
 | 187KB | 13x | `curl -sL https://cdn.jsdelivr.net/npm/mqtt@4.0.1/dist/mqtt.min.js  \| wc -c`
 |  32KB |  2x | `curl -sL https://cdn.jsdelivr.net/npm/paho-mqtt@1.1.0/paho-mqtt.min.js \| wc -c`
-|  16KB |  1x | `cat ./u8-mqtt/esm/web/v4.min.mjs \| wc -c`
+|  19KB |  1x | `cat ./u8-mqtt/esm/web/index.min.mjs \| wc -c`
 
 
 ## Prior Art