@seriousme/opifex 1.10.1 → 1.11.1

package/README.md

@@ -20,12 +20,12 @@ The following MQTT versions are supported:
 | Server         | ❌            | ✅             | ❌            |
 
 Client and server currently only have memory based persistence, but one can
-provide its own persistence. (see [#Architecture] )
+provide its own persistence. (see [Architecture](#architecture))
 
 ## Usage
 
-The most easy way to use this project is to just use the demo server
-(demoServer) and/or the demo client (mqtt).
+The easiest way to use this project is to just use the demo server (demoServer)
+and/or the demo client (mqtt).
 
 - [NodeJS/Bun](node/README.md)
 - [Deno](deno/README.md)
@@ -35,7 +35,7 @@ can be done with CLI options then the next step is to clone the demo server
 and/or the client scripts and modify them to your liking.
 
 If you want to port the platform independent client and server libs to other
-types of transport (e.g. Unix sockets or websocketstream) then its recommended
+types of transports (e.g. Unix sockets or websocketstream) then it's recommended
 to clone and modify the platform specific code in `/node` or `/deno` as well.
 
 If you want to port the platform independent client and server libs to another
@@ -65,7 +65,7 @@ A more elaborate example including client and server can be found in the
 ## Architecture
 
 1. The basis of Opifex is the MQTT packet module
-   ([mqttPacket/mod.ts](mqttPacket/mod.ts)) which contains al the logic to
+   ([mqttPacket/mod.ts](mqttPacket/mod.ts)) which contains all the logic to
    encode and decode packets.
 
 2. On top of mqttPacket sits the MQTT connection module

package/benchmarks/bombing.ts

@@ -0,0 +1,35 @@
+import { loader } from "./utils.ts";
+import { runAsap } from "../dev_utils/timers.ts";
+
+loader((ClientClass) => {
+  const client = new ClientClass();
+
+  client.connect({
+    url: new URL("mqtt://127.0.0.1:1884"),
+  });
+
+  client.onConnected = () => {
+    const payload = new TextEncoder().encode("payload");
+
+    let sent = 0;
+    const interval = 5000;
+
+    const loop = () => {
+      sent++;
+      client.publish({ topic: "test", payload })
+        .then(() => runAsap(loop));
+    };
+
+    function count() {
+      console.log("sent/s", (sent / interval) * 1000);
+      sent = 0;
+    }
+
+    setInterval(count, interval);
+    loop();
+  };
+
+  client.onError = (err) => {
+    console.log("client error", err);
+  };
+});

package/benchmarks/throughputCounter.ts

@@ -0,0 +1,31 @@
+import { loader } from "./utils.ts";
+
+loader(async (ClientClass) => {
+  const client = new ClientClass();
+
+  await client.connect({
+    url: new URL("mqtt://127.0.0.1:1884"),
+  });
+
+  await client.subscribe({ subscriptions: [{ topicFilter: "test", qos: 0 }] });
+
+  let counter = 0;
+  const interval = 5000;
+
+  function count() {
+    console.log("received/s", (counter / interval) * 1000);
+    counter = 0;
+  }
+
+  setInterval(count, interval);
+
+  // // Consume using a callback
+  // client.onPacket = async (packet) => {
+  //   counter++;
+  // };
+
+  // Consume using an AsyncIterator
+  for await (const _ of client.messages()) {
+    counter++;
+  }
+});

package/benchmarks/utils.ts

@@ -0,0 +1,32 @@
+import type { Client } from "../client/client.ts";
+
+export type ClientClass = new () => Client;
+
+export type Main = (clientClass: ClientClass) => void | Promise<void>;
+
+// @ts-ignore: the Deno global variable is not defined in @types/node,
+//             therefore we need to ignore this error because this file
+//             is meant to be used in both environments.
+const isDeno = typeof Deno !== "undefined";
+
+// @ts-ignore: the Deno global variable is not defined in @types/node,
+//             therefore we need to ignore this error because this file
+//             is meant to be used in both environments.
+// deno-lint-ignore no-process-global
+const exit = isDeno ? Deno.exit : process.exit;
+
+const importClientClass = async (): Promise<ClientClass> => {
+  return isDeno
+    ? (await import("../deno/tcpClient.ts")).TcpClient
+    : (await import("../node/tcpClient.ts")).TcpClient;
+};
+
+export const loader = async (main: Main) => {
+  const TcpClient = await importClientClass();
+  try {
+    await main(TcpClient);
+  } catch (err) {
+    console.error(err);
+    exit(1);
+  }
+};

package/bin/mqtt.ts

@@ -194,7 +194,7 @@ async function subscribe() {
   }
   try {
     await connect(subscribeArgs);
-    client.subscribe({
+    await client.subscribe({
       subscriptions: [
         {
           topicFilter: subscribeArgs.topic,

package/client/client.ts

@@ -14,7 +14,12 @@ import type {
   TAuthenticationResult,
 } from "./deps.ts";
 
+import { noop } from "../utils/utils.ts";
+
 import { Context } from "./context.ts";
+import type { TConnectionState } from "./ConnectionState.ts";
+import { assert } from "../utils/assert.ts";
+import { BufferedAsyncIterable } from "./deps.ts";
 
 /**
  * Generates a random client ID with the given prefix
@@ -70,9 +75,11 @@ function backOffSleep(random: boolean, attempt: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, delay));
 }
 
-/**  the default MQTT URL to connect to */
+/** the default MQTT URL to connect to */
 export const DEFAULT_URL = "mqtt://localhost:1883/";
+/** the default protocol level to connect with*/
 export const DEFAULT_PROTOCOLLEVEL = MQTTLevel.v4;
+/** the default keepalive time */
 export const DEFAULT_KEEPALIVE = 60; // 60 seconds
 const DEFAULT_RETRIES = 3; // on first connect
 const CLIENTID_PREFIX = "opifex"; // on first connect
@@ -87,6 +94,12 @@ const CLIENTID_PREFIX = "opifex"; // on first connect
  * connection type that is supported by the subclass.
  */
 export class Client {
+  public onError: (err: Error) => void = noop;
+  public onPacket: (pkt: PublishPacket) => void | Promise<void> = noop;
+  public onConnected: () => void = noop;
+  public onDisconnected: () => void = noop;
+  public onReconnecting: () => void = noop;
+
   protected clientIdPrefix = CLIENTID_PREFIX;
   protected numberOfRetries = DEFAULT_RETRIES;
   protected url: URL = new URL(DEFAULT_URL);
@@ -97,17 +110,22 @@ export class Client {
   private cert?: string;
   private key?: string;
   private clientId: string;
-  private ctx = new Context(new MemoryStore());
+  private ctx: Context;
   private connectPacket?: ConnectPacket;
 
   /**
    * Creates a new MQTT client instance
    */
   constructor() {
+    this.ctx = new Context(new MemoryStore(), this);
     this.clientId = generateClientId(this.clientIdPrefix);
     this.numberOfRetries = DEFAULT_RETRIES;
   }
 
+  get connectionState(): TConnectionState {
+    return this.ctx.connectionState;
+  }
+
   /**
    * Creates a new connection to the MQTT broker
    * @param protocol - The protocol to use (mqtt, mqtts, etc)
@@ -128,7 +146,7 @@ export class Client {
   ): Promise<SockConn> {
     // if you need to support alternative connection types just
     // overload this method in your subclass
-    throw `Unsupported protocol: ${protocol}`;
+    throw new Error(`Unsupported protocol: ${protocol}`);
   }
 
   /**
@@ -164,10 +182,13 @@ export class Client {
         this.connectPacket.clean = false;
         this.ctx.close();
       } catch (err) {
-        if (err instanceof Error) {
-          lastMessage = err;
-          logger.debug({ lastMessage });
-        }
+        assert(
+          err instanceof Error,
+          `Caught something that is not an instance of Error: ${err}`,
+        );
+        queueMicrotask(() => this.onError(err));
+        lastMessage = err;
+        logger.debug({ lastMessage });
       }
 
       if (tryConnect && (isReconnect || attempt < this.numberOfRetries)) {
@@ -175,6 +196,7 @@ export class Client {
         if (!isReconnect) {
           attempt++;
         }
+        queueMicrotask(this.onReconnecting);
       } else {
         tryConnect = false;
       }
@@ -255,15 +277,9 @@ export class Client {
    * Gets an async iterator for received messages
    * @returns AsyncGenerator yielding received publish packets
    */
-  async *messages(): AsyncGenerator<PublishPacket, void, unknown> {
-    yield* this.ctx.incoming;
-  }
-
-  /**
-   * Closes the message stream
-   * @param reason - Optional reason for closing
-   */
-  closeMessages(reason?: string) {
-    this.ctx.incoming.close(reason);
+  messages(): AsyncIterable<PublishPacket> {
+    const bufferedIterable = new BufferedAsyncIterable<PublishPacket>();
+    this.onPacket = bufferedIterable.push;
+    return bufferedIterable;
   }
 }

package/client/context.ts

@@ -1,10 +1,8 @@
 import {
-  AsyncQueue,
   Deferred,
   logger,
   MqttConn,
   MQTTLevel,
-  nextTick,
   PacketType,
   Timer,
 } from "./deps.ts";
@@ -25,10 +23,12 @@ import type {
 import { handlePacket } from "./handlers/handlePacket.ts";
 import type { TConnectionState } from "./ConnectionState.ts";
 import { ConnectionState } from "./ConnectionState.ts";
+import type { Client } from "./client.ts";
+import { assert } from "../utils/assert.ts";
 
 export class Context {
   mqttConn?: MqttConn;
-  connectionState: TConnectionState;
+  #connectionState: TConnectionState;
   protocolLevel: ProtocolLevel;
   pingTimer?: Timer;
   unresolvedConnect?: Deferred<TAuthenticationResult>;
@@ -36,18 +36,34 @@ export class Context {
   unresolvedSubscribe: Map<PacketId, Deferred<ReturnCodes>>;
   unresolvedUnSubscribe: Map<PacketId, Deferred<void>>;
   store: MemoryStore;
-  incoming: AsyncQueue<PublishPacket>;
+  #client: Client;
 
-  constructor(store: MemoryStore) {
+  constructor(store: MemoryStore, client: Client) {
+    this.#client = client;
     this.store = store;
-    this.connectionState = ConnectionState.offline;
+    this.#connectionState = ConnectionState.offline;
     this.protocolLevel = MQTTLevel.unknown;
-    this.incoming = new AsyncQueue();
     this.unresolvedPublish = new Map();
     this.unresolvedSubscribe = new Map();
     this.unresolvedUnSubscribe = new Map();
   }
 
+  get connectionState(): TConnectionState {
+    return this.#connectionState;
+  }
+
+  set connectionState(state: TConnectionState) {
+    this.#connectionState = state;
+    switch (state) {
+      case "connected":
+        queueMicrotask(this.#client.onConnected);
+        break;
+      case "disconnected":
+        queueMicrotask(this.#client.onDisconnected);
+        break;
+    }
+  }
+
   async connect(packet: ConnectPacket) {
     this.connectionState = ConnectionState.connecting;
     if (packet.protocolLevel === MQTTLevel.unknown) {
@@ -88,7 +104,6 @@ export class Context {
     ) {
       await this.mqttConn?.send(packet);
       this.pingTimer?.reset();
-      await nextTick(); // Yield to allow other tasks to run
       return;
     }
     logger.debug("not connected");
@@ -107,21 +122,22 @@ export class Context {
     connectPacket: ConnectPacket,
   ): Promise<boolean> {
     this.mqttConn = new MqttConn({ conn });
-    if (this.mqttConn === undefined) {
-      return true;
-    }
-
     try {
       logger.debug("Send connect packet", connectPacket);
       await this.connect(connectPacket);
       logger.debug("Accepting packets");
       for await (const packet of this.mqttConn) {
-        handlePacket(this, packet);
+        await handlePacket(this, packet);
       }
       logger.debug("No more packets");
     } catch (err) {
+      assert(
+        err instanceof Error,
+        `Caught something that is not an instance of Error: ${err}`,
+      );
+      queueMicrotask(() => this.#client.onError(err));
       logger.debug(`error ${err}`);
-      if (this.mqttConn.isClosed) {
+      if (!this.mqttConn.isClosed) {
         this.mqttConn.close();
       }
     }
@@ -137,8 +153,8 @@ export class Context {
     this.pingTimer?.clear();
   }
 
-  receivePublish(packet: PublishPacket) {
-    this.incoming.push(packet);
+  async receivePublish(packet: PublishPacket) {
+    await this.#client.onPacket(packet);
   }
 
   async publish(packet: PublishPacket): Promise<void> {
@@ -146,8 +162,7 @@ export class Context {
     if (qos === 0) {
       packet.id = 0;
       await this.send(packet);
-      // return empty promise
-      return Promise.resolve();
+      return;
     }
     packet.id = this.store.nextId();
     this.store.pendingOutgoing.set(packet.id, packet);

package/client/deps.ts

@@ -36,6 +36,5 @@ export {
 export { MqttConn } from "../mqttConn/mqttConn.ts";
 export type { SockConn } from "../socket/socket.ts";
 export { Timer } from "../timer/timer.ts";
-export { AsyncQueue, Deferred, logger } from "../utils/mod.ts";
+export { BufferedAsyncIterable, Deferred, logger } from "../utils/mod.ts";
 export { MemoryStore } from "./store/memoryStore.ts";
-export { nextTick } from "../utils/mod.ts";

package/client/handlers/handlePublish.ts

@@ -11,14 +11,14 @@ import type { PublishPacket } from "../deps.ts";
 export async function handlePublish(ctx: Context, packet: PublishPacket) {
   const qos = packet.qos || 0;
   if (qos === 0) {
-    ctx.receivePublish(packet);
+    await ctx.receivePublish(packet);
     return;
   }
 
   if (packet.id !== undefined) {
     // qos 1
     if (qos === 1) {
-      ctx.receivePublish(packet);
+      await ctx.receivePublish(packet);
       await ctx.send({
         type: PacketType.puback,
         protocolLevel: ctx.protocolLevel,

package/client/handlers/handlePubrel.ts

@@ -26,7 +26,7 @@ export async function handlePubrel(
   if (ctx.store.pendingIncoming.has(id)) {
     const storedPacket = ctx.store.pendingIncoming.get(id);
     if (storedPacket) {
-      ctx.receivePublish(storedPacket);
+      await ctx.receivePublish(storedPacket);
       ctx.store.pendingIncoming.delete(id);
       await ctx.send({
         type: PacketType.pubcomp,

package/deno/tcpClient.ts

@@ -70,6 +70,6 @@ export class TcpClient extends Client {
     if (protocol === "mqtt:") {
       return this.connectMQTT(hostname, port);
     }
-    throw `Unsupported protocol: ${protocol}`;
+    throw new Error(`Unsupported protocol: ${protocol}`);
   }
 }

package/deno/tcpServer.test.ts

@@ -72,7 +72,6 @@ test("Deno Test pubSub using client and server", async function () {
 
   await sleep(100);
   logger.verbose(`Disconnect client`);
-  //client.closeMessages();
   await client.disconnect();
 
   logger.verbose(`Check completeness`);

package/dev_utils/dummyConn.ts

@@ -1,4 +1,4 @@
-import type { AsyncQueue } from "../utils/mod.ts";
+import type { BufferedAsyncIterable } from "../utils/mod.ts";
 
 class Uint8Writer implements WritableStreamDefaultWriter {
   private buff: Uint8Array;
@@ -24,7 +24,7 @@ class Uint8Writer implements WritableStreamDefaultWriter {
 }
 
 class Uint8QueuedWriter implements WritableStreamDefaultWriter {
-  private queue: AsyncQueue<Uint8Array>;
+  private queue: BufferedAsyncIterable<Uint8Array>;
   closed = Promise.resolve(undefined);
   close = () => Promise.resolve();
   abort = () => Promise.resolve();
@@ -33,7 +33,7 @@ class Uint8QueuedWriter implements WritableStreamDefaultWriter {
   desiredSize = 20;
 
   constructor(
-    queue: AsyncQueue<Uint8Array>,
+    queue: BufferedAsyncIterable<Uint8Array>,
   ) {
     this.queue = queue;
   }
@@ -96,8 +96,8 @@ export function makeDummySockConn(
 }
 
 export function makeDummyQueueSockConn(
-  r: AsyncQueue<Uint8Array>,
-  w: AsyncQueue<Uint8Array>,
+  r: BufferedAsyncIterable<Uint8Array>,
+  w: BufferedAsyncIterable<Uint8Array>,
   close = () => {},
 ) {
   const readable = ReadableStreamFrom(r);

package/dev_utils/mod.ts

@@ -1 +1,2 @@
 export { makeDummyQueueSockConn, makeDummySockConn } from "./dummyConn.ts";
+export { resolveAsap, resolveNextTick, runAsap } from "./timers.ts";

package/dev_utils/timers.ts

@@ -0,0 +1,51 @@
+/*
+ * This file contains timer functions that support all major JS runtimes
+ * (Deno, Bun, Node.js).
+ */
+
+// This will also work on Deno:
+// https://docs.deno.com/api/node/timers/#namespace_setimmediate
+import { setImmediate } from "node:timers";
+
+let taskCounter = 0;
+
+/**
+ * This function runs a function asynchronously but as soon as possible.
+ * In most cases, this means as an additional microtask within the same
+ * tick of the event loop via `queueMicrotask()`. However, in order not to
+ * block the event loop in case of task loops, every 64 invocations we use
+ * `setImmediate()` instead of `queueMicrotask()`.
+ *
+ * For some reason I do not understand, Deno does not tolerate anything more
+ * than 64 subsequent invocations of `queueMicrotask()`. Setting this limit to
+ * 100, for example, leads to a constant decrease in actual tick/s. Neither
+ * Node nor Bun exhibit the same behavior.
+ *
+ * See https://nodejs.org/en/learn/asynchronous-work/understanding-setimmediate
+ * See https://developer.mozilla.org/en-US/docs/Web/API/HTML_DOM_API/Microtask_guide
+ */
+export const runAsap = (fn: () => void): void => {
+  if (taskCounter === 64) {
+    taskCounter = 0;
+    setImmediate(fn);
+  } else {
+    taskCounter++;
+    queueMicrotask(fn);
+  }
+};
+
+/**
+ * Returns a promise that resolves asynchronously but as soon as possible.
+ * Internally, this function uses `runAsap()` to schedule the resolution.
+ * See above for more details on the scheduling strategy.
+ */
+export const resolveAsap = (): Promise<void> => {
+  return new Promise((resolve) => runAsap(resolve));
+};
+
+/**
+ * Returns a promise that resolves in the next tick of the event loop.
+ */
+export const resolveNextTick = (): Promise<void> => {
+  return new Promise((resolve) => setImmediate(resolve));
+};

package/dist/bin/mqtt.js

@@ -169,7 +169,7 @@ async function subscribe() {
     }
     try {
         await connect(subscribeArgs);
-        client.subscribe({
+        await client.subscribe({
             subscriptions: [
                 {
                     topicFilter: subscribeArgs.topic,

package/dist/bin/mqtt.js.map

@@ -1 +1 @@
-{"version":3,"file":"mqtt.js","sourceRoot":"","sources":["../../bin/mqtt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mqtt.js","sourceRoot":"","sources":["../../bin/mqtt.ts"],"names":[],"mappings":"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"}

package/dist/client/client.d.ts

@@ -1,4 +1,5 @@
 import type { ConnectPacket, PublishPacket, SockConn, SubscribePacket, TAuthenticationResult } from "./deps.ts";
+import type { TConnectionState } from "./ConnectionState.ts";
 type ConnectOptions = Omit<ConnectPacket, "type" | "protocolName">;
 /** ConnectParameters define how to connect */
 export type ConnectParameters = {
@@ -13,9 +14,11 @@ export type ConnectParameters = {
 export type PublishParameters = Omit<PublishPacket, "type" | "id" | "protocolLevel">;
 /** SubscribeParameters define how to subscribe to a topic */
 export type SubscribeParameters = Omit<SubscribePacket, "type" | "id" | "protocolLevel">;
-/**  the default MQTT URL to connect to */
+/** the default MQTT URL to connect to */
 export declare const DEFAULT_URL = "mqtt://localhost:1883/";
+/** the default protocol level to connect with*/
 export declare const DEFAULT_PROTOCOLLEVEL: import("./deps.ts").ProtocolLevel;
+/** the default keepalive time */
 export declare const DEFAULT_KEEPALIVE = 60;
 /**
  * The Client class provides an MQTT Client that can be used to connect to
@@ -27,6 +30,11 @@ export declare const DEFAULT_KEEPALIVE = 60;
  * connection type that is supported by the subclass.
  */
 export declare class Client {
+    onError: (err: Error) => void;
+    onPacket: (pkt: PublishPacket) => void | Promise<void>;
+    onConnected: () => void;
+    onDisconnected: () => void;
+    onReconnecting: () => void;
     protected clientIdPrefix: string;
     protected numberOfRetries: number;
     protected url: URL;
@@ -43,6 +51,7 @@ export declare class Client {
      * Creates a new MQTT client instance
      */
     constructor();
+    get connectionState(): TConnectionState;
     /**
      * Creates a new connection to the MQTT broker
      * @param protocol - The protocol to use (mqtt, mqtts, etc)
@@ -86,12 +95,7 @@ export declare class Client {
      * Gets an async iterator for received messages
      * @returns AsyncGenerator yielding received publish packets
      */
-    messages(): AsyncGenerator<PublishPacket, void, unknown>;
-    /**
-     * Closes the message stream
-     * @param reason - Optional reason for closing
-     */
-    closeMessages(reason?: string): void;
+    messages(): AsyncIterable<PublishPacket>;
 }
 export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../client/client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,QAAQ,EACR,eAAe,EACf,qBAAqB,EACtB,MAAM,WAAW,CAAC;AAanB,KAAK,cAAc,GAAG,IAAI,CACxB,aAAa,EACb,MAAM,GAAG,cAAc,CACxB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,aAAa,EACb,MAAM,GAAG,IAAI,GAAG,eAAe,CAChC,CAAC;AACF,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,eAAe,EACf,MAAM,GAAG,IAAI,GAAG,eAAe,CAChC,CAAC;AAqBF,0CAA0C;AAC1C,eAAO,MAAM,WAAW,2BAA2B,CAAC;AACpD,eAAO,MAAM,qBAAqB,mCAAe,CAAC;AAClD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAIpC;;;;;;;;GAQG;AACH,qBAAa,MAAM;IACjB,SAAS,CAAC,cAAc,SAAmB;IAC3C,SAAS,CAAC,eAAe,SAAmB;IAC5C,SAAS,CAAC,GAAG,EAAE,GAAG,CAAwB;IAC1C,SAAS,CAAC,SAAS,SAAqB;IACxC,SAAS,CAAC,aAAa,oCAAyB;IAChD,SAAS,CAAC,aAAa,UAAQ;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAW;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAgB;IAEtC;;OAEG;;IAMH;;;;;;;;;OASG;IACH,SAAS,CAAC,UAAU,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,CAAC;IAMpB;;;OAGG;YACW,SAAS;IAkDvB;;;;OAIG;IACH,OAAO,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwBvE;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;;OAGG;IACI,QAAQ,IAAI,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC;IAI/D;;;OAGG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM;CAG9B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../client/client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,QAAQ,EACR,eAAe,EACf,qBAAqB,EACtB,MAAM,WAAW,CAAC;AAKnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAa7D,KAAK,cAAc,GAAG,IAAI,CACxB,aAAa,EACb,MAAM,GAAG,cAAc,CACxB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,aAAa,EACb,MAAM,GAAG,IAAI,GAAG,eAAe,CAChC,CAAC;AACF,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,eAAe,EACf,MAAM,GAAG,IAAI,GAAG,eAAe,CAChC,CAAC;AAqBF,yCAAyC;AACzC,eAAO,MAAM,WAAW,2BAA2B,CAAC;AACpD,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,mCAAe,CAAC;AAClD,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAIpC;;;;;;;;GAQG;AACH,qBAAa,MAAM;IACV,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAQ;IACrC,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAQ;IAC9D,WAAW,EAAE,MAAM,IAAI,CAAQ;IAC/B,cAAc,EAAE,MAAM,IAAI,CAAQ;IAClC,cAAc,EAAE,MAAM,IAAI,CAAQ;IAEzC,SAAS,CAAC,cAAc,SAAmB;IAC3C,SAAS,CAAC,eAAe,SAAmB;IAC5C,SAAS,CAAC,GAAG,EAAE,GAAG,CAAwB;IAC1C,SAAS,CAAC,SAAS,SAAqB;IACxC,SAAS,CAAC,aAAa,oCAAyB;IAChD,SAAS,CAAC,aAAa,UAAQ;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAW;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,aAAa,CAAC,CAAgB;IAEtC;;OAEG;;IAOH,IAAI,eAAe,IAAI,gBAAgB,CAEtC;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,UAAU,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,CAAC;IAMpB;;;OAGG;YACW,SAAS;IAsDvB;;;;OAIG;IACH,OAAO,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwBvE;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;;OAGG;IACH,QAAQ,IAAI,aAAa,CAAC,aAAa,CAAC;CAKzC"}