u8-mqtt 0.1.3 → 0.3.0

package/cjs/index.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var net = require('net');
+var node_net = require('node:net');
 
 function encode_varint(n, a=[]) {
   do {
@@ -26,7 +26,7 @@ export function decode_varint_loop(u8, i=0) {
 */
 
 
-function decode_varint(u8, i=0) {
+function decode_varint$1(u8, i=0) {
   let i0 = i;
   // unrolled for a max of 4 chains
   let n = (u8[i] & 0x7f) <<  0;
@@ -42,45 +42,13 @@ function decode_varint(u8, i=0) {
   return [n, i, i0]
 }
 
-function _mqtt_raw_pkt_dispatch(decode_raw_pkt) {
-  let u8 = new Uint8Array(0);
-  return u8_buf => {
-    u8 = 0 === u8.byteLength
-      ? u8_buf : _u8_join(u8, u8_buf);
-
-    const res = [];
-    while (1) {
-      const [len_body, len_vh] = decode_varint(u8, 1);
-      const len_pkt = len_body + len_vh;
+const mqtt_props = /* #__PURE__ */
+  init_mqtt_props();
 
-      if ( u8.byteLength < len_pkt )
-        return res
+function init_mqtt_props() {
+  let mqtt_props = new Map();
 
-      let b0 = u8[0];
-      let u8_body = 0 === len_body ? null
-        : u8.subarray(len_vh, len_pkt);
-
-      u8 = u8.subarray(len_pkt);
-
-      const pkt = decode_raw_pkt(b0, u8_body);
-      if (undefined !== pkt && null !== pkt)
-        res.push( pkt );
-    }
-  }
-}
-
-function _u8_join(a, b) {
-  const alen = a.byteLength;
-  const r = new Uint8Array(alen + b.byteLength);
-  r.set(a, 0);
-  r.set(b, alen);
-  return r
-}
-
-const mqtt_props = new Map(); 
-
-{
-  const entries = [
+  let entries = [
     [ 0x01, 'u8',   'payload_format_indicator'],
     [ 0x02, 'u32',  'message_expiry_interval'],
     [ 0x03, 'utf8', 'content_type'],
@@ -101,140 +69,279 @@ const mqtt_props = new Map();
     [ 0x21, 'u16',  'receive_maximum'],
     [ 0x22, 'u16',  'topic_alias_maximum'],
     [ 0x23, 'u16',  'topic_alias'],
-    [ 0x24, 'u8',   'maximum_qo_s'],
+    [ 0x24, 'u8',   'maximum_qos'],
     [ 0x25, 'u8',   'retain_available'],
-    [ 0x26, 'pair', 'user_properties', true],
+    [ 0x26, 'pair', 'user_properties', {op: 'kv_obj'}],
     [ 0x27, 'u32',  'maximum_packet_size'],
     [ 0x28, 'u8',   'wildcard_subscription_available'],
-    [ 0x29, 'u8',   'subscription_identifiers_available', true],
+    [ 0x29, 'u8',   'subscription_identifiers_available', {op: 'u8_vec'}],
     [ 0x2A, 'u8',   'shared_subscription_available'],
   ];
 
-  for (const [id, type, name, plural] of entries) {
-    const prop_obj = {id, type, name};
-    if (plural) prop_obj.plural = plural;
+  for (let [id, type, name, extra] of entries) {
+    let prop_obj = {id, type, name, ...extra};
     mqtt_props.set(prop_obj.id, prop_obj);
     mqtt_props.set(prop_obj.name, prop_obj);
   }
-}
-
-const as_utf8 = u8 =>
-  new TextDecoder('utf-8').decode(u8);
 
-const step_from = idx =>
-  (width, r) => ( r = idx, idx += width, r );
+  return mqtt_props
+}
 
-class mqtt_type_reader {
-  constructor(buf, idx=0) {
-    this.buf = buf;
-    this.step = step_from(idx);
+class U8_Reason extends Number {
+  static of(v, pkt_kind, by_kind) {
+    let self = new this(v);
+    self.reason = by_kind?.[pkt_kind]?.get(v) || pkt_kind;
+    return self
   }
+}
 
-  _fork(buf, idx) {
-    return { __proto__: this, buf, step: step_from(idx) }
+class mqtt_reader_v4 {
+  static of(buf) { return this.prototype.of(buf) }
+  of(buf) {
+    let step = (width, k) => (k=0|step.k, step.k=k+width, k);
+    return {__proto__: this, buf, step}
   }
 
   has_more() {
-    const {buf, step} = this;
-    return buf.byteLength > step(0)
+    return this.buf.byteLength > (this.step.k|0)
   }
 
   u8() {
-    const {buf, step} = this;
-    return buf[step(1)]
+    return this.buf[this.step(1)]
   }
 
   u16() {
-    const {buf, step} = this;
-    const i = step(2);
+    let {buf, step} = this, i = step(2);
     return (buf[i]<<8) | buf[i+1]
   }
 
   u32() {
-    const {buf, step} = this;
-    const i = step(4);
+    let {buf, step} = this, i = step(4);
     return (buf[i]<<24) | (buf[i+1]<<16) | (buf[i+2]<<8) | buf[i+3]
   }
 
   vint() {
-    const {buf, step} = this;
-    const [n, vi, vi0] = decode_varint(buf, step(0));
+    let {buf, step} = this;
+    let [n, vi, vi0] = decode_varint$1(buf, step.k|0);
     step(vi - vi0);
     return n
   }
 
-  vbuf() {
-    const {buf, step} = this;
-    const [n, vi, vi0] = decode_varint(buf, step(0));
-    step(n + vi - vi0);
-    return 0 === n ? null
-      : buf.subarray(vi, step(0))
-  }
-
   bin() {
-    const {buf, step} = this;
-    const i = step(2);
-    const len = (buf[i]<<8) | buf[i+1];
-    const i0 = step(len);
-    return buf.subarray(i0, i0+len)
+    let {buf, step} = this, i = step(2);
+    let len = (buf[i]<<8) | buf[i+1];
+    i = step(len);
+    return buf.subarray(i, i+len)
   }
 
-  utf8() { return as_utf8(this.bin()) }
-  pair() { return [ as_utf8(this.bin()), as_utf8(this.bin()) ] }
+  utf8() { return new TextDecoder('utf-8').decode(this.bin()) }
+  pair() { return [ this.utf8(), this.utf8() ] }
 
-  u8_flags(FlagsType) {
-    const {buf, step} = this;
-    return new FlagsType(buf[step(1)])
-  }
+  flags(FlagsType) { return new FlagsType(this.buf[this.step(1)]) }
 
-  u8_reason(fn_reason) {
-    const {buf, step} = this;
-    return fn_reason( buf[step(1)] )
+  reason(pkt_kind) {
+    let v = this.buf[this.step(1)];
+    if (null != v)
+      return U8_Reason.of(v, pkt_kind, this._reasons_by)
   }
 
   flush() {
-    const {buf, step} = this;
+    let {buf, step} = this;
     this.step = this.buf = null;
-    return buf.subarray(step(0))
+    return buf.subarray(step.k|0)
   }
 
+}
+
+class mqtt_reader_v5$1 extends mqtt_reader_v4 {
   props() {
-    let sub = this.vbuf();
-    return null === sub ? null
-      : this._fork(sub, 0)._read_props([])
+    let {buf, step} = this;
+    let [n, vi, vi0] = decode_varint$1(buf, step.k|0);
+    step(n + vi - vi0);
+    if (0 === n) return null
+
+    let res={}, fork = this.of(buf.subarray(vi, step.k|0));
+    while (fork.has_more()) {
+      let pt = mqtt_props.get( fork.u8() )
+        , value = fork[pt.type]();
+      res[pt.name] = ! pt.op ? value
+        : fork[pt.op](res[pt.name], value);
+    }
+    return res
   }
 
-  _read_props(lst) {
-    while (this.has_more()) {
-      let k = this.u8();
-      let p = mqtt_props.get( k );
-      let v = this[p.type]();
-      lst.push([p.name, v]);
-    }
-    return lst
+  kv_obj(obj=Object.create(null), [k,v]) {
+    obj[k] = v;
+    return obj
   }
+  u8_vec(vec=[], u8) {
+    vec.push(u8);
+    return vec
+  }
+
+  /*
+  vbuf() {
+    let {buf, step} = this
+    let [n, vi, vi0] = decode_varint(buf, step.k|0)
+    step(n + vi - vi0)
+    return 0 === n ? null
+      : buf.subarray(vi, step.k|0)
+  }
+  */
 }
 
+function mqtt_reader_info(mqtt_reader, ... info_fn_list) {
+  mqtt_reader = class extends mqtt_reader {
+    static reasons(pkt_type, ...reason_entries) {
+      let proto = this.prototype;
+      proto._reasons_by = {... proto._reasons_by};
 
+      let lut = (proto._reasons_by[pkt_type] ||= new Map());
+      for (let [u8, reason] of reason_entries)
+        lut.set( u8, reason );
 
-class U8_Reason extends Number {
-  constructor(u8, reason) { super(u8); this.reason = reason; }
+      return this
+    }
+  };
+
+  for (let fn_info of info_fn_list)
+    fn_info(mqtt_reader);
+
+  return mqtt_reader
+}
+
+class mqtt_writer_v4 {
+  static of() { return this.prototype.of() }
+  of() { return {__proto__: this, $:[]} }
+
+  static init() { return this }
+
+  as_pkt(pkt_id) { return this.pack([pkt_id]) }
+
+  push(...z) { this.$.push(...z); }
+  pack(hdr) {
+    let z, i, n=0, parts = this.$;
+    this.$ = false;
+    for (z of parts) n += z.length;
+
+    hdr = encode_varint(n, hdr);
+    i = hdr.length;
+
+    let pkt = new Uint8Array(i + n);
+    pkt.set(hdr, 0);
+    for (z of parts) {
+      pkt.set(z, i);
+      i += z.length;
+    }
+    return pkt
+  }
+
+  u8(v) { this.push([ v & 0xff ]); }
+  u16(v) { this.push([ (v>>>8) & 0xff, v & 0xff ]); }
+  u32(v) { this.push([ (v>>>24) & 0xff, (v>>>16) & 0xff, (v>>>8) & 0xff, v & 0xff ]); }
+  vint(v) { this.push( encode_varint(v) );}
+
+  bin(u8_buf) {
+    if (! u8_buf) return this.u16(0)
+    if ('string' === typeof u8_buf)
+      return this.utf8(u8_buf)
+
+    if (u8_buf.length !== u8_buf.byteLength)
+      u8_buf = new Uint8Array(u8_buf);
+
+    this.u16(u8_buf.byteLength);
+    this.push(u8_buf);
+  }
+
+  utf8(v) {
+    let u8_buf = new TextEncoder('utf-8').encode(v);
+    this.u16(u8_buf.byteLength);
+    this.push(u8_buf);
+  }
+  pair(k,v) { this.utf8(k); this.utf8(v); }
+
+  flags(v, enc_flags, b0=0) {
+    if (undefined !== v && isNaN(+v))
+      v = enc_flags(v, 0);
+
+    v |= b0;
+    this.push([v]);
+    return v
+  }
+
+  reason(v) { this.push([v | 0]); }
+
+  flush(buf) {
+    if (null != buf)
+      this.push(
+        'string' === typeof buf
+          ? new TextEncoder('utf-8').encode(buf)
+          : buf );
+
+    this.push = false;
+  }
 }
 
-function bind_reason_lookup(reason_entries) {
-  const reason_map = new Map();
-  for (const [u8, reason] of reason_entries)
-    reason_map.set( u8, new U8_Reason(u8, reason) );
 
-  return reason_map.get.bind(reason_map)
+class mqtt_writer_v5 extends mqtt_writer_v4 {
+  props(props) {
+    if (! props)
+      return this.u8(0)
+
+    if (! Array.isArray(props))
+      props = props.entries
+        ? Array.from(props.entries())
+        : Object.entries(props);
+
+    if (0 === props.length)
+      return this.u8(0)
+
+    let fork = this.of();
+    for (let [name, value] of props) {
+      let pt = mqtt_props.get(name);
+      fork[pt.op || 'one'](value, pt);
+    }
+    this.push(fork.pack());
+  }
+
+  one(value, pt) {
+    this.u8(pt.id);
+    this[pt.type](value);
+  }
+  kv_obj(obj, pt) {
+    for (let kv of Object.entries(obj)) {
+      this.u8(pt.id);
+      this.pair(kv);
+    }
+  }
+  u8_vec(vec, pt) {
+    for (let v of vec) {
+      this.u8(pt.id);
+      this.u8(v);
+    }
+  }
 }
 
-function mqtt_decode_connack(ns) {
+function mqtt_decode_connack(ns, mqtt_reader) {
   class _connack_flags_ extends Number {
     get session_present() { return this & 0x01 !== 0 }
   }
 
-  const _connack_reason_ = bind_reason_lookup([
+  return ns[0x2] = (pkt, u8_body) => {
+    let rdr = mqtt_reader.of(u8_body);
+
+    pkt.flags =
+      rdr.flags(_connack_flags_);
+
+    pkt.reason = rdr.reason(pkt.type);
+    if (5 <= pkt.mqtt_level)
+      pkt.props = rdr.props();
+    return pkt }
+}
+
+
+function _connack_v4(mqtt_reader) {
+  mqtt_reader.reasons('connack',
     // MQTT 3.1.1
     [ 0x00, 'Success'],
     [ 0x01, 'Connection refused, unacceptable protocol version'],
@@ -242,7 +349,13 @@ function mqtt_decode_connack(ns) {
     [ 0x03, 'Connection refused, server unavailable'],
     [ 0x04, 'Connection refused, bad user name or password'],
     [ 0x05, 'Connection refused, not authorized'],
+  );
+}
+
+function _connack_v5(mqtt_reader) {
+  _connack_v4(mqtt_reader);
 
+  mqtt_reader.reasons('connack',
     // MQTT 5.0
     [ 0x81, 'Malformed Packet'],
     [ 0x82, 'Protocol Error'],
@@ -264,29 +377,17 @@ function mqtt_decode_connack(ns) {
     [ 0x9C, 'Use another server'],
     [ 0x9D, 'Server moved'],
     [ 0x9F, 'Connection rate exceeded'],
-  ]);
-
-
-  return ns[0x2] = (pkt, u8_body) => {
-    const rdr = new mqtt_type_reader(u8_body, 0);
-
-    pkt.flags =
-      rdr.u8_flags(_connack_flags_);
-
-    pkt.reason = rdr.u8_reason(_connack_reason_);
-    if (5 <= pkt.mqtt_level)
-      pkt.props = rdr.props();
-    return pkt }
+  );
 }
 
-function mqtt_decode_publish(ns) {
+function mqtt_decode_publish(ns, mqtt_reader) {
   return ns[0x3] = (pkt, u8_body) => {
-    const {hdr} = pkt;
+    let {hdr} = pkt;
     pkt.dup = Boolean(hdr & 0x8);
     pkt.retain = Boolean(hdr & 0x1);
-    const qos = pkt.qos = (hdr>>1) & 0x3;
+    let qos = pkt.qos = (hdr>>1) & 0x3;
 
-    const rdr = new mqtt_type_reader(u8_body, 0);
+    let rdr = mqtt_reader.of(u8_body);
     pkt.topic = rdr.utf8();
     if (0 !== qos)
       pkt.pkt_id = rdr.u16();
@@ -298,73 +399,68 @@ function mqtt_decode_publish(ns) {
     return pkt }
 }
 
-function mqtt_decode_puback(ns) {
-  const _puback_reason_ = bind_reason_lookup([
-    [ 0x00, 'Success'],
-
-    // MQTT 5.0
-    [ 0x10, 'No matching subscribers'],
-    [ 0x80, 'Unspecified error'],
-    [ 0x83, 'Implementation specific error'],
-    [ 0x87, 'Not authorized'],
-    [ 0x90, 'Topic Name invalid'],
-    [ 0x91, 'Packet identifier in use'],
-    [ 0x97, 'Quota exceeded'],
-    [ 0x99, 'Payload format invalid'],
-  ]);
-
-
+function mqtt_decode_puback(ns, mqtt_reader) {
   return ns[0x4] = (pkt, u8_body) => {
-    const rdr = new mqtt_type_reader(u8_body, 0);
+    let rdr = mqtt_reader.of(u8_body);
 
     pkt.pkt_id = rdr.u16();
     if (5 <= pkt.mqtt_level) {
-      pkt.reason = rdr.u8_reason(_puback_reason_);
+      pkt.reason = rdr.reason(pkt.type);
       pkt.props = rdr.props();
     }
 
     return pkt }
 }
 
-function mqtt_decode_pubxxx(ns) {
-  const _pubxxx_reason_ = bind_reason_lookup([
-    [ 0x00, 'Success' ],
-    [ 0x92, 'Packet Identifier not found' ],
-  ]);
-
-  return ns[0x5] = ns[0x6] = ns[0x7] = (pkt, u8_body) => {
-    const rdr = new mqtt_type_reader(u8_body, 0);
 
-    pkt.pkt_id = rdr.u16();
-    pkt.reason = rdr.u8_reason(_pubxxx_reason_);
-    if (5 <= pkt.mqtt_level)
-      pkt.props = rdr.props();
-    return pkt }
+function _puback_v5(mqtt_reader) {
+  mqtt_reader.reasons('puback',
+    // MQTT 5.0
+    [ 0x00, 'Success'],
+    [ 0x10, 'No matching subscribers'],
+    [ 0x80, 'Unspecified error'],
+    [ 0x83, 'Implementation specific error'],
+    [ 0x87, 'Not authorized'],
+    [ 0x90, 'Topic Name invalid'],
+    [ 0x91, 'Packet identifier in use'],
+    [ 0x97, 'Quota exceeded'],
+    [ 0x99, 'Payload format invalid'],
+  );
 }
 
-function _mqtt_decode_suback(_ack_reason_) {
+function _mqtt_decode_suback(mqtt_reader) {
   return (pkt, u8_body) => {
-    const rdr = new mqtt_type_reader(u8_body, 0);
+    let rdr = mqtt_reader.of(u8_body);
 
     pkt.pkt_id = rdr.u16();
     if (5 <= pkt.mqtt_level)
       pkt.props = rdr.props();
 
-    const answers = pkt.answers = [];
+    let answers = pkt.answers = [];
     while (rdr.has_more())
       answers.push(
-        rdr.u8_reason(_ack_reason_) );
+        rdr.reason(pkt.type) );
 
     return pkt }
 }
 
-function mqtt_decode_suback(ns) {
-  const _suback_reason_ = bind_reason_lookup([
+function mqtt_decode_suback(ns, mqtt_reader) {
+  return ns[0x9] = _mqtt_decode_suback(mqtt_reader)
+}
+
+function _suback_v4(mqtt_reader) {
+  mqtt_reader.reasons('suback',
     // MQTT 3.1.1
     [ 0x00, 'Granted QoS 0'],
     [ 0x01, 'Granted QoS 1'],
     [ 0x02, 'Granted QoS 2'],
+  );
+}
 
+function _suback_v5(mqtt_reader) {
+  _suback_v4(mqtt_reader);
+
+  mqtt_reader.reasons('suback',
     // MQTT 5.0
     [ 0x80, 'Unspecified error'],
     [ 0x83, 'Implementation specific error'],
@@ -375,13 +471,16 @@ function mqtt_decode_suback(ns) {
     [ 0x9E, 'Shared Subscriptions not supported'],
     [ 0xA1, 'Subscription Identifiers not supported'],
     [ 0xA2, 'Wildcard Subscriptions not supported'],
-  ]);
+  );
+}
 
-  return ns[0x9] = _mqtt_decode_suback(_suback_reason_)
+function mqtt_decode_unsuback(ns, mqtt_reader) {
+  return ns[0xb] = _mqtt_decode_suback(mqtt_reader)
 }
 
-function mqtt_decode_unsuback(ns) {
-  const _unsuback_reason_ = bind_reason_lookup([
+function _unsuback_v4(mqtt_reader) {
+  mqtt_reader.reasons('unsuback',
+    // MQTT 3.1.1
     [ 0x00, 'Success'],
     [ 0x11, 'No subscription existed'],
     [ 0x80, 'Unspecified error'],
@@ -389,17 +488,26 @@ function mqtt_decode_unsuback(ns) {
     [ 0x87, 'Not authorized'],
     [ 0x8F, 'Topic Filter invalid'],
     [ 0x91, 'Packet Identifier in use'],
-  ]);
-
-  return ns[0xb] = _mqtt_decode_suback(_unsuback_reason_)
+  );
 }
 
 function mqtt_decode_pingxxx(ns) {
   return ns[0xc] = ns[0xd] = pkt => pkt
 }
 
-function mqtt_decode_disconnect(ns) {
-  const _disconnect_reason_ = bind_reason_lookup([
+function mqtt_decode_disconnect(ns, mqtt_reader) {
+  return ns[0xe] = (pkt, u8_body) => {
+    if (u8_body && 5 <= pkt.mqtt_level) {
+      let rdr = mqtt_reader.of(u8_body);
+      pkt.reason = rdr.reason(pkt.type);
+      pkt.props = rdr.props();
+    }
+    return pkt }
+}
+
+
+function _disconnect_v5(mqtt_reader) {
+  mqtt_reader.reasons('disconnect',
     // MQTT 5.0
     [ 0x00, 'Normal disconnection'],
     [ 0x04, 'Disconnect with Will Message'],
@@ -430,181 +538,33 @@ function mqtt_decode_disconnect(ns) {
     [ 0xA0, 'Maximum connect time'],
     [ 0xA1, 'Subscription Identifiers not supported'],
     [ 0xA2, 'Wildcard Subscriptions not supported'],
-  ]);
-
-
-  return ns[0xe] = (pkt, u8_body) => {
-    if (u8_body && 5 <= pkt.mqtt_level) {
-      const rdr = new mqtt_type_reader(u8_body, 0);
-      pkt.reason = rdr.u8_reason(_disconnect_reason_);
-      pkt.props = rdr.props();
-    }
-    return pkt }
+  );
 }
 
-function mqtt_decode_auth(ns) {
-  const _auth_reason_ = bind_reason_lookup([
-    // MQTT 5.0
-    [ 0x00, 'Success' ],
-    [ 0x18, 'Continue authentication' ],
-    [ 0x19, 'Re-authenticate' ],
-  ]);
-
+function mqtt_decode_auth(ns, mqtt_reader) {
   return ns[0xf] = (pkt, u8_body) => {
     if ( 5 <= pkt.mqtt_level ) {
-      const rdr = new mqtt_type_reader(u8_body, 0);
-      pkt.reason = rdr.u8_reason(_auth_reason_);
+      let rdr = mqtt_reader.of(u8_body);
+      pkt.reason = rdr.reason(pkt.type);
       pkt.props = rdr.props();
     }
     return pkt }
 }
 
-function mqtt_pkt_writer_pool() {
-  const _pool_ = [];
-  return host =>
-    0 === _pool_.length
-      ? mqtt_pkt_writer(host, _pool_)
-      : _pool_.pop()(host)
-}
-
-function mqtt_pkt_writer(host, _pool_) {
-  // avoid GCing push/pull when they can be reused
-  let n=0, rope=[];
-  return install(host)
 
-  function install(_host) {
-    host = _host;
-    host.push = push;
-    host.pack = pack;
-  }
-
-  function push(u8) {
-    rope.push(u8);
-    n += u8.length;
-  }
-
-  function pack(hdr) {
-    host = host.push = host.pack = null;
-
-    const res = _mqtt_pkt_rope(hdr, n, rope);
-    n=0; rope=[];
-    if (undefined !== _pool_)
-      _pool_.push(install);
-
-    return res
-  }
-}
-
-
-function _mqtt_pkt_rope(hdr, n, rope) {
-  const header = encode_varint(n, hdr);
-  let i = header.length;
-
-  const pkt = new Uint8Array(n + i);
-  pkt.set(header, 0);
-  for (const vec of rope) {
-    pkt.set(vec, i);
-    i += vec.length;
-  }
-  return pkt
-}
-
-const _is_array = Array.isArray;
-const pack_utf8 = v => new TextEncoder('utf-8').encode(v);
-const pack_u16 = v => [ (v>>>8) & 0xff, v & 0xff ];
-const pack_u32 = v => [ (v>>>24) & 0xff, (v>>>16) & 0xff, (v>>>8) & 0xff, v & 0xff ];
-
-class mqtt_type_writer {
-  constructor() {
-    this._pkt_writer(this);
-  }
-
-  as_pkt(hdr) { return this.pack([hdr]) }
-
-  u8(v) { this.push([ v & 0xff ]);}
-  u16(v) { this.push( pack_u16(v) );}
-  u32(v) { this.push( pack_u32(v) );}
-  vint(v) { this.push( encode_varint(v) );}
-
-  _u16_bin(u8_buf) {
-    const {push} = this;
-    push( pack_u16( u8_buf.byteLength ));
-    push( u8_buf );
-  }
-
-  flush(buf) {
-    if (null != buf)
-      this.push(
-        'string' === typeof buf
-          ? pack_utf8(buf) : buf );
-
-    this.push = false;
-  }
-
-  bin(u8_buf) {
-    if (! u8_buf) return this.u16(0)
-    if ('string' === typeof u8_buf)
-      return this.utf8(u8_buf)
-
-    if (u8_buf.length !== u8_buf.byteLength)
-      u8_buf = new Uint8Array(u8_buf);
-    this._u16_bin(u8_buf);
-  }
-
-  utf8(v) { this._u16_bin( new TextEncoder('utf-8').encode(v) ); }
-
-  pair(k,v) {
-    this.utf8(k);
-    this.utf8(v);
-  }
-
-  u8_flags(v, enc_flags, b0=0) {
-    if (undefined !== v && isNaN(+v))
-      v = enc_flags(v, 0);
-
-    v |= b0;
-    this.push([v]);
-    return v
-  }
-
-  u8_reason(v) { this.push([v | 0]); }
-
-  props(props) {
-    if (! props)
-      return this.u8(0)
-
-    if (! _is_array(props))
-      props = props.entries
-        ? Array.from(props.entries())
-        : Object.entries(props);
-
-    if (0 === props.length)
-      return this.u8(0)
-
-    const wrt = this._fork();
-    for (const [name, value] of props) {
-      const {id, type} = mqtt_props.get(name);
-      wrt.u8(id);
-      wrt[type](value);
-    }
-
-    this.push(wrt.pack([]));
-  }
-
-  _fork() {
-    let self = { __proto__: this };
-    this._pkt_writer(self);
-    return self
-  }
+function _auth_v5(mqtt_reader) {
+  mqtt_reader.reasons('auth',
+    // MQTT 5.0
+    [ 0x00, 'Success' ],
+    [ 0x18, 'Continue authentication' ],
+    [ 0x19, 'Re-authenticate' ],
+  );
 }
 
-mqtt_type_writer.prototype._pkt_writer = 
-  mqtt_pkt_writer_pool();
-
-const _c_mqtt_proto = new Uint8Array([
-  0, 4, 0x4d, 0x51, 0x54, 0x54 ]);
+function mqtt_encode_connect(ns, mqtt_writer) {
+  const _c_mqtt_proto = new Uint8Array([
+    0, 4, 0x4d, 0x51, 0x54, 0x54 ]);
 
-function mqtt_encode_connect(ns) {
   const _enc_flags_connect = flags => 0
       | ( flags.reserved ? 0x01 : 0 )
       | ( (flags.will_qos & 0x3) << 3 )
@@ -619,13 +579,13 @@ function mqtt_encode_connect(ns) {
       | ( will.retain ? 0x20 : 0 );
 
   return ns.connect = ( mqtt_level, pkt ) => {
-    const wrt = new mqtt_type_writer();
+    let wrt = mqtt_writer.of(pkt);
 
     wrt.push(_c_mqtt_proto);
     wrt.u8( mqtt_level );
 
-    const {will, username, password} = pkt;
-    const flags = wrt.u8_flags(
+    let {will, username, password} = pkt;
+    let flags = wrt.flags(
       pkt.flags,
       _enc_flags_connect,
       0 | (username ? 0x80 : 0)
@@ -657,10 +617,10 @@ function mqtt_encode_connect(ns) {
   }
 }
 
-function mqtt_encode_publish(ns) {
+function mqtt_encode_publish(ns, mqtt_writer) {
   return ns.publish = ( mqtt_level, pkt ) => {
-    const qos = (pkt.qos & 0x3) << 1;
-    const wrt = new mqtt_type_writer();
+    let qos = (pkt.qos & 0x3) << 1;
+    let wrt = mqtt_writer.of(pkt);
 
     wrt.utf8(pkt.topic);
     if (0 !== qos)
@@ -678,13 +638,13 @@ function mqtt_encode_publish(ns) {
   }
 }
 
-function mqtt_encode_puback(ns) {
+function mqtt_encode_puback(ns, mqtt_writer) {
   return ns.puback = ( mqtt_level, pkt ) => {
-    const wrt = new mqtt_type_writer();
+    let wrt = mqtt_writer.of(pkt);
 
     wrt.u16(pkt.pkt_id);
     if (5 <= mqtt_level) {
-      wrt.u8_reason(pkt.reason);
+      wrt.reason(pkt.reason);
       wrt.props(pkt.props);
     }
 
@@ -692,32 +652,32 @@ function mqtt_encode_puback(ns) {
   }
 }
 
-function mqtt_encode_subscribe(ns) {
+function mqtt_encode_subscribe(ns, mqtt_writer) {
   const _enc_subscribe_flags = opts => 0
       | ( opts.qos & 0x3 )
       | ( opts.retain ? 0x4 : 0 )
       | ( (opts.retain_handling & 0x3) << 2 );
 
   return ns.subscribe = ( mqtt_level, pkt ) => {
-    const wrt = new mqtt_type_writer();
+    let wrt = mqtt_writer.of(pkt);
 
     wrt.u16(pkt.pkt_id);
     if (5 <= mqtt_level)
       wrt.props(pkt.props);
 
-    const f0 = _enc_subscribe_flags(pkt);
-    for (const each of pkt.topics) {
+    let f0 = _enc_subscribe_flags(pkt);
+    for (let each of pkt.topics) {
       if ('string' === typeof each) {
         wrt.utf8(each);
         wrt.u8(f0);
       } else {
         let [topic, opts] =
-          _is_array(each) ? each
+          Array.isArray(each) ? each
             : [each.topic, each.opts];
 
         wrt.utf8(topic);
         if (undefined === opts) wrt.u8(f0);
-        else wrt.u8_flags(opts, _enc_subscribe_flags);
+        else wrt.flags(opts, _enc_subscribe_flags);
       }
     }
 
@@ -725,15 +685,15 @@ function mqtt_encode_subscribe(ns) {
   }
 }
 
-function mqtt_encode_unsubscribe(ns) {
+function mqtt_encode_unsubscribe(ns, mqtt_writer) {
   return ns.unsubscribe = ( mqtt_level, pkt ) => {
-    const wrt = new mqtt_type_writer();
+    let wrt = mqtt_writer.of(pkt);
 
     wrt.u16(pkt.pkt_id);
     if (5 <= mqtt_level)
       wrt.props(pkt.props);
 
-    for (const topic of pkt.topics)
+    for (let topic of pkt.topics)
       wrt.utf8(topic);
 
     return wrt.as_pkt(0xa2)
@@ -745,13 +705,13 @@ function mqtt_encode_pingxxx(ns) {
   ns.pingresp = () => new Uint8Array([ 0xd0, 0 ]);
 }
 
-function mqtt_encode_disconnect(ns) {
+function mqtt_encode_disconnect(ns, mqtt_writer) {
   return ns.disconnect = ( mqtt_level, pkt ) => {
-    const wrt = new mqtt_type_writer();
+    let wrt = mqtt_writer.of(pkt);
 
     if (pkt && 5 <= mqtt_level) {
       if (pkt.reason || pkt.props) {
-        wrt.u8_reason(pkt.reason);
+        wrt.reason(pkt.reason);
         wrt.props(pkt.props);
       }
     }
@@ -760,185 +720,250 @@ function mqtt_encode_disconnect(ns) {
   }
 }
 
-function mqtt_encode_auth(ns) {
+function mqtt_encode_auth(ns, mqtt_writer) {
   return ns.auth = ( mqtt_level, pkt ) => {
     if (5 > mqtt_level)
       throw new Error('Auth packets are only available after MQTT 5.x')
 
-    const wrt = new mqtt_type_writer();
+    let wrt = mqtt_writer.of(pkt);
 
-    wrt.u8_reason(pkt.reason);
+    wrt.reason(pkt.reason);
     wrt.props(pkt.props);
 
     return wrt.as_pkt(0xf0)
   }
 }
 
+const mqtt_decode_v5 =  [
+  mqtt_decode_connack,
+  mqtt_decode_publish,
+  mqtt_decode_puback,
+  mqtt_decode_suback,
+  mqtt_decode_unsuback,
+  mqtt_decode_pingxxx,
+  mqtt_decode_disconnect,
+  mqtt_decode_auth,
+];
+
+
+const mqtt_encode_v5 =  [
+  mqtt_encode_connect,
+  mqtt_encode_puback,
+  mqtt_encode_publish,
+  mqtt_encode_subscribe,
+  mqtt_encode_unsubscribe,
+  mqtt_encode_pingxxx,
+  mqtt_encode_disconnect,
+  mqtt_encode_auth,
+];
+
+const mqtt_reader_v5 = /* #__PURE__ */
+  mqtt_reader_info(
+    mqtt_reader_v5$1,
+    _connack_v5,
+    _puback_v5,
+    _suback_v5,
+    _unsuback_v4,
+    _disconnect_v5,
+    _auth_v5,
+  );
+
+
+const mqtt_opts_v5 = 
+  { decode_fns: mqtt_decode_v5,
+    mqtt_reader: mqtt_reader_v5,
+    encode_fns: mqtt_encode_v5,
+    mqtt_writer: mqtt_writer_v5, };
 
-function _bind_mqtt_decode(lst_decode_ops) {
-  const by_id = [];
-  for (const op of lst_decode_ops) op(by_id);
+/*
+export function decode_varint_loop(u8, i=0) {
+  let i0 = i
+  let shift = 0, n = (u8[i] & 0x7f)
+  while ( 0x80 & u8[i++] )
+    n |= (u8[i] & 0x7f) << (shift += 7)
 
-  return _pkt_ctx_ => _mqtt_raw_pkt_dispatch(
-    (b0, u8_body) => {
-      const decode_pkt = by_id[b0>>>4] || by_id[0];
-      if (undefined !== decode_pkt)
-        return decode_pkt({__proto__: _pkt_ctx_, b0}, u8_body)
-    })
+  return [n, i, i0]
 }
+*/
 
 
-function _bind_mqtt_encode(lst_encode_ops) {
-  const by_type = {};
-  for (const op of lst_encode_ops) op(by_type);
-
-  return ({mqtt_level}) => (type, pkt) =>
-      by_type[type]( mqtt_level, pkt )
+function decode_varint(u8, i=0) {
+  let i0 = i;
+  // unrolled for a max of 4 chains
+  let n = (u8[i] & 0x7f) <<  0;
+  if ( 0x80 & u8[i++] ) {
+    n |= (u8[i] & 0x7f) <<  7;
+    if ( 0x80 & u8[i++] ) {
+      n |= (u8[i] & 0x7f) << 14;
+      if ( 0x80 & u8[i++] ) {
+        n |= (u8[i] & 0x7f) << 21;
+      }
+    }
+  }
+  return [n, i, i0]
 }
 
+function mqtt_raw_dispatch(opt) {
+  let u8 = new Uint8Array(0);
+  return u8_buf => {
+    u8 = 0 === u8.byteLength
+      ? u8_buf : _u8_join(u8, u8_buf);
 
-const _pkt_types = ['reserved', 'connect', 'connack', 'publish', 'puback', 'pubrec', 'pubrel', 'pubcomp', 'subscribe', 'suback', 'unsubscribe', 'unsuback', 'pingreq', 'pingresp', 'disconnect', 'auth'];
-const _bind_pkt_ctx = _pkt_ctx_ =>
-  Object.defineProperties(_pkt_ctx_ || {}, {
-    hdr:  {get() { return this.b0 & 0xf }},
-    id:   {get() { return this.b0 >>> 4 }},
-    type: {get() { return _pkt_types[this.b0 >>> 4] }},
-  });
+    let res = [];
+    while (1) {
+      let [len_body, len_vh] = decode_varint(u8, 1);
+      let len_pkt = len_body + len_vh;
 
-function _bind_mqtt_session_ctx(sess_decode, sess_encode, _pkt_ctx_) {
-  sess_decode = _bind_mqtt_decode(sess_decode);
-  sess_encode = _bind_mqtt_encode(sess_encode);
-  _pkt_ctx_ = _bind_pkt_ctx(_pkt_ctx_);
+      if ( u8.byteLength < len_pkt )
+        return res
 
-  return mqtt_level => _base_ => {
-    _base_ = _base_ || {__proto__: _pkt_ctx_, mqtt_level, get _base_() { return _base_ }};
-    return [ sess_decode(_base_), sess_encode(_base_), _base_ ] }
-}
+      let b0 = u8[0];
+      let u8_body = 0 === len_body ? null
+        : u8.subarray(len_vh, len_pkt);
 
-function mqtt_session_ctx(mqtt_level) {
-  let {ctx} = mqtt_session_ctx;
-  if (undefined === ctx ) {
-    let as_utf8 = u8 =>
-      new TextDecoder('utf-8').decode(u8);
-
-    let std_pkt_api = {
-      utf8(u8) { return as_utf8( u8 || this.payload ) },
-      json(u8) { return JSON.parse( this.utf8(u8) || null ) },
-      text(u8) { return this.utf8(u8) },
-    };
-
-    mqtt_session_ctx.ctx = ctx =
-      _bind_mqtt_session_ctx(
-        [ // lst_decode_ops
-          mqtt_decode_connack,
-          mqtt_decode_disconnect,
-          mqtt_decode_publish,
-          mqtt_decode_puback,
-          mqtt_decode_pubxxx,
-          mqtt_decode_pingxxx,
-          mqtt_decode_suback,
-          mqtt_decode_unsuback,
-          mqtt_decode_auth, ],
-
-        [ // lst_encode_ops
-          mqtt_encode_connect,
-          mqtt_encode_disconnect,
-          mqtt_encode_publish,
-          mqtt_encode_puback,
-          mqtt_encode_pingxxx,
-          mqtt_encode_subscribe,
-          mqtt_encode_unsubscribe,
-          mqtt_encode_auth, ],
-
-        std_pkt_api );
+      u8 = u8.subarray(len_pkt);
+
+      let pkt = opt.decode_pkt(b0, u8_body, opt);
+      if (null != pkt)
+        res.push( pkt );
+    }
   }
+}
 
-  return ctx(mqtt_level)
+function _u8_join(a, b) {
+  let alen = a.byteLength, r = new Uint8Array(alen + b.byteLength);
+  r.set(a, 0);
+  r.set(b, alen);
+  return r
 }
 
-function _mqtt_conn(client, [on_mqtt, pkt_future]) {
-  let q0 = _tiny_deferred_queue();
-  let q = _tiny_deferred_queue();
+const _pkt_types = ['~', 'connect', 'connack', 'publish', 'puback', 'pubrec', 'pubrel', 'pubcomp', 'subscribe', 'suback', 'unsubscribe', 'unsuback', 'pingreq', 'pingresp', 'disconnect', 'auth'];
 
-  let _asy_send = async (...args) =>
-    (await q)(...args);
-  let _send = client._send = _asy_send;
+function mqtt_pkt_ctx(mqtt_level, opts, pkt_ctx) {
+  pkt_ctx = {
+    __proto__: pkt_ctx || opts.pkt_ctx,
+    mqtt_level,
+    get hdr() { return this.b0 & 0xf },
+    get id() { return this.b0 >>> 4 },
+    get type() { return _pkt_types[this.b0 >>> 4] },
+  };
 
-  let _ping = () => client._send('pingreq');
-  let tid_ping, _is_set = false;
+  let op, _decode_by_id=[], _encode_by_type={};
+  for (op of opts.encode_fns)
+    op(_encode_by_type, opts.mqtt_writer);
+  for (op of opts.decode_fns)
+    op(_decode_by_id, opts.mqtt_reader);
 
   return {
-    is_live: (() =>_asy_send !== _send)
-  , is_set: (() =>_is_set)
+    pkt_ctx,
 
-  , reset() {
-      tid_ping = clearInterval(tid_ping);
-      client._send = _send = _asy_send;
-      _is_set = false;
+    encode_pkt(type, pkt) {
+      return _encode_by_type[type]( mqtt_level, pkt ) },
 
-      // call client.on_reconnect in next promise microtask
-      _async_evt(client, client.on_reconnect);}
+    decode_pkt(b0, u8_body) {
+      let fn_decode = _decode_by_id[b0>>>4] || _decode_by_id[0];
+      return fn_decode?.({__proto__: this.pkt_ctx, b0}, u8_body) },
 
-  , ping(td) {
-      tid_ping = clearInterval(tid_ping);
-      if (td) {
-        tid_ping = setInterval(_ping, 1000 * td);
-        if (tid_ping.unref) {
-          tid_ping.unref();} } }
+    mqtt_stream() {
+      let self = { __proto__: this, pkt_ctx: { __proto__: pkt_ctx } };
+      self.pkt_ctx._base_ = self.pkt_ctx;
+      self.decode = mqtt_raw_dispatch(self);
+      return self
+    },
+  }
+}
+
+Object.freeze({ao_done: true});
+
+function ao_defer_ctx(as_res = (...args) => args) {
+  let y,n,_pset = (a,b) => { y=a, n=b; };
+  return p =>(
+    p = new Promise(_pset)
+  , as_res(p, y, n)) }
+
+const ao_defer_v = /* #__PURE__ */
+  ao_defer_ctx();
+
+Promise.resolve({type:'init'});
+
+function _mqtt_conn(client, [on_mqtt, pkt_future]) {
+  let _q_init = ao_defer_v(), _q_ready = ao_defer_v();
+  let _send_ready = async (...args) => (await _q_ready[0])(...args);
+  let _send_mqtt_pkt, _has_connected;
+  client._send = _send_ready;
+
+  return {
+    async when_ready() {await _q_ready[0];}
+
+  , ping: _ping_interval (() =>_send_mqtt_pkt?.('pingreq'))
+
+  , reset(err) {
+      if (! _send_mqtt_pkt) {return}
+
+      if (err) {
+        _q_init[2](err);}
+
+      _send_mqtt_pkt = null;
+      _q_init = ao_defer_v();
+      client._send = _send_ready;
+
+      // call client.on_conn_reset in next promise microtask
+      client.conn_emit('on_disconnect', false===err, err);}
 
   , async send_connect(... args) {
-      if (_asy_send === _send) {
-        _send = await q0;}
+      if (! _send_mqtt_pkt) {
+        await _q_init[0]; }// _send_mqtt_pkt is set before fulfilled
 
       // await connack response
-      let res = await _send(...args);
+      let res = await _send_mqtt_pkt(...args);
+      if (0 == res[0].reason) {
+        _has_connected = true;
+        // resolve _q_ready[0] with _send_mqtt_pkt closure
+        _q_ready[1](client._send = _send_mqtt_pkt);
+        _q_ready = ao_defer_v();
+        client.conn_emit('on_ready');}
 
-      client._send = _send;
-      q.notify(_send);
       return res}
 
-  , set(mqtt_session, send_u8_pkt) {
-      _is_set = true;
-
-      let [mqtt_decode, mqtt_encode] = mqtt_session;
+  , is_set: (() =>!! _send_mqtt_pkt)
+  , set(mqtt_ctx, send_u8_pkt) {
+      if (_send_mqtt_pkt) {
+        throw new Error('Already connected')}
 
+      mqtt_ctx = mqtt_ctx.mqtt_stream();
+      let sess_ctx = {mqtt: client};
       let on_mqtt_chunk = u8_buf =>
-        on_mqtt(
-          mqtt_decode(u8_buf),
-          {mqtt: client});
+        on_mqtt(mqtt_ctx.decode(u8_buf), sess_ctx);
 
-      _send = async (type, pkt, key) => {
+      _send_mqtt_pkt = async (type, pkt, key) => {
         let res = undefined !== key
           ? pkt_future(key) : true;
 
         await send_u8_pkt(
-          mqtt_encode(type, pkt));
+          mqtt_ctx.encode_pkt(type, pkt));
 
         return res};
 
-
-      q0.notify(_send);
+      _q_init[1](_send_mqtt_pkt); // resolve _q_init with _send_mqtt_pkt closure
 
       // call client.on_live in next promise microtask
-      _async_evt(client, client.on_live);
-
+      client.conn_emit('on_live', _has_connected);
       return on_mqtt_chunk} } }
 
 
-async function _async_evt(obj, evt) {
-  // microtask break lookup
-  if (undefined !== evt) {
-    await evt.call(obj, await obj);
-  }
-}
-function _tiny_deferred_queue() {
-  let q = []; // tiny resetting deferred queue
-  q.then = y => { q.push(y); };
-  q.notify = v => {
-    for (let fn of q.splice(0,q.length))
-      fn(v); };
-  return q
-}
+function _ping_interval(send_ping) {
+  let tid;
+  return (( td ) => {
+    tid = clearInterval(tid);
+    if (td) {
+      tid = setInterval(send_ping, 1000 * td);
+      
+
+
+      
+      // ensure the interval allows the NodeJS event loop to exit
+      tid.unref?.();
+      return true} }) }
 
 function parse(str, loose) {
 	if (str instanceof RegExp) return { keys:false, pattern:str };
@@ -972,7 +997,7 @@ function parse(str, loose) {
 function _ignore(pkt, params, ctx) {ctx.done = true;}
 
 function _mqtt_topic_router() {
-  let pri_lsts = [[],[]];
+  let pri_lsts = [[],[]], rm = Symbol();
   let find = topic => _mqtt_routes_iter(pri_lsts, topic);
 
   return {find,
@@ -996,8 +1021,7 @@ function _mqtt_topic_router() {
 
   , remove(topic_route, priority) {
       let lst = pri_lsts[priority ? 0 : 1];
-      lst = lst.filter(e => e.key !== topic_route);
-      pri_lsts[priority ? 0 : 1] = lst;}
+      return _mqtt_route_remove([lst], topic_route)}
 
   , clear(priority) {
       pri_lsts[priority ? 0 : 1] = [];
@@ -1006,9 +1030,13 @@ function _mqtt_topic_router() {
 
   , async invoke(pkt, ctx) {
       ctx.idx = 0;
+      ctx.rm = rm;
 
       for (let [fn, params] of find(pkt.topic)) {
-        await fn(pkt, params, ctx);
+        let res = await fn(pkt, params, ctx);
+
+        if (rm === res) {
+          _mqtt_route_remove(pri_lsts, fn);}
 
         if (ctx.done) {
           break}
@@ -1054,6 +1082,14 @@ function _mqtt_route_match_one(topic, {keys, pattern, tgt}) {
     params[ keys[i] ] = match[1+i];}
   return [tgt, params]}
 
+
+function _mqtt_route_remove(all_route_lists, query) {
+  let match = route => route===query || route.tgt===query || route.key===query;
+  for (let lst of all_route_lists) {
+    let i = lst.findIndex(match);
+    if (0 <= i) {return !! lst.splice(i,1)} }
+  return false}
+
 const _mqtt_cmdid_dispatch ={
   create(target) {
     return {__proto__: this, target, hashbelt: [new Map()]} }
@@ -1146,20 +1182,38 @@ function _mqtt_dispatch(opt, target) {
       _disp_.rotate_belt(rotate_n);
       rotate_ts = rotate_td + Date.now();} } }
 
-class MQTTBaseClient {
+class MQTTError extends Error {
+  constructor(mqtt_pkt, reason=mqtt_pkt.reason) {
+    super(`[0x${reason.toString(16)}] ${reason.reason}`);
+    this.mqtt_pkt = mqtt_pkt;
+    this.reason = reason;} }
+
+class MQTTBase {
   constructor(opt={}) {
     this._conn_ = _mqtt_conn(this,
       this._init_dispatch(opt, this)); }
 
+  async conn_emit(evt, arg, err_arg) {
+    this.log_conn?.(evt, arg, err_arg);
+    try {
+      let fn_evt = this[await evt]; // microtask break
+      if (fn_evt) {
+        await fn_evt.call(this, this, arg, err_arg);}
+      else if (err_arg) {
+        await this.on_error(err_arg, evt);} }
+    catch (err) {
+      this.on_error(err, evt);} }
+
+  on_error(err, err_path) {
+    console.warn('[[u8-mqtt error: %s]]', err_path, err); }
+
   // Handshaking Packets
 
   async connect(pkt={}) {
-    let {client_id: cid} = pkt;
-    if (! cid) {
-      pkt.client_id = cid = this.init_client_id(['u8-mqtt--', '']);}
-    else if (Array.isArray(cid)) {
+    let cid = pkt.client_id || ['u8-mqtt--', ''];
+    if (Array.isArray(cid)) {
       pkt.client_id = cid = this.init_client_id(cid);}
-    else {this.client_id = cid;}
+    this.client_id = cid;
 
     if (null == pkt.keep_alive) {
       pkt.keep_alive = 60;}
@@ -1167,13 +1221,16 @@ class MQTTBaseClient {
     let res = await this._conn_
       .send_connect('connect', pkt, 'connack');
 
+    if (0 != res[0].reason) {
+      throw new this.MQTTError(res[0])}
+
     // TODO: merge with server's keep_alive frequency
     this._conn_.ping(pkt.keep_alive);
     return res}
 
   async disconnect(pkt={}) {
     let res = await this._send('disconnect', pkt);
-    this._conn_.reset();
+    this._conn_.reset(false);
     return res}
 
   auth(pkt={}) {
@@ -1187,8 +1244,9 @@ class MQTTBaseClient {
     pkt = _as_topics(pkt, ex);
     return this._send('subscribe', pkt, pkt)}
   _sub_chain(topic, ex) {
+    let res = this.subscribe([[ topic ]], ex);
     let subs = this.subs ||(this.subs = new Map());
-    subs.set(topic, this.subscribe([[ topic ]], ex));
+    subs.set((res.topic = topic), (subs.last = res));
     return this }// fluent api -- return this and track side effects
 
   // alias: unsub
@@ -1282,22 +1340,19 @@ class MQTTBaseClient {
     return this.router = _mqtt_topic_router()}
 
   _init_dispatch(opt) {
-    let router = this._init_router(opt, this);
-
     let tgt ={
       __proto__: opt.on_mqtt_type || {}
-    , router};
-
-    if (! tgt.mqtt_publish) {
-      tgt.mqtt_publish = router.invoke;}
+    , router: this._init_router(opt, this)};
 
+    tgt.mqtt_publish ||= tgt.router.invoke;
     return _mqtt_dispatch(this, tgt)} }
 
 
  {
-  let p = MQTTBaseClient.prototype;
+  let p = MQTTBase.prototype;
   Object.assign(p,{
-    pub: p.publish
+    MQTTError
+  , pub: p.publish
   , sub: p.subscribe
   , unsub: p.unsubscribe
   , sub_topic: p.subscribe_topic
@@ -1376,45 +1431,67 @@ async function _pub(self, pkt, pub_opt) {
   , oqr: (self, topic, msg, pub_opt) =>
       _pub(self, {topic, msg, arg: 'msg', qos:1, retain: 1}, pub_opt)} ); }
 
-class MQTTCoreClient extends MQTTBaseClient {
-  static _with_session(mqtt_session) {
-    this.prototype._mqtt_session = mqtt_session;}
+const pkt_api = {
+  utf8(u8) { return new TextDecoder('utf-8').decode(u8 || this.payload ) },
+  json(u8) { return JSON.parse( this.utf8(u8) || null ) },
+  text(u8) { return this.utf8(u8) },
+};
 
+class MQTTCore extends MQTTBase {
   constructor(opt={}) {
     super(opt);
-    this.with_live(opt.on_live);
-    this.with_reconnect(opt.on_reconnect);}
+    this.with(opt);}
 
+  static mqtt_ctx(mqtt_level, mqtt_opts, pkt_ctx=pkt_api) {
+    let self = class extends this {};
+    self.prototype.mqtt_ctx =
+      mqtt_pkt_ctx(mqtt_level, mqtt_opts, pkt_ctx);
+    return self}
 
-  // on_live(client) ::
-  with_live(on_live) {
-    if (on_live) {
-      this.on_live = on_live;}
-
+  with(fns_ns) {
+    for (let [k,v] of Object.entries(fns_ns)) {
+      if ('function' === typeof v) {this[k] = v;} }
     return this}
 
-  // on_reconnect(client) ::
-  with_reconnect(on_reconnect) {
-    if (on_reconnect) {
-      this.on_reconnect = on_reconnect;
+  //log_conn(evt, arg, err_arg) ::
+  //console.info @ '[[u8-mqtt log: %s]]', evt, arg, err_arg
 
-      if (! this._conn_.is_set) {
-        on_reconnect(this);} }
+  on_live(client, is_reconnect) {
+    if (is_reconnect) {
+      return client.connect()} }
 
-    return this}
+  //on_reconnect(client) ::
 
+  _use_conn(fn_reconnect) {
+    return (this.reconnect = fn_reconnect)?.()}
+  with_autoreconnect(opt=2000) {
+    if (opt.toFixed) {opt ={delay: opt};}
+    return this.with({
+      on_reconnect() {
+        this.delay(opt.delay || 2000)
+          .then(this.reconnect)
+          .then(opt.reconnect, opt.error);} }) }
+
+  on_disconnect(client, intentional) {
+    if (! intentional) {
+      return client.on_reconnect?.()} }
+
+  delay(ms) {
+    return new Promise(done => setTimeout(done, ms)) }
 
   with_async_iter(async_iter, write_u8_pkt) {
     let on_mqtt_chunk = this._conn_.set(
-      this._mqtt_session(),
+      this.mqtt_ctx,
       write_u8_pkt);
 
     this._msg_loop = ((async () => {
-      async_iter = await async_iter;
-      for await (let chunk of async_iter)
-        on_mqtt_chunk(chunk);
-
-      this._conn_.reset();})());
+      try {
+        async_iter = await async_iter;
+        for await (let chunk of async_iter)
+          on_mqtt_chunk(chunk);
+        this._conn_.reset();}
+      catch (err) {
+        this._conn_.reset(err);} })());
 
     return this}
 
@@ -1434,16 +1511,17 @@ class MQTTCoreClient extends MQTTBaseClient {
 
 
 
+
   
   with_tcp(port, hostname) {
     if (!Number.isFinite(port)) {
       ({port, hostname} = new URL(port));}
 
-    let sock = net.connect(port, hostname);
-    return this.with_stream(sock)}
+    return this._use_conn (() =>
+      this.with_stream(
+        node_net.connect(port, hostname)) ) }
 
 
-  
   with_stream(read_stream, write_stream) {
     if (undefined === write_stream) {
       write_stream = read_stream;}
@@ -1452,14 +1530,12 @@ class MQTTCoreClient extends MQTTBaseClient {
       u8_pkt => write_stream.write(u8_pkt)) }
 
 
-
-
   with_websock(websock) {
-    if (null == websock) {
-      websock = 'ws://127.0.0.1:9001';}
-
-    if (websock.origin || 'string' === typeof websock) {
-      websock = new WebSocket(new URL(websock), ['mqtt']);}
+    if (! websock?.send) {
+      websock = new URL(websock || 'ws://127.0.0.1:9001');
+      return this._use_conn (() =>
+        this.with_websock(
+          new WebSocket(websock, ['mqtt'])) ) }
 
     websock.binaryType = 'arraybuffer';
 
@@ -1468,54 +1544,53 @@ class MQTTCoreClient extends MQTTBaseClient {
       if (0 !== readyState) {
         throw new Error('Invalid WebSocket readyState') }
 
-      ready = new Promise( y =>
-        websock.addEventListener('open', y, {once: true}));}
+      ready = new Promise(fn => websock.onopen = fn); }
 
 
     let {_conn_} = this;
     let on_mqtt_chunk = _conn_.set(
-      this._mqtt_session(),
+      this.mqtt_ctx,
       async u8_pkt =>(
         await ready
       , websock.send(u8_pkt)) );
 
-    websock.addEventListener('close',
-      (() => {
-        delete websock.onmessage;
-        _conn_.reset();})
-
-    , {once: true});
+    websock.onmessage = evt =>(on_mqtt_chunk(new Uint8Array(evt.data)));
+    websock.onclose = evt => {
+      if (! evt.wasClean) {
+        var err = new Error('websocket connection close');
+        err.code = evt.code;
+        err.reason = evt.reason;}
 
-    websock.onmessage = evt =>
-      on_mqtt_chunk(
-        new Uint8Array(evt.data));
+      _conn_.reset(err);};
 
     return this} }
 
-class MQTTClient_v4 extends MQTTCoreClient {
-  _mqtt_session() { return mqtt_session_ctx(4)() }
-}
+const MQTTClient_v4 = /* #__PURE__ */
+  MQTTCore.mqtt_ctx(4, mqtt_opts_v5);
 
-const mqtt_v4 = opt => new MQTTClient_v4(opt);
+const MQTTClient_v5 = /* #__PURE__ */
+  MQTTCore.mqtt_ctx(5, mqtt_opts_v5);
 
-class MQTTClient_v5 extends MQTTCoreClient {
-  _mqtt_session() { return mqtt_session_ctx(5)() }
-}
+const mqtt_v4 = opt =>
+  new MQTTClient_v4(opt);
 
-const mqtt_v5 = opt => new MQTTClient_v5(opt);
+const mqtt_v5 = opt =>
+  new MQTTClient_v5(opt);
 
-exports.MQTTBaseClient = MQTTBaseClient;
+exports.MQTTBase = MQTTBase;
 exports.MQTTClient_v4 = MQTTClient_v4;
 exports.MQTTClient_v5 = MQTTClient_v5;
-exports.MQTTCoreClient = MQTTCoreClient;
+exports.MQTTCore = MQTTCore;
+exports.MQTTError = MQTTError;
 exports._mqtt_cmdid_dispatch = _mqtt_cmdid_dispatch;
 exports._mqtt_conn = _mqtt_conn;
 exports._mqtt_dispatch = _mqtt_dispatch;
 exports._mqtt_route_match_one = _mqtt_route_match_one;
+exports._mqtt_route_remove = _mqtt_route_remove;
 exports._mqtt_routes_iter = _mqtt_routes_iter;
 exports._mqtt_topic_router = _mqtt_topic_router;
+exports.ao_defer_v = ao_defer_v;
 exports["default"] = mqtt_v4;
-exports.mqtt_session_ctx = mqtt_session_ctx;
 exports.mqtt_v4 = mqtt_v4;
 exports.mqtt_v5 = mqtt_v5;
 //# sourceMappingURL=index.cjs.map