mqtt5-wasm 0.8.1 → 0.8.3

package/README.md

@@ -11,6 +11,7 @@ MQTT v5.0 and v3.1.1 WebAssembly client and broker for browser environments.
 - **Full QoS support** - QoS 0, 1, and 2 with proper acknowledgment
 - **Shared subscriptions** - Load balancing across multiple subscribers
 - **Event callbacks** - Connection, disconnect, and error event handlers
+- **Broker lifecycle events** - Monitor client connections, publishes, and subscriptions
 - **Automatic keepalive** - Connection health monitoring with timeout detection
 - **Will messages** - Last Will and Testament (LWT) support
 
@@ -90,6 +91,38 @@ const client = new WasmMqttClient("local-client");
 await client.connect_message_port(port);
 ```
 
+### Broker Lifecycle Events
+
+Monitor broker activity with lifecycle callbacks:
+
+```javascript
+const broker = new WasmBroker();
+
+broker.on_client_connect((event) => {
+  console.log(`Client connected: ${event.clientId}, cleanStart: ${event.cleanStart}`);
+});
+
+broker.on_client_disconnect((event) => {
+  console.log(`Client disconnected: ${event.clientId}, reason: ${event.reason}`);
+});
+
+broker.on_client_publish((event) => {
+  console.log(`Publish: ${event.topic} (${event.payloadSize} bytes, QoS ${event.qos})`);
+});
+
+broker.on_client_subscribe((event) => {
+  console.log(`Subscribe: ${event.clientId} -> ${event.subscriptions.map(s => s.topic)}`);
+});
+
+broker.on_client_unsubscribe((event) => {
+  console.log(`Unsubscribe: ${event.clientId} -> ${event.topics}`);
+});
+
+broker.on_message_delivered((event) => {
+  console.log(`Message delivered: packetId=${event.packetId}, QoS ${event.qos}`);
+});
+```
+
 ## Documentation
 
 See the [main repository](https://github.com/LabOverWire/mqtt-lib) for complete documentation and examples.

package/mqtt5_wasm.d.ts

@@ -34,7 +34,7 @@ export class WasmBroker {
   add_bridge(config: WasmBridgeConfig, remote_port: MessagePort): Promise<void>;
   list_roles(): Promise<string[]>;
   role_count(): Promise<number>;
-  user_count(): Promise<number>;
+  user_count(): number;
   /**
    * # Errors
    * Returns an error if the role does not exist.
@@ -42,7 +42,7 @@ export class WasmBroker {
   assign_role(username: string, role_name: string): Promise<void>;
   clear_roles(): Promise<void>;
   remove_role(name: string): Promise<boolean>;
-  remove_user(username: string): Promise<boolean>;
+  remove_user(username: string): boolean;
   /**
    * # Errors
    * Returns an error if broker initialization fails.
@@ -70,6 +70,10 @@ export class WasmBroker {
    */
   remove_bridge(name: string): Promise<void>;
   unassign_role(username: string, role_name: string): Promise<boolean>;
+  /**
+   * # Errors
+   * Returns an error if the config write lock cannot be acquired.
+   */
   update_config(new_config: WasmBrokerConfig): void;
   acl_rule_count(): Promise<number>;
   get_user_roles(username: string): Promise<string[]>;
@@ -80,14 +84,20 @@ export class WasmBroker {
   on_config_change(callback: Function): void;
   start_sys_topics(): void;
   stop_all_bridges(): Promise<void>;
-  add_user_with_hash(username: string, password_hash: string): Promise<void>;
+  on_client_connect(callback: Function): void;
+  on_client_publish(callback: Function): void;
+  add_user_with_hash(username: string, password_hash: string): void;
   /**
    * # Errors
    * Returns an error if the `MessageChannel` cannot be created.
    */
   create_client_port(): MessagePort;
   get_max_packet_size(): number;
+  on_client_subscribe(callback: Function): void;
+  on_client_disconnect(callback: Function): void;
+  on_message_delivered(callback: Function): void;
   set_acl_default_deny(): Promise<void>;
+  on_client_unsubscribe(callback: Function): void;
   set_acl_default_allow(): Promise<void>;
   get_session_expiry_interval_secs(): number;
   start_sys_topics_with_interval_secs(interval_secs: number): void;
@@ -101,8 +111,8 @@ export class WasmBroker {
    * # Errors
    * Returns an error if adding the user fails.
    */
-  add_user(username: string, password: string): Promise<void>;
-  has_user(username: string): Promise<boolean>;
+  add_user(username: string, password: string): void;
+  has_user(username: string): boolean;
 }
 
 export class WasmBrokerConfig {
@@ -354,43 +364,49 @@ export interface InitOutput {
   readonly wasmbridgeconfig_set_keep_alive_secs: (a: number, b: number) => void;
   readonly wasmbridgeconfig_set_password: (a: number, b: number, c: number) => void;
   readonly wasmbridgeconfig_set_username: (a: number, b: number, c: number) => void;
-  readonly wasmbridgeconfig_validate: (a: number) => [number, number];
-  readonly wasmbroker_acl_rule_count: (a: number) => any;
-  readonly wasmbroker_add_acl_rule: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => any;
-  readonly wasmbroker_add_bridge: (a: number, b: number, c: any) => any;
-  readonly wasmbroker_add_role: (a: number, b: number, c: number) => any;
-  readonly wasmbroker_add_role_rule: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => any;
-  readonly wasmbroker_add_user: (a: number, b: number, c: number, d: number, e: number) => any;
-  readonly wasmbroker_add_user_with_hash: (a: number, b: number, c: number, d: number, e: number) => any;
-  readonly wasmbroker_assign_role: (a: number, b: number, c: number, d: number, e: number) => any;
-  readonly wasmbroker_clear_acl_rules: (a: number) => any;
-  readonly wasmbroker_clear_roles: (a: number) => any;
-  readonly wasmbroker_create_client_port: (a: number) => [number, number, number];
+  readonly wasmbridgeconfig_validate: (a: number, b: number) => void;
+  readonly wasmbroker_acl_rule_count: (a: number) => number;
+  readonly wasmbroker_add_acl_rule: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+  readonly wasmbroker_add_bridge: (a: number, b: number, c: number) => number;
+  readonly wasmbroker_add_role: (a: number, b: number, c: number) => number;
+  readonly wasmbroker_add_role_rule: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+  readonly wasmbroker_add_user: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+  readonly wasmbroker_add_user_with_hash: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly wasmbroker_assign_role: (a: number, b: number, c: number, d: number, e: number) => number;
+  readonly wasmbroker_clear_acl_rules: (a: number) => number;
+  readonly wasmbroker_clear_roles: (a: number) => number;
+  readonly wasmbroker_create_client_port: (a: number, b: number) => void;
   readonly wasmbroker_get_config_hash: (a: number) => number;
   readonly wasmbroker_get_max_clients: (a: number) => number;
   readonly wasmbroker_get_max_packet_size: (a: number) => number;
   readonly wasmbroker_get_session_expiry_interval_secs: (a: number) => number;
-  readonly wasmbroker_get_user_roles: (a: number, b: number, c: number) => any;
-  readonly wasmbroker_has_user: (a: number, b: number, c: number) => any;
-  readonly wasmbroker_hash_password: (a: number, b: number) => [number, number, number, number];
-  readonly wasmbroker_list_bridges: (a: number) => [number, number];
-  readonly wasmbroker_list_roles: (a: number) => any;
-  readonly wasmbroker_new: () => [number, number, number];
-  readonly wasmbroker_on_config_change: (a: number, b: any) => void;
-  readonly wasmbroker_remove_bridge: (a: number, b: number, c: number) => any;
-  readonly wasmbroker_remove_role: (a: number, b: number, c: number) => any;
-  readonly wasmbroker_remove_user: (a: number, b: number, c: number) => any;
-  readonly wasmbroker_role_count: (a: number) => any;
-  readonly wasmbroker_set_acl_default_allow: (a: number) => any;
-  readonly wasmbroker_set_acl_default_deny: (a: number) => any;
+  readonly wasmbroker_get_user_roles: (a: number, b: number, c: number) => number;
+  readonly wasmbroker_has_user: (a: number, b: number, c: number) => number;
+  readonly wasmbroker_hash_password: (a: number, b: number, c: number) => void;
+  readonly wasmbroker_list_bridges: (a: number, b: number) => void;
+  readonly wasmbroker_list_roles: (a: number) => number;
+  readonly wasmbroker_new: (a: number) => void;
+  readonly wasmbroker_on_client_connect: (a: number, b: number) => void;
+  readonly wasmbroker_on_client_disconnect: (a: number, b: number) => void;
+  readonly wasmbroker_on_client_publish: (a: number, b: number) => void;
+  readonly wasmbroker_on_client_subscribe: (a: number, b: number) => void;
+  readonly wasmbroker_on_client_unsubscribe: (a: number, b: number) => void;
+  readonly wasmbroker_on_config_change: (a: number, b: number) => void;
+  readonly wasmbroker_on_message_delivered: (a: number, b: number) => void;
+  readonly wasmbroker_remove_bridge: (a: number, b: number, c: number) => number;
+  readonly wasmbroker_remove_role: (a: number, b: number, c: number) => number;
+  readonly wasmbroker_remove_user: (a: number, b: number, c: number) => number;
+  readonly wasmbroker_role_count: (a: number) => number;
+  readonly wasmbroker_set_acl_default_allow: (a: number) => number;
+  readonly wasmbroker_set_acl_default_deny: (a: number) => number;
   readonly wasmbroker_start_sys_topics: (a: number) => void;
   readonly wasmbroker_start_sys_topics_with_interval_secs: (a: number, b: number) => void;
-  readonly wasmbroker_stop_all_bridges: (a: number) => any;
+  readonly wasmbroker_stop_all_bridges: (a: number) => number;
   readonly wasmbroker_stop_sys_topics: (a: number) => void;
-  readonly wasmbroker_unassign_role: (a: number, b: number, c: number, d: number, e: number) => any;
-  readonly wasmbroker_update_config: (a: number, b: number) => [number, number];
-  readonly wasmbroker_user_count: (a: number) => any;
-  readonly wasmbroker_with_config: (a: number) => [number, number, number];
+  readonly wasmbroker_unassign_role: (a: number, b: number, c: number, d: number, e: number) => number;
+  readonly wasmbroker_update_config: (a: number, b: number, c: number) => void;
+  readonly wasmbroker_user_count: (a: number) => number;
+  readonly wasmbroker_with_config: (a: number, b: number) => void;
   readonly wasmbrokerconfig_new: () => number;
   readonly wasmbrokerconfig_set_allow_anonymous: (a: number, b: number) => void;
   readonly wasmbrokerconfig_set_max_clients: (a: number, b: number) => void;
@@ -405,12 +421,12 @@ export interface InitOutput {
   readonly wasmbrokerconfig_set_wildcard_subscription_available: (a: number, b: number) => void;
   readonly wasmconnectoptions_addBackupUrl: (a: number, b: number, c: number) => void;
   readonly wasmconnectoptions_addUserProperty: (a: number, b: number, c: number, d: number, e: number) => void;
-  readonly wasmconnectoptions_authenticationMethod: (a: number) => [number, number];
+  readonly wasmconnectoptions_authenticationMethod: (a: number, b: number) => void;
   readonly wasmconnectoptions_cleanStart: (a: number) => number;
   readonly wasmconnectoptions_clearBackupUrls: (a: number) => void;
   readonly wasmconnectoptions_clearUserProperties: (a: number) => void;
   readonly wasmconnectoptions_clear_will: (a: number) => void;
-  readonly wasmconnectoptions_getBackupUrls: (a: number) => [number, number];
+  readonly wasmconnectoptions_getBackupUrls: (a: number, b: number) => void;
   readonly wasmconnectoptions_keepAlive: (a: number) => number;
   readonly wasmconnectoptions_maximumPacketSize: (a: number) => number;
   readonly wasmconnectoptions_new: () => number;
@@ -434,48 +450,48 @@ export interface InitOutput {
   readonly wasmconnectoptions_set_username: (a: number, b: number, c: number) => void;
   readonly wasmconnectoptions_set_will: (a: number, b: number) => void;
   readonly wasmconnectoptions_topicAliasMaximum: (a: number) => number;
-  readonly wasmconnectoptions_username: (a: number) => [number, number];
-  readonly wasmmessageproperties_contentType: (a: number) => [number, number];
-  readonly wasmmessageproperties_correlationData: (a: number) => [number, number];
-  readonly wasmmessageproperties_getUserProperties: (a: number) => any;
+  readonly wasmconnectoptions_username: (a: number, b: number) => void;
+  readonly wasmmessageproperties_contentType: (a: number, b: number) => void;
+  readonly wasmmessageproperties_correlationData: (a: number, b: number) => void;
+  readonly wasmmessageproperties_getUserProperties: (a: number) => number;
   readonly wasmmessageproperties_messageExpiryInterval: (a: number) => number;
   readonly wasmmessageproperties_payloadFormatIndicator: (a: number) => number;
-  readonly wasmmessageproperties_responseTopic: (a: number) => [number, number];
-  readonly wasmmessageproperties_subscriptionIdentifiers: (a: number) => [number, number];
-  readonly wasmmqttclient_connect: (a: number, b: number, c: number) => any;
-  readonly wasmmqttclient_connect_broadcast_channel: (a: number, b: number, c: number) => any;
-  readonly wasmmqttclient_connect_message_port: (a: number, b: any) => any;
-  readonly wasmmqttclient_connect_message_port_with_options: (a: number, b: any, c: number) => any;
-  readonly wasmmqttclient_connect_with_options: (a: number, b: number, c: number, d: number) => any;
-  readonly wasmmqttclient_disconnect: (a: number) => any;
+  readonly wasmmessageproperties_responseTopic: (a: number, b: number) => void;
+  readonly wasmmessageproperties_subscriptionIdentifiers: (a: number, b: number) => void;
+  readonly wasmmqttclient_connect: (a: number, b: number, c: number) => number;
+  readonly wasmmqttclient_connect_broadcast_channel: (a: number, b: number, c: number) => number;
+  readonly wasmmqttclient_connect_message_port: (a: number, b: number) => number;
+  readonly wasmmqttclient_connect_message_port_with_options: (a: number, b: number, c: number) => number;
+  readonly wasmmqttclient_connect_with_options: (a: number, b: number, c: number, d: number) => number;
+  readonly wasmmqttclient_disconnect: (a: number) => number;
   readonly wasmmqttclient_enable_auto_reconnect: (a: number, b: number) => void;
   readonly wasmmqttclient_is_connected: (a: number) => number;
   readonly wasmmqttclient_is_reconnecting: (a: number) => number;
   readonly wasmmqttclient_new: (a: number, b: number) => number;
-  readonly wasmmqttclient_on_auth_challenge: (a: number, b: any) => void;
-  readonly wasmmqttclient_on_connect: (a: number, b: any) => void;
-  readonly wasmmqttclient_on_disconnect: (a: number, b: any) => void;
-  readonly wasmmqttclient_on_error: (a: number, b: any) => void;
-  readonly wasmmqttclient_on_reconnect_failed: (a: number, b: any) => void;
-  readonly wasmmqttclient_on_reconnecting: (a: number, b: any) => void;
-  readonly wasmmqttclient_publish: (a: number, b: number, c: number, d: number, e: number) => any;
-  readonly wasmmqttclient_publish_qos1: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
-  readonly wasmmqttclient_publish_qos2: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
-  readonly wasmmqttclient_publish_with_options: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
-  readonly wasmmqttclient_respond_auth: (a: number, b: number, c: number) => [number, number];
+  readonly wasmmqttclient_on_auth_challenge: (a: number, b: number) => void;
+  readonly wasmmqttclient_on_connect: (a: number, b: number) => void;
+  readonly wasmmqttclient_on_disconnect: (a: number, b: number) => void;
+  readonly wasmmqttclient_on_error: (a: number, b: number) => void;
+  readonly wasmmqttclient_on_reconnect_failed: (a: number, b: number) => void;
+  readonly wasmmqttclient_on_reconnecting: (a: number, b: number) => void;
+  readonly wasmmqttclient_publish: (a: number, b: number, c: number, d: number, e: number) => number;
+  readonly wasmmqttclient_publish_qos1: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly wasmmqttclient_publish_qos2: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly wasmmqttclient_publish_with_options: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly wasmmqttclient_respond_auth: (a: number, b: number, c: number, d: number) => void;
   readonly wasmmqttclient_set_reconnect_options: (a: number, b: number) => void;
-  readonly wasmmqttclient_subscribe: (a: number, b: number, c: number) => any;
-  readonly wasmmqttclient_subscribe_with_callback: (a: number, b: number, c: number, d: any) => any;
-  readonly wasmmqttclient_subscribe_with_options: (a: number, b: number, c: number, d: any, e: number) => any;
-  readonly wasmmqttclient_unsubscribe: (a: number, b: number, c: number) => any;
+  readonly wasmmqttclient_subscribe: (a: number, b: number, c: number) => number;
+  readonly wasmmqttclient_subscribe_with_callback: (a: number, b: number, c: number, d: number) => number;
+  readonly wasmmqttclient_subscribe_with_options: (a: number, b: number, c: number, d: number, e: number) => number;
+  readonly wasmmqttclient_unsubscribe: (a: number, b: number, c: number) => number;
   readonly wasmpublishoptions_addUserProperty: (a: number, b: number, c: number, d: number, e: number) => void;
   readonly wasmpublishoptions_clearUserProperties: (a: number) => void;
-  readonly wasmpublishoptions_contentType: (a: number) => [number, number];
+  readonly wasmpublishoptions_contentType: (a: number, b: number) => void;
   readonly wasmpublishoptions_messageExpiryInterval: (a: number) => number;
   readonly wasmpublishoptions_new: () => number;
   readonly wasmpublishoptions_payloadFormatIndicator: (a: number) => number;
   readonly wasmpublishoptions_qos: (a: number) => number;
-  readonly wasmpublishoptions_responseTopic: (a: number) => [number, number];
+  readonly wasmpublishoptions_responseTopic: (a: number, b: number) => void;
   readonly wasmpublishoptions_retain: (a: number) => number;
   readonly wasmpublishoptions_set_contentType: (a: number, b: number, c: number) => void;
   readonly wasmpublishoptions_set_correlationData: (a: number, b: number, c: number) => void;
@@ -513,11 +529,11 @@ export interface InitOutput {
   readonly wasmtopicmapping_set_local_prefix: (a: number, b: number, c: number) => void;
   readonly wasmtopicmapping_set_qos: (a: number, b: number) => void;
   readonly wasmtopicmapping_set_remote_prefix: (a: number, b: number, c: number) => void;
-  readonly wasmwillmessage_contentType: (a: number) => [number, number];
+  readonly wasmwillmessage_contentType: (a: number, b: number) => void;
   readonly wasmwillmessage_messageExpiryInterval: (a: number) => number;
   readonly wasmwillmessage_new: (a: number, b: number, c: number, d: number) => number;
   readonly wasmwillmessage_qos: (a: number) => number;
-  readonly wasmwillmessage_responseTopic: (a: number) => [number, number];
+  readonly wasmwillmessage_responseTopic: (a: number, b: number) => void;
   readonly wasmwillmessage_retain: (a: number) => number;
   readonly wasmwillmessage_set_contentType: (a: number, b: number, c: number) => void;
   readonly wasmwillmessage_set_messageExpiryInterval: (a: number, b: number) => void;
@@ -526,24 +542,20 @@ export interface InitOutput {
   readonly wasmwillmessage_set_retain: (a: number, b: number) => void;
   readonly wasmwillmessage_set_topic: (a: number, b: number, c: number) => void;
   readonly wasmwillmessage_set_willDelayInterval: (a: number, b: number) => void;
-  readonly wasmwillmessage_topic: (a: number) => [number, number];
+  readonly wasmwillmessage_topic: (a: number, b: number) => void;
   readonly wasmwillmessage_willDelayInterval: (a: number) => number;
-  readonly wasm_bindgen__convert__closures_____invoke__h31c8cca720a6aff9: (a: number, b: number, c: any) => void;
-  readonly wasm_bindgen__closure__destroy__h41b20611c4407cba: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h8d4b77242b184668: (a: number, b: number, c: any) => void;
-  readonly wasm_bindgen__closure__destroy__h1683131c23930486: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h3ae4cd55a0542d01: (a: number, b: number) => void;
-  readonly wasm_bindgen__closure__destroy__h318cda49ff0041e4: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h7ae096ff8d5e6a9b: (a: number, b: number, c: any, d: any) => void;
-  readonly __wbindgen_malloc: (a: number, b: number) => number;
-  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
-  readonly __wbindgen_exn_store: (a: number) => void;
-  readonly __externref_table_alloc: () => number;
-  readonly __wbindgen_externrefs: WebAssembly.Table;
-  readonly __wbindgen_free: (a: number, b: number, c: number) => void;
-  readonly __externref_drop_slice: (a: number, b: number) => void;
-  readonly __externref_table_dealloc: (a: number) => void;
-  readonly __wbindgen_start: () => void;
+  readonly __wasm_bindgen_func_elem_684: (a: number, b: number, c: number) => void;
+  readonly __wasm_bindgen_func_elem_123: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_2072: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_2055: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_2122: (a: number, b: number, c: number) => void;
+  readonly __wasm_bindgen_func_elem_2106: (a: number, b: number) => void;
+  readonly __wasm_bindgen_func_elem_3332: (a: number, b: number, c: number, d: number) => void;
+  readonly __wbindgen_export: (a: number, b: number) => number;
+  readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+  readonly __wbindgen_export3: (a: number) => void;
+  readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
+  readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
 }
 
 export type SyncInitInput = BufferSource | WebAssembly.Module;