@yuneta/gobj-js 7.13.4 → 7.13.6

package/README.md

@@ -589,6 +589,10 @@ set_log_callback(fn)                      // fn(level, message)
 
 // Gate the DIRECT browser-console writes of all the functions above
 set_console_log_enabled(enabled)          // default: true (unchanged behaviour)
+
+// ...and a per-LINE say over them, on top of that switch (7.13.6)
+set_console_log_filter(fn)                // fn(level, msg) -> true to print
+set_console_log_filter(null)              // default: everything prints
 ```
 
 **Three independent output paths.** `set_console_log_enabled(false)` silences
@@ -598,6 +602,15 @@ a GUI route framework output — **including the automata/FSM trace, which arriv
 as `debug`** — into its own monitor window while keeping the browser console
 clean (gobj-ui's dev-window "Output" selector does exactly this).
 
+**Why a filter and not just the switch.** The console write happens **before**
+the sink is called, so nothing downstream can un-print a line: a consumer that
+wants one CLASS of lines kept off the console — the dev monitor hiding the
+`machine` trace's timer traffic, two `EV_TIMEOUT` lines a second for ever — can
+only say so here. The filter decides the **console alone**: the sink still
+receives every line, so a monitor keeps a complete record and decides
+separately what to show. The master switch still wins, and a filter that
+**throws** is ignored — a broken one must never be able to silence the log.
+
 ### Tracing: the `machine` trace, and the levels around it
 
 The FSM is where things happen, so the trace of the FSM **is** the execution

package/dist/gobj-js.cjs.js

@@ -1802,17 +1802,39 @@ function gobj_walk_gobj_children_tree(gobj, walk_type, cb_walking, user_data, us
 /***************************************************************
 *  Walking
 ***************************************************************/
+/***************************************************************
+*  What a WALK CALLBACK answered, as the number the contract is
+*  written in: -1 stop the walk, 0 descend into the children,
+*  >0 do not descend.
+*
+*  A javascript callback that simply RETURNS NOTHING is the common
+*  case, and `undefined` is neither `< 0` nor `=== 0`, so the walk
+*  used to read it as "do not descend" and skipped the subtree in
+*  silence. Nothing is 0 here — the neutral answer, the one C gives
+*  when an action has nothing to say.
+*
+*  A boolean is NOT guessed: `true`/`false` could mean either half of
+*  this contract, so it is reported and taken as 0. A walk that
+*  silently loses a subtree is the thing this whole function exists
+*  to stop.
+***************************************************************/
+function walk_ret(ret) {
+	if (typeof ret === "number" && isFinite(ret)) return ret;
+	if (ret === void 0 || ret === null) return 0;
+	log_error(`walk callback must return a NUMBER (-1 stop, 0 descend, >0 skip children), got ${typeof ret}: taken as 0`);
+	return 0;
+}
 function rc_walk_by_list(iter_, walk_type, cb_walking, user_data, user_data2) {
 	let iter = [...iter_];
 	let child;
 	if (walk_type & walk_type_t.WALK_LAST2FIRST) for (let i = iter.length; i > 0; i--) {
 		child = iter[i - 1];
-		let ret = cb_walking(child, user_data, user_data2);
+		let ret = walk_ret(cb_walking(child, user_data, user_data2));
 		if (ret < 0) return ret;
 	}
 	else for (let i = 0; i < iter.length; i++) {
 		child = iter[i];
-		let ret = cb_walking(child, user_data, user_data2);
+		let ret = walk_ret(cb_walking(child, user_data, user_data2));
 		if (ret < 0) return ret;
 	}
 	return 0;
@@ -1865,12 +1887,12 @@ function rc_walk_by_tree(iter, walk_type, cb_walking, user_data, user_data2) {
 		child = iter[i - 1];
 		ret = rc_walk_by_tree([...child.dl_children], walk_type, cb_walking, user_data, user_data2);
 		if (ret < 0) return ret;
-		ret = cb_walking(child, user_data, user_data2);
+		ret = walk_ret(cb_walking(child, user_data, user_data2));
 		if (ret < 0) return ret;
 	}
 	else for (let i = 0; i < iter.length; i++) {
 		child = iter[i];
-		ret = cb_walking(child, user_data, user_data2);
+		ret = walk_ret(cb_walking(child, user_data, user_data2));
 		if (ret < 0) return ret;
 		else if (ret === 0) {
 			ret = rc_walk_by_tree([...child.dl_children], walk_type, cb_walking, user_data, user_data2);
@@ -2994,6 +3016,19 @@ var __console_output_enabled__ = true;
 function set_console_log_enabled(enabled) {
 	__console_output_enabled__ = enabled ? true : false;
 }
+var __console_log_filter__ = null;
+function set_console_log_filter(fn) {
+	__console_log_filter__ = typeof fn === "function" ? fn : null;
+}
+function console_wants(level, msg) {
+	if (!__console_output_enabled__) return false;
+	if (!__console_log_filter__) return true;
+	try {
+		return __console_log_filter__(level, msg) ? true : false;
+	} catch (e) {
+		return true;
+	}
+}
 var __in_log_callback__ = false;
 function emit_log_callback(level, msg, hora) {
 	if (__log_callback__ && !__in_log_callback__) {
@@ -3041,9 +3076,9 @@ function log_error(format) {
 	let hora = current_timestamp();
 	if (f_error) {
 		if (f_error === _console.error) {
-			if (__console_output_enabled__) f_error("%c" + hora + " ERROR: " + String(msg), "color:red");
+			if (console_wants("error", msg)) f_error("%c" + hora + " ERROR: " + String(msg), "color:red");
 		} else {
-			if (__console_output_enabled__) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
+			if (console_wants("error", msg)) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
 			f_error(`${hora} ERROR: ${String(msg)}`);
 		}
 	}
@@ -3054,9 +3089,9 @@ function log_warning(format) {
 	let hora = current_timestamp();
 	if (f_warning) {
 		if (f_warning === _console.warn) {
-			if (__console_output_enabled__) f_warning("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+			if (console_wants("warning", msg)) f_warning("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 		} else {
-			if (__console_output_enabled__) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+			if (console_wants("warning", msg)) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 			f_warning(`${hora} WARNING: ${String(msg)}`);
 		}
 	}
@@ -3066,7 +3101,7 @@ function log_info(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_info) {
-		if (__console_output_enabled__) f_info("%c" + hora + " INFO: " + String(msg), "color:cyan");
+		if (console_wants("info", msg)) f_info("%c" + hora + " INFO: " + String(msg), "color:cyan");
 	}
 	emit_log_callback("info", msg, hora);
 }
@@ -3074,7 +3109,7 @@ function log_debug(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_debug) {
-		if (__console_output_enabled__) f_debug("%c" + hora + " DEBUG: " + String(msg), "color:silver");
+		if (console_wants("debug", msg)) f_debug("%c" + hora + " DEBUG: " + String(msg), "color:silver");
 	}
 	emit_log_callback("debug", msg, hora);
 }
@@ -3082,12 +3117,12 @@ function trace_msg(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_debug) {
-		if (__console_output_enabled__) f_debug("%c" + hora + " MSG: " + String(msg), "color:cyan");
+		if (console_wants("msg", msg)) f_debug("%c" + hora + " MSG: " + String(msg), "color:cyan");
 	}
 	emit_log_callback("msg", msg, hora);
 }
 function trace_json(jn, msg) {
-	if (__console_output_enabled__) {
+	if (console_wants("json", msg)) {
 		if (msg) window.console.warn("=====> " + msg);
 		window.console.dir(jn);
 	}
@@ -6435,7 +6470,7 @@ function ac_on_message(gobj, event, kw, src) {
 	let iev_kw = iev_msg.kw;
 	if (gobj_current_state(gobj) !== "ST_SESSION") {
 		if (gobj_has_event(gobj, iev_event, event_flag_t.EVF_PUBLIC_EVENT)) {
-			if (gobj_send_event(gobj, iev_event, iev_kw, gobj) === 0) return 0;
+			if (!(gobj_send_event(gobj, iev_event, iev_kw, gobj) < 0)) return 0;
 		} else log_error(`${gobj_short_name(gobj)}: event UNKNOWN in not-session state ${iev_event}`);
 		close_websocket(gobj);
 		return -1;
@@ -6839,6 +6874,7 @@ exports.safeSrc = safeSrc;
 exports.sdata_flag_t = sdata_flag_t;
 exports.send_http_json_post = send_http_json_post;
 exports.set_console_log_enabled = set_console_log_enabled;
+exports.set_console_log_filter = set_console_log_filter;
 exports.set_log_callback = set_log_callback;
 exports.set_remote_log_functions = set_remote_log_functions;
 exports.set_timeout = set_timeout;
@@ -6862,5 +6898,6 @@ exports.treedb_encoder_fkey = treedb_encoder_fkey;
 exports.treedb_get_field_desc = treedb_get_field_desc;
 exports.treedb_hook_data_size = treedb_hook_data_size;
 exports.vsprintf = vsprintf;
+exports.walk_type_t = walk_type_t;
 
 //# sourceMappingURL=gobj-js.cjs.js.map