u8-mqtt 0.4.1 → 0.5.1

package/esm/basic-v4.js

@@ -0,0 +1,1154 @@
+function encode_varint(n, a=[]) {
+  do {
+    const ni = n & 0x7f;
+    n >>>= 7;
+    a.push( ni | (0===n ? 0 : 0x80) );
+  } while (n > 0)
+  return a
+}
+
+
+/*
+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 [n, i, i0]
+}
+*/
+
+
+function decode_varint$1(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]
+}
+
+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
+  }
+}
+
+let mqtt_reader_v4$1 = 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() {
+    return this.buf.byteLength > (this.step.k|0)
+  }
+
+  u8() {
+    return this.buf[this.step(1)]
+  }
+
+  u16() {
+    let {buf, step} = this, i = step(2);
+    return (buf[i]<<8) | buf[i+1]
+  }
+
+  u32() {
+    let {buf, step} = this, i = step(4);
+    return (buf[i]<<24) | (buf[i+1]<<16) | (buf[i+2]<<8) | buf[i+3]
+  }
+
+  vint() {
+    let {buf, step} = this;
+    let [n, vi, vi0] = decode_varint$1(buf, step.k|0);
+    step(vi - vi0);
+    return n
+  }
+
+  bin() {
+    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 new TextDecoder('utf-8').decode(this.bin()) }
+  pair() { return [ this.utf8(), this.utf8() ] }
+
+  flags(FlagsType) { return new FlagsType(this.buf[this.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() {
+    let {buf, step} = this;
+    this.step = this.buf = null;
+    return buf.subarray(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 );
+
+      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 mqtt_decode_connack(ns, mqtt_reader) {
+  class _connack_flags_ extends Number {
+    get session_present() { return this & 0x01 !== 0 }
+  }
+
+  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'],
+    [ 0x02, 'Connection refused, identifier rejected'],
+    [ 0x03, 'Connection refused, server unavailable'],
+    [ 0x04, 'Connection refused, bad user name or password'],
+    [ 0x05, 'Connection refused, not authorized'],
+  );
+}
+
+function mqtt_decode_publish(ns, mqtt_reader) {
+  return ns[0x3] = (pkt, u8_body) => {
+    let {hdr} = pkt;
+    pkt.dup = Boolean(hdr & 0x8);
+    pkt.retain = Boolean(hdr & 0x1);
+    let qos = pkt.qos = (hdr>>1) & 0x3;
+
+    let rdr = mqtt_reader.of(u8_body);
+    pkt.topic = rdr.utf8();
+    if (0 !== qos)
+      pkt.pkt_id = rdr.u16();
+
+    if (5 <= pkt.mqtt_level)
+      pkt.props = rdr.props();
+
+    pkt.payload = rdr.flush();
+    return pkt }
+}
+
+function mqtt_decode_puback(ns, mqtt_reader) {
+  return ns[0x4] = (pkt, u8_body) => {
+    let rdr = mqtt_reader.of(u8_body);
+
+    pkt.pkt_id = rdr.u16();
+    if (5 <= pkt.mqtt_level) {
+      pkt.reason = rdr.reason(pkt.type);
+      pkt.props = rdr.props();
+    }
+
+    return pkt }
+}
+
+function _mqtt_decode_suback(mqtt_reader) {
+  return (pkt, u8_body) => {
+    let rdr = mqtt_reader.of(u8_body);
+
+    pkt.pkt_id = rdr.u16();
+    if (5 <= pkt.mqtt_level)
+      pkt.props = rdr.props();
+
+    let answers = pkt.answers = [];
+    while (rdr.has_more())
+      answers.push(
+        rdr.reason(pkt.type) );
+
+    return pkt }
+}
+
+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 mqtt_decode_unsuback(ns, mqtt_reader) {
+  return ns[0xb] = _mqtt_decode_suback(mqtt_reader)
+}
+
+function _unsuback_v4(mqtt_reader) {
+  mqtt_reader.reasons('unsuback',
+    // MQTT 3.1.1
+    [ 0x00, 'Success'],
+    [ 0x11, 'No subscription existed'],
+    [ 0x80, 'Unspecified error'],
+    [ 0x83, 'Implementation specific error'],
+    [ 0x87, 'Not authorized'],
+    [ 0x8F, 'Topic Filter invalid'],
+    [ 0x91, 'Packet Identifier in use'],
+  );
+}
+
+function mqtt_decode_pingxxx(ns) {
+  return ns[0xc] = ns[0xd] = pkt => pkt
+}
+
+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 mqtt_encode_connect(ns, mqtt_writer) {
+  const _c_mqtt_proto = new Uint8Array([
+    0, 4, 0x4d, 0x51, 0x54, 0x54 ]);
+
+  const _enc_flags_connect = flags => 0
+      | ( flags.reserved ? 0x01 : 0 )
+      | ( (flags.will_qos & 0x3) << 3 )
+      | ( flags.clean_start ? 0x02 : 0 )
+      | ( flags.will_flag ? 0x04 : 0 )
+      | ( flags.will_retain ? 0x20 : 0 )
+      | ( flags.password ? 0x40 : 0 )
+      | ( flags.username ? 0x80 : 0 );
+
+  const _enc_flags_will = will => 0x4
+      | ( (will.qos & 0x3) << 3 )
+      | ( will.retain ? 0x20 : 0 );
+
+  return ns.connect = ( mqtt_level, pkt ) => {
+    let wrt = mqtt_writer.of(pkt);
+
+    wrt.push(_c_mqtt_proto);
+    wrt.u8( mqtt_level );
+
+    let {will, username, password} = pkt;
+    let flags = wrt.flags(
+      pkt.flags,
+      _enc_flags_connect,
+      0 | (username ? 0x80 : 0)
+        | (password ? 0x40 : 0)
+        | (will ? _enc_flags_will(will) : 0) );
+
+    wrt.u16(pkt.keep_alive);
+
+    if (5 <= mqtt_level)
+      wrt.props(pkt.props);
+
+
+    wrt.utf8(pkt.client_id);
+    if (flags & 0x04) { // .will_flag
+      if (5 <= mqtt_level)
+        wrt.props(will.props);
+
+      wrt.utf8(will.topic);
+      wrt.bin(will.payload);
+    }
+
+    if (flags & 0x80) // .username
+      wrt.utf8(username);
+
+    if (flags & 0x40) // .password
+      wrt.bin(password);
+
+    return wrt.as_pkt(0x10)
+  }
+}
+
+function mqtt_encode_publish(ns, mqtt_writer) {
+  return ns.publish = ( mqtt_level, pkt ) => {
+    let qos = (pkt.qos & 0x3) << 1;
+    let wrt = mqtt_writer.of(pkt);
+
+    wrt.utf8(pkt.topic);
+    if (0 !== qos)
+      wrt.u16(pkt.pkt_id);
+
+    if ( 5 <= mqtt_level) {
+      wrt.props(pkt.props);
+      wrt.flush(pkt.payload);
+    } else {
+      wrt.flush(pkt.payload);
+    }
+
+    return wrt.as_pkt(
+      0x30 | qos | (pkt.dup ? 0x8 : 0) | (pkt.retain ? 0x1 : 0) )
+  }
+}
+
+function mqtt_encode_puback(ns, mqtt_writer) {
+  return ns.puback = ( mqtt_level, pkt ) => {
+    let wrt = mqtt_writer.of(pkt);
+
+    wrt.u16(pkt.pkt_id);
+    if (5 <= mqtt_level) {
+      wrt.reason(pkt.reason);
+      wrt.props(pkt.props);
+    }
+
+    return wrt.as_pkt(0x40)
+  }
+}
+
+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 ) => {
+    let wrt = mqtt_writer.of(pkt);
+
+    wrt.u16(pkt.pkt_id);
+    if (5 <= mqtt_level)
+      wrt.props(pkt.props);
+
+    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] =
+          Array.isArray(each) ? each
+            : [each.topic, each.opts];
+
+        wrt.utf8(topic);
+        if (undefined === opts) wrt.u8(f0);
+        else wrt.flags(opts, _enc_subscribe_flags);
+      }
+    }
+
+    return wrt.as_pkt(0x82)
+  }
+}
+
+function mqtt_encode_unsubscribe(ns, mqtt_writer) {
+  return ns.unsubscribe = ( mqtt_level, pkt ) => {
+    let wrt = mqtt_writer.of(pkt);
+
+    wrt.u16(pkt.pkt_id);
+    if (5 <= mqtt_level)
+      wrt.props(pkt.props);
+
+    for (let topic of pkt.topics)
+      wrt.utf8(topic);
+
+    return wrt.as_pkt(0xa2)
+  }
+}
+
+function mqtt_encode_pingxxx(ns) {
+  ns.pingreq  = () => new Uint8Array([ 0xc0, 0 ]);
+  ns.pingresp = () => new Uint8Array([ 0xd0, 0 ]);
+}
+
+function mqtt_encode_disconnect(ns, mqtt_writer) {
+  return ns.disconnect = ( mqtt_level, pkt ) => {
+    let wrt = mqtt_writer.of(pkt);
+
+    if (pkt && 5 <= mqtt_level) {
+      if (pkt.reason || pkt.props) {
+        wrt.reason(pkt.reason);
+        wrt.props(pkt.props);
+      }
+    }
+
+    return wrt.as_pkt(0xe0)
+  }
+}
+
+// not a v4 packet: import { mqtt_encode_auth } from './encode/auth.js'
+
+
+const mqtt_decode_v4 =  [
+  mqtt_decode_connack,
+  mqtt_decode_publish,
+  mqtt_decode_puback,
+  mqtt_decode_suback,
+  mqtt_decode_unsuback,
+  mqtt_decode_pingxxx,
+  mqtt_decode_disconnect,
+];
+
+
+const mqtt_encode_v4 =  [
+  mqtt_encode_connect,
+  mqtt_encode_puback,
+  mqtt_encode_publish,
+  mqtt_encode_subscribe,
+  mqtt_encode_unsubscribe,
+  mqtt_encode_pingxxx,
+  mqtt_encode_disconnect,
+];
+
+const mqtt_reader_v4 = /* #__PURE__ */
+  mqtt_reader_info(
+    mqtt_reader_v4$1,
+    _connack_v4,
+    _suback_v4,
+    _unsuback_v4,
+  );
+
+const mqtt_opts_v4 = 
+  { decode_fns: mqtt_decode_v4,
+    mqtt_reader: mqtt_reader_v4,
+    encode_fns: mqtt_encode_v4,
+    mqtt_writer: mqtt_writer_v4, };
+
+/*
+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 [n, i, i0]
+}
+*/
+
+
+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);
+
+    let res = [];
+    while (1) {
+      let [len_body, len_vh] = decode_varint(u8, 1);
+      let len_pkt = len_body + len_vh;
+
+      if ( u8.byteLength < len_pkt )
+        return res
+
+      let b0 = u8[0];
+      let u8_body = 0 === len_body ? null
+        : u8.subarray(len_vh, len_pkt);
+
+      u8 = u8.subarray(len_pkt);
+
+      let pkt = opt.decode_pkt(b0, u8_body, opt);
+      if (null != pkt)
+        res.push( pkt );
+    }
+  }
+}
+
+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
+}
+
+const _pkt_types = ['~', 'connect', 'connack', 'publish', 'puback', 'pubrec', 'pubrel', 'pubcomp', 'subscribe', 'suback', 'unsubscribe', 'unsuback', 'pingreq', 'pingresp', 'disconnect', 'auth'];
+
+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 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 {
+    pkt_ctx,
+
+    encode_pkt(type, pkt) {
+      return _encode_by_type[type]( mqtt_level, pkt ) },
+
+    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) },
+
+    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
+    },
+  }
+}
+
+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 (! _send_mqtt_pkt) {
+        await _q_init[0]; }// _send_mqtt_pkt is set before fulfilled
+
+      // await connack response
+      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');}
+
+      return res}
+
+  , 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_ctx.decode(u8_buf), sess_ctx);
+
+      _send_mqtt_pkt = async (type, pkt, key) => {
+        let res = undefined !== key
+          ? pkt_future(key) : true;
+
+        await send_u8_pkt(
+          mqtt_ctx.encode_pkt(type, pkt));
+
+        return res};
+
+      _q_init[1](_send_mqtt_pkt); // resolve _q_init with _send_mqtt_pkt closure
+
+      // call client.on_live in next promise microtask
+      client.conn_emit('on_live', _has_connected);
+      return on_mqtt_chunk} } }
+
+
+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} }) }
+
+const _mqtt_cmdid_dispatch ={
+  create(target) {
+    return {__proto__: this, target, hashbelt: [new Map()]} }
+
+, bind_pkt_future(_pkt_id=100) {
+    let {hashbelt} = this;
+
+    let _tmp_; // use _tmp_ to reuse _by_key closure
+    let _by_key = answer_monad =>
+      hashbelt[0].set(_tmp_, answer_monad);
+
+    return (( pkt_or_key ) => {
+      if ('string' === typeof pkt_or_key) {
+        _tmp_ = pkt_or_key;}
+      else {
+        _pkt_id = (_pkt_id + 1) & 0xffff;
+        _tmp_ = pkt_or_key.pkt_id = _pkt_id;}
+
+      return new Promise(_by_key)}) }
+
+, answer(key, pkt) {
+    for (let map of this.hashbelt) {
+      let answer_monad = map.get(key);
+      if (undefined !== answer_monad) {
+        map.delete(key);
+
+        answer_monad([pkt, /*err*/]); // option/maybe monad
+        return true} }
+    return false}
+
+, rotate_belt(n) {
+    let {hashbelt} = this;
+    hashbelt.unshift(new Map());
+    for (let old of hashbelt.splice(n || 5)) {
+      for (let answer_monad of old.values()) {
+        answer_monad([/*pkt*/, 'expired']); } } }// option/maybe monad
+
+, cmdids: ((() => {
+    return [
+      (() =>{}    )// 0x0 reserved
+    , by_evt   // 0x1 connect
+    , by_type  // 0x2 connack
+    , by_evt   // 0x3 publish
+    , by_id    // 0x4 puback
+    , by_id    // 0x5 pubrec
+    , by_id    // 0x6 pubrel
+    , by_id    // 0x7 pubcomp
+    , by_evt   // 0x8 subscribe
+    , by_id    // 0x9 suback
+    , by_evt   // 0xa unsubscribe
+    , by_id    // 0xb unsuback
+    , by_type  // 0xc pingreq
+    , by_type  // 0xd pingresp
+    , by_evt   // 0xe disconnect
+    , by_type  ]// 0xf auth
+
+
+    function by_id(disp, pkt) {
+      disp.answer(pkt.pkt_id, pkt); }
+
+    function by_type(disp, pkt, ctx) {
+      disp.answer(pkt.type, pkt);
+      by_evt(disp, pkt, ctx);}
+
+    async function by_evt({target}, pkt, ctx) {
+      let fn = target[`mqtt_${pkt.type}`]
+        || target.mqtt_pkt;
+
+      await fn?.call(target, pkt, ctx);} })()) };
+
+/*
+on_mqtt_type = {
+  mqtt_auth(pkt, ctx) ::
+  mqtt_connect(pkt, ctx) ::
+  mqtt_connack(pkt, ctx) ::
+  mqtt_disconnect(pkt, ctx) ::
+
+  mqtt_publish(pkt, ctx)
+  mqtt_subscribe(pkt, ctx) ::
+  mqtt_unsubscribe(pkt, ctx) ::
+
+  mqtt_pingreq(pkt, ctx) ::
+  mqtt_pingresp(pkt, ctx) ::
+}
+*/
+
+function _mqtt_dispatch(opt, target) {
+  let _disp_ = _mqtt_cmdid_dispatch.create(target);
+  let { cmdids } = _disp_;
+
+  // default rotate at 1s across 5 buckets
+  let { td: rotate_td=1000, n: rotate_n=5 } =
+    opt && opt.rotate || {};
+
+  let rotate_ts = rotate_td + Date.now();
+
+  return [on_mqtt,
+    _disp_.bind_pkt_future()]
+
+  function on_mqtt(pkt_list, ctx) {
+    for (let pkt of pkt_list) {
+      cmdids[pkt.id](_disp_, pkt, ctx); }
+
+    if (Date.now() > rotate_ts) {
+      _disp_.rotate_belt(rotate_n);
+      rotate_ts = rotate_td + Date.now();} } }
+
+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.with(opt);
+    this._conn_ = _mqtt_conn(this,
+      this._init_dispatch(opt, this)); }
+
+  with(fns_ns) {
+    for (let [k,v] of Object.entries(fns_ns)) {
+      if ('function' === typeof v) {this[k] = v;} }
+    return this}
+
+  async conn_emit(evt, arg, err_arg) {
+    this.log_conn?.(evt, arg, err_arg);
+    try {
+      let fn_evt = this[await evt]; // microtask break using `await evt`
+      if (fn_evt) {
+        await fn_evt.call(this, this, arg, err_arg);}
+      else if (err_arg) {throw err_arg} }
+    catch (err) {
+      this.on_error(err, evt);} }
+
+  on_error(err, evt) {
+    console.warn('[[u8-mqtt error: %s]]', evt, err); }
+
+  // Handshaking Packets
+
+  async connect(pkt={}) {
+    let cid = pkt.client_id || this.client_id;
+    if ('string' !== typeof cid) {
+      // see init_client_id implementation in core.jsy
+      pkt.client_id = cid = this.init_client_id(cid);}
+    this.client_id = cid;
+
+    if (null == pkt.keep_alive) {
+      pkt.keep_alive = 60;}
+
+    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(false);
+    return res}
+
+  auth(pkt={}) {
+    return this._send('auth', pkt, 'auth')}
+
+  ping() {return this._send('pingreq', null, 'pingresp')}
+  puback({pkt_id}) {return this._send('puback', {pkt_id})}
+
+  // alias: sub
+  subscribe(pkt, ex, topic_prefix) {
+    pkt = _as_topics(pkt, ex, topic_prefix);
+    let suback = this._send('subscribe', pkt, pkt);
+    return this.on_sub?.(suback, pkt) ?? suback}
+
+  // alias: unsub
+  unsubscribe(pkt, ex, topic_prefix) {
+    pkt = _as_topics(pkt, ex, topic_prefix);
+    return this._send('unsubscribe', pkt, pkt)}
+
+
+  post(topic, payload, pub_opt) {// qos:0
+    return this.pub({topic, payload, qos:0}, pub_opt)}
+  send(topic, payload, pub_opt) {// qos:1
+    return this.pub({topic, payload, qos:1}, pub_opt)}
+  store(topic, payload, pub_opt) {// qos:1, retain: 1
+    return this.pub({topic, payload, qos:1, retain: 1}, pub_opt)}
+
+  // alias: json_post
+  obj_post(topic, msg, pub_opt) {// qos:0
+    return this.pub({topic, msg, arg: 'msg', qos:0}, pub_opt)}
+  // alias: json_send
+  obj_send(topic, msg, pub_opt) {// qos:1
+    return this.pub({topic, msg, arg: 'msg', qos:1}, pub_opt)}
+  // alias: json_store
+  obj_store(topic, msg, pub_opt) {// qos:1, retain: 1
+    return this.pub({topic, msg, arg: 'msg', qos:1, retain: 1}, pub_opt)}
+
+  // alias: publish -- because 'pub' is shorter for semantic aliases above
+  async pub(pkt, pub_opt) {
+    if (undefined === pkt.payload) {
+      if ('function' === typeof pub_opt) {
+        pub_opt = {fn_encode: pub_opt};}
+
+      let {msg} = pkt;
+      switch (typeof msg) {
+        case 'function':
+          pub_opt = {...pub_opt, fn_encode: msg};
+          // flow into 'undefined' case
+        case 'undefined':
+          // return a single-value closure to publish packets
+          return v => this.pub({...pkt, [pkt.arg || 'payload']: v}, pub_opt)}
+
+      // Encode payload from msg; fn_encode allows alternative to JSON.stringify
+      let {fn_encode} = pub_opt || {};
+      pkt.payload = fn_encode
+        ? await fn_encode(msg)
+        : JSON.stringify(msg);}
+
+    if (pub_opt) {
+      if (pub_opt.props) {
+        pkt.props = pub_opt.props;}
+      if (pub_opt.xform) {
+        pkt = pub_opt.xform(pkt) || pkt;} }
+
+    return this._send('publish', pkt,
+      pkt.qos ? pkt : void 0 ) }// key
+
+
+  // Internal API
+
+  /* async _send(type, pkt) -- provided by _conn_ and transport */
+
+  _init_dispatch(opt) {
+    this.constructor?._once_();
+    let target ={__proto__: opt.on_mqtt_type};
+    target.mqtt_publish ||=
+      this._init_router?.(opt, this, target);
+    return _mqtt_dispatch(this, target)}
+
+  static _aliases() {
+    return ' publish:pub sub:subscribe unsub:unsubscribe json_post:obj_post json_send:obj_send json_store:obj_store'}
+
+  static _once_(self=this) {
+    self._once_ = _=>0;
+    let p = self.prototype;
+    p.MQTTError = MQTTError;
+    for (let alias of self._aliases().split(/\s+/)) {
+      alias = alias.split(':');
+      let fn = alias[1] && p[alias[1]];
+      if (fn) {p[alias[0]] = fn;} } } }
+
+
+function _as_topics(pkt, ex, topic_prefix) {
+  if (ex?.trim) {// string
+    topic_prefix = ex;
+    ex = null;}
+
+  pkt =(
+    pkt.trim // string
+      ? {topics:[pkt], ... ex}
+    : pkt[Symbol.iterator]
+      ? {topics:[... pkt], ... ex}
+    : ex ? {...pkt, ...ex}
+    : pkt);
+
+  if (topic_prefix) {
+    // particularly useful with shared queues, e.g.
+    //   topic_prefix = '$share/some-queue-name/'
+    let _prefix_topics = v =>
+      v.trim ? topic_prefix+v : v.map(_prefix_topics);
+
+    pkt.topics = pkt.topics.map(_prefix_topics);}
+  return pkt}
+
+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 {
+  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}
+
+
+  // automatic Client Id for connect()
+  init_client_id(parts=['u8-mqtt--','']) {
+    let sess_stg=this.sess_stg;
+    let key, cid = sess_stg?.getItem(key=parts.join(' '));
+    if (! cid) {
+      cid = parts.join(Math.random().toString(36).slice(2));
+      sess_stg?.setItem(key, cid);}
+    return cid}
+
+  get sess_stg() {return globalThis.sessionStorage}
+
+
+  //on_error(err, evt) ::
+  //  console.warn @ '[[u8-mqtt error: %s]]', evt, err
+
+  //log_conn(evt, arg, err_arg) ::
+  //  console.info @ '[[u8-mqtt log: %s]]', evt, arg, err_arg
+
+  on_live(client, is_reconnect) {
+    if (is_reconnect) {
+      return client.connect()} }
+
+  //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_ctx,
+      write_u8_pkt);
+
+    this._msg_loop = ((async () => {
+      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}
+
+
+
+  
+    
+      
+      
+      
+        
+          
+
+    
+      
+      
+        
+          
+
+    
+      
+        
+        
+          
+
+    
+      
+      
+        
+
+      
+      
+
+  
+    
+      
+      
+        
+          
+
+    
+      
+      
+        
+          
+
+    
+      
+      
+        
+      
+      
+
+
+  with_stream(read_stream, write_stream) {
+    if (undefined === write_stream) {
+      write_stream = read_stream;}
+
+    return this.with_async_iter(read_stream,
+      u8_pkt => write_stream.write(u8_pkt)) }
+
+
+  with_websock(websock) {
+    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';
+
+    let ready, {readyState} = websock;
+    if (1 !== readyState) {
+      if (0 !== readyState) {
+        throw new Error('Invalid WebSocket readyState') }
+
+      ready = new Promise(fn => websock.onopen = fn); }
+
+
+    let {_conn_} = this;
+    let on_mqtt_chunk = _conn_.set(
+      this.mqtt_ctx,
+      async u8_pkt =>(
+        await ready
+      , websock.send(u8_pkt)) );
+
+    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;}
+
+      _conn_.reset(err);};
+
+    return this} }
+
+const version = '0.5.1';
+
+const MQTTClient_v4 = /* #__PURE__ */
+  MQTTCore.mqtt_ctx(4, mqtt_opts_v4);
+
+const mqtt_v4 = opt =>
+  new MQTTClient_v4(opt);
+
+export { MQTTClient_v4 as MQTTClient, MQTTClient_v4, mqtt_v4 as default, mqtt_v4 as mqtt, mqtt_v4, version };
+//# sourceMappingURL=basic-v4.js.map