@yuneta/gobj-js 7.9.4 → 7.9.5

package/dist/gobj-js.umd.js

@@ -403,6 +403,269 @@
 		if (is_object(msg)) msg = JSON.stringify(msg);
 		log_debug(tab() + String(msg));
 	}
+	/***************************************************************
+	*      Trace levels
+	*
+	*  The SAME names and the SAME bits as the C kernel (gobj.h's
+	*  enum + gobj.c's s_global_trace_level), so a level means one
+	*  thing across the two implementations and a habit learned on
+	*  one side transfers to the other. The levels that only exist
+	*  on a node (fs, liburing, gbuffers) keep their bit anyway:
+	*  dropping them would shift every bit above and break exactly
+	*  that alignment.
+	*
+	*  16 higher bits are global, 16 lower bits are per-gclass user
+	*  levels (`s_user_trace_level` in gclass_create).
+	***************************************************************/
+	var trace_level_t = Object.freeze({
+		TRACE_MACHINE: 65536,
+		TRACE_CREATE_DELETE: 131072,
+		TRACE_CREATE_DELETE2: 262144,
+		TRACE_SUBSCRIPTIONS: 524288,
+		TRACE_START_STOP: 1048576,
+		TRACE_EV_KW: 2097152,
+		TRACE_AUTHZS: 4194304,
+		TRACE_STATES: 8388608,
+		TRACE_GBUFFERS: 16777216,
+		TRACE_TIMER: 33554432,
+		TRACE_FS: 67108864,
+		TRACE_URING: 134217728,
+		TRACE_TIMER_PERIODIC: 268435456,
+		TRACE_URING_TIME: 536870912,
+		TRACE_COMMANDS: 1073741824
+	});
+	var TRACE_GLOBAL_LEVEL1 = 268369920;
+	var s_global_trace_level = [
+		[
+			"machine",
+			trace_level_t.TRACE_MACHINE,
+			"Trace machine"
+		],
+		[
+			"create_delete",
+			trace_level_t.TRACE_CREATE_DELETE,
+			"Trace create/delete of gobjs"
+		],
+		[
+			"create_delete2",
+			trace_level_t.TRACE_CREATE_DELETE2,
+			"Trace create/delete of gobjs level 2: with kw"
+		],
+		[
+			"subscriptions",
+			trace_level_t.TRACE_SUBSCRIPTIONS,
+			"Trace subscriptions of gobjs"
+		],
+		[
+			"start_stop",
+			trace_level_t.TRACE_START_STOP,
+			"Trace start/stop of gobjs"
+		],
+		[
+			"ev_kw",
+			trace_level_t.TRACE_EV_KW,
+			"Trace event keywords"
+		],
+		[
+			"authzs",
+			trace_level_t.TRACE_AUTHZS,
+			"Trace authorizations"
+		],
+		[
+			"states",
+			trace_level_t.TRACE_STATES,
+			"Trace change of states"
+		],
+		[
+			"gbuffers",
+			trace_level_t.TRACE_GBUFFERS,
+			"Trace gbuffers"
+		],
+		[
+			"timer",
+			trace_level_t.TRACE_TIMER,
+			"Trace timers"
+		],
+		[
+			"fs",
+			trace_level_t.TRACE_FS,
+			"Trace file system"
+		],
+		[
+			"liburing",
+			trace_level_t.TRACE_URING,
+			"Trace liburing mixins"
+		],
+		[
+			"timer_periodic",
+			trace_level_t.TRACE_TIMER_PERIODIC,
+			"Trace periodic timers"
+		],
+		[
+			"liburing_timer",
+			trace_level_t.TRACE_URING_TIME,
+			"Trace liburing timer"
+		],
+		[
+			"commands",
+			trace_level_t.TRACE_COMMANDS,
+			"Trace commands"
+		]
+	];
+	var __global_trace_level__ = 0;
+	var __global_trace_no_level__ = 0;
+	var __deep_trace__ = 0;
+	function level2bit(level) {
+		for (const [name, bit] of s_global_trace_level) if (name === level) return bit;
+		return 0;
+	}
+	function trace_bitmask(level, who) {
+		if (empty_string(level)) return TRACE_GLOBAL_LEVEL1;
+		if (/^[0-9]+$/.test(String(level))) {
+			const n = Number(level);
+			if (n) return n;
+		}
+		const bit = level2bit(String(level));
+		if (!bit) {
+			log_error(`${who}: trace level NOT FOUND: ${level}`);
+			return 0;
+		}
+		return bit;
+	}
+	/************************************************************
+	*  The levels in force for a gobj: global, plus its gclass's,
+	*  plus its own — the union, exactly as the C kernel computes
+	*  it in gobj_trace_level().
+	************************************************************/
+	function gobj_trace_level(gobj) {
+		if (__deep_trace__) return 4294967295;
+		let bitmask = __global_trace_level__;
+		if (gobj) {
+			bitmask |= gobj.trace_level || 0;
+			if (gobj.gclass) bitmask |= gobj.gclass.trace_level || 0;
+		}
+		return bitmask;
+	}
+	function gobj_trace_no_level(gobj) {
+		let bitmask = __global_trace_no_level__;
+		if (gobj) {
+			bitmask |= gobj.no_trace_level || 0;
+			if (gobj.gclass) bitmask |= gobj.gclass.no_trace_level || 0;
+		}
+		return bitmask;
+	}
+	function legacy_yuno_trace_bits() {
+		if (!__yuno__ || !__yuno__.jn_attrs) return 0;
+		let bits = 0;
+		if (gobj_has_attr(__yuno__, "tracing")) {
+			const tracing = Number(gobj_read_attr(__yuno__, "tracing")) || 0;
+			if (tracing >= 1) bits |= trace_level_t.TRACE_MACHINE;
+			if (tracing >= 2) bits |= trace_level_t.TRACE_EV_KW;
+		}
+		if (gobj_has_attr(__yuno__, "trace_timer") && gobj_read_attr(__yuno__, "trace_timer")) bits |= trace_level_t.TRACE_TIMER;
+		if (gobj_has_attr(__yuno__, "trace_creation") && gobj_read_attr(__yuno__, "trace_creation")) bits |= trace_level_t.TRACE_CREATE_DELETE;
+		if (gobj_has_attr(__yuno__, "trace_start_stop") && gobj_read_attr(__yuno__, "trace_start_stop")) bits |= trace_level_t.TRACE_START_STOP;
+		return bits;
+	}
+	function __trace_gobj_create_delete__(gobj) {
+		return (gobj_trace_level(gobj) | legacy_yuno_trace_bits()) & trace_level_t.TRACE_CREATE_DELETE;
+	}
+	function __trace_gobj_start_stop__(gobj) {
+		return (gobj_trace_level(gobj) | legacy_yuno_trace_bits()) & trace_level_t.TRACE_START_STOP;
+	}
+	function __trace_gobj_ev_kw__(gobj) {
+		return (gobj_trace_level(gobj) | legacy_yuno_trace_bits()) & trace_level_t.TRACE_EV_KW;
+	}
+	function __trace_gobj_states__(gobj) {
+		return gobj_trace_level(gobj) & trace_level_t.TRACE_STATES;
+	}
+	/************************************************************
+	*  Must trace? — the C kernel's is_machine_tracing(), including
+	*  the two event-specific levels: `timer` and `timer_periodic`
+	*  light up only for their own event.
+	************************************************************/
+	function is_machine_tracing(gobj, event) {
+		if (__deep_trace__ > 1) return true;
+		if (!gobj) return false;
+		const level = gobj_trace_level(gobj) | legacy_yuno_trace_bits();
+		return level & trace_level_t.TRACE_MACHINE || level & trace_level_t.TRACE_TIMER_PERIODIC && event === "EV_TIMEOUT_PERIODIC" || level & trace_level_t.TRACE_TIMER && event === "EV_TIMEOUT" ? true : false;
+	}
+	/************************************************************
+	*  Must NOT trace? Asked of the SOURCE, so a noisy sender can
+	*  be silenced without turning the destination off.
+	************************************************************/
+	function is_machine_not_tracing(gobj, event) {
+		if (__deep_trace__ > 1) return false;
+		if (!gobj) return true;
+		const level = gobj_trace_no_level(gobj);
+		return level & trace_level_t.TRACE_MACHINE || level & trace_level_t.TRACE_TIMER_PERIODIC && event === "EV_TIMEOUT_PERIODIC" || level & trace_level_t.TRACE_TIMER && event === "EV_TIMEOUT" ? true : false;
+	}
+	/************************************************************
+	*      The setters — same signatures as the C kernel
+	************************************************************/
+	function gobj_set_global_trace(level, set) {
+		const bitmask = trace_bitmask(level, "gobj_set_global_trace");
+		if (!bitmask) return -1;
+		if (set) __global_trace_level__ |= bitmask;
+		else __global_trace_level__ &= ~bitmask;
+		return 0;
+	}
+	function gobj_set_global_no_trace(level, set) {
+		const bitmask = trace_bitmask(level, "gobj_set_global_no_trace");
+		if (!bitmask) return -1;
+		if (set) __global_trace_no_level__ |= bitmask;
+		else __global_trace_no_level__ &= ~bitmask;
+		return 0;
+	}
+	function gobj_global_trace_level() {
+		return __global_trace_level__;
+	}
+	function gobj_set_deep_trace(value) {
+		__deep_trace__ = Number(value) || 0;
+		return 0;
+	}
+	function gobj_set_gclass_trace(gclass, level, set) {
+		const gclass_ = is_string(gclass) ? gclass_find_by_name(gclass) : gclass;
+		if (!gclass_) {
+			log_error(`gobj_set_gclass_trace: gclass NOT FOUND: ${gclass}`);
+			return -1;
+		}
+		const bitmask = trace_bitmask(level, "gobj_set_gclass_trace");
+		if (!bitmask) return -1;
+		if (set) gclass_.trace_level |= bitmask;
+		else gclass_.trace_level &= ~bitmask;
+		return 0;
+	}
+	function gobj_set_gobj_trace(gobj, level, set) {
+		if (!gobj) {
+			log_error(`gobj_set_gobj_trace: gobj NULL`);
+			return -1;
+		}
+		const bitmask = trace_bitmask(level, "gobj_set_gobj_trace");
+		if (!bitmask) return -1;
+		if (set) gobj.trace_level |= bitmask;
+		else gobj.trace_level &= ~bitmask;
+		return 0;
+	}
+	function gobj_set_gobj_no_trace(gobj, level, set) {
+		if (!gobj) {
+			log_error(`gobj_set_gobj_no_trace: gobj NULL`);
+			return -1;
+		}
+		const bitmask = trace_bitmask(level, "gobj_set_gobj_no_trace");
+		if (!bitmask) return -1;
+		if (set) gobj.no_trace_level |= bitmask;
+		else gobj.no_trace_level &= ~bitmask;
+		return 0;
+	}
+	function gobj_repr_global_trace_levels() {
+		return s_global_trace_level.map(([name, bit, description]) => ({
+			name,
+			bit,
+			description,
+			set: __global_trace_level__ & bit ? true : false
+		}));
+	}
 	/************************************************************
 	*      Start up
 	************************************************************/
@@ -1083,7 +1346,7 @@
 		let gobj = new GObj(gobj_name, gclass, kw, parent, gobj_flag);
 		gobj.jn_attrs = sdata_create(gobj, gclass.attrs_table);
 		for (const [key, value] of Object.entries(gobj.jn_attrs)) if (key in gobj.priv) gobj.priv[key] = value;
-		let trace_creation = __yuno__ && gobj_read_bool_attr(__yuno__, "trace_creation");
+		let trace_creation = __trace_gobj_create_delete__(gobj);
 		if (trace_creation) trace_machine(sprintf("💙💙⏩ creating: %s^%s", gclass.gclass_name, gobj_name));
 		if (gobj.gobj_flag & gobj_flag_t.gobj_flag_service) _register_service(gobj);
 		if (gobj.gobj_flag & gobj_flag_t.gobj_flag_yuno) __yuno__ = gobj;
@@ -1143,7 +1406,7 @@
 			gobj_stop(gobj);
 		}
 		gobj.obflag |= obflag_t.obflag_destroying;
-		let trace_creation = __yuno__ && gobj_read_bool_attr(__yuno__, "trace_creation");
+		let trace_creation = __trace_gobj_create_delete__(gobj);
 		if (trace_creation) trace_machine(sprintf("💔💔⏩ destroying: %s", gobj_full_name(gobj)));
 		let parent = gobj_parent(gobj);
 		if (parent && parent.gclass.gmt.mt_child_removed) {
@@ -1193,7 +1456,7 @@
 			log_error(`${gobj_short_name(gobj)}: GObj DISABLED`);
 			return -1;
 		}
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_start_stop")) trace_machine(sprintf("⏺ ⏺ start: %s", gobj_full_name(gobj)));
+		if (__trace_gobj_start_stop__(gobj)) trace_machine(sprintf("⏺ ⏺ start: %s", gobj_full_name(gobj)));
 		gobj.running = true;
 		let ret = 0;
 		if (gobj.gclass.gmt.mt_start) ret = gobj.gclass.gmt.mt_start(gobj);
@@ -1228,7 +1491,7 @@
 			log_error("gobj NULL or DESTROYED");
 			return -1;
 		}
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_start_stop")) trace_machine(sprintf("⏺ ⏺ ⏺ ⏺ start_tree: %s", gobj_full_name(gobj)));
+		if (__trace_gobj_start_stop__(gobj)) trace_machine(sprintf("⏺ ⏺ ⏺ ⏺ start_tree: %s", gobj_full_name(gobj)));
 		if (gobj.gclass.gclass_flag & gclass_flag_t.gcflag_manual_start) return 0;
 		else if (gobj.disabled) return 0;
 		else if (!gobj.running) gobj_start(gobj);
@@ -1250,7 +1513,7 @@
 			log_warning(`${gobj_short_name(gobj)}: GObj stopping without previous pause`);
 			gobj_pause(gobj);
 		}
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_start_stop")) trace_machine(sprintf("⏹ ⏹ stop: %s", gobj_full_name(gobj)));
+		if (__trace_gobj_start_stop__(gobj)) trace_machine(sprintf("⏹ ⏹ stop: %s", gobj_full_name(gobj)));
 		gobj.running = false;
 		let ret = 0;
 		if (gobj.gclass.gmt.mt_stop) ret = gobj.gclass.gmt.mt_stop(gobj);
@@ -1278,7 +1541,7 @@
 			log_error("gobj NULL or DESTROYED");
 			return -1;
 		}
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_start_stop")) trace_machine(sprintf("⏹ ⏹ ⏹ ⏹ stop_tree: %s", gobj_full_name(gobj)));
+		if (__trace_gobj_start_stop__(gobj)) trace_machine(sprintf("⏹ ⏹ ⏹ ⏹ stop_tree: %s", gobj_full_name(gobj)));
 		if (gobj_is_running(gobj)) gobj_stop(gobj);
 		return gobj_walk_gobj_children_tree(gobj, walk_type_t.WALK_TOP2BOTTOM, cb_stop_child, 0, 0);
 	}
@@ -1305,7 +1568,7 @@
 			log_error(`${gobj_short_name(gobj)}: Cannot play, start not done`);
 			return -1;
 		}
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_start_stop")) trace_machine(sprintf("⏯ ⏯ play: %s", gobj_full_name(gobj)));
+		if (__trace_gobj_start_stop__(gobj)) trace_machine(sprintf("⏯ ⏯ play: %s", gobj_full_name(gobj)));
 		gobj.playing = true;
 		let ret = 0;
 		if (gobj.gclass.gmt.mt_play) {
@@ -1326,7 +1589,7 @@
 			log_error(`${gobj_short_name(gobj)}: GObj NOT PLAYING`);
 			return -1;
 		}
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_start_stop")) trace_machine(sprintf("⏸ ⏸ pause: %s", gobj_full_name(gobj)));
+		if (__trace_gobj_start_stop__(gobj)) trace_machine(sprintf("⏸ ⏸ pause: %s", gobj_full_name(gobj)));
 		gobj.playing = false;
 		if (gobj.gclass.gmt.mt_pause) return gobj.gclass.gmt.mt_pause(gobj);
 		else return 0;
@@ -2003,6 +2266,9 @@
 		}
 		gobj.last_state = gobj.current_state;
 		gobj.current_state = new_state;
+		let tracea = is_machine_tracing(gobj, "EV_STATE_CHANGED");
+		let tracea_states = __trace_gobj_states__(gobj) ? true : false;
+		if (tracea || tracea_states) trace_machine(sprintf("🔀🔀 mach(%s%s^%s), new st(%s), prev st(%s)", !gobj.running ? "!!" : "", gobj_gclass_name(gobj), gobj_name(gobj), gobj_current_state(gobj), gobj.last_state.state_name));
 		return true;
 	}
 	/***************************************************************************
@@ -2034,7 +2300,7 @@
 		}
 		_add_child(parent, gobj);
 		if (parent.mt_child_added) {
-			if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_creation")) log_debug(sprintf("👦👦🔵 child_added(%s): %s", gobj_full_name(parent), gobj_short_name(gobj)));
+			if (__trace_gobj_create_delete__(gobj)) log_debug(sprintf("👦👦🔵 child_added(%s): %s", gobj_full_name(parent), gobj_short_name(gobj)));
 			parent.mt_child_added(parent, gobj);
 		}
 		return 0;
@@ -2104,9 +2370,7 @@
 			log_error(`${gobj_short_name(dst)}: current_state NULL`);
 			return -1;
 		}
-		let tracea = 0;
-		tracea = __yuno__ && gobj_read_integer_attr(__yuno__, "tracing");
-		if (gobj_gclass_name(src) === "C_TIMER") tracea = __yuno__ && gobj_read_integer_attr(__yuno__, "trace_timer");
+		let tracea = is_machine_tracing(dst, event) && !is_machine_not_tracing(src, event);
 		__inside__++;
 		let event_action = _find_event_action(state, event);
 		if (!event_action) {
@@ -2135,7 +2399,7 @@
 				trace_machine(sprintf("🔄 mach(%s%s^%s), st: %s, ev: %s%s%s, ac: %s, from(%s%s^%s)", !dst.running ? "!!" : "", gobj_gclass_name(dst), gobj_name(dst), state.state_name, "", event ? event : "", "", action_name, src && !src.running ? "!!" : "", gobj_gclass_name(src), gobj_name(src)));
 			}
 			if (kw) {
-				if (tracea > 1) {
+				if (__trace_gobj_ev_kw__(dst)) {
 					if (json_object_size(kw)) trace_json(kw);
 				}
 			}
@@ -2682,10 +2946,10 @@
 	function log_error(format) {
 		let msg = format_log(format);
 		let hora = current_timestamp();
-		if (f_error) if (f_error === window.console.error) {
+		if (f_error) if (f_error === _console.error) {
 			if (__console_output_enabled__) f_error("%c" + hora + " ERROR: " + String(msg), "color:red");
 		} else {
-			if (__console_output_enabled__) window.console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
+			if (__console_output_enabled__) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
 			f_error(`${hora} ERROR: ${String(msg)}`);
 		}
 		emit_log_callback("error", msg, hora);
@@ -2693,10 +2957,10 @@
 	function log_warning(format) {
 		let msg = format_log(format);
 		let hora = current_timestamp();
-		if (f_warning) if (f_warning === window.console.warn) {
+		if (f_warning) if (f_warning === _console.warn) {
 			if (__console_output_enabled__) f_warning("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 		} else {
-			if (__console_output_enabled__) window.console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+			if (__console_output_enabled__) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 			f_warning(`${hora} WARNING: ${String(msg)}`);
 		}
 		emit_log_callback("warning", msg, hora);
@@ -6297,6 +6561,7 @@
 	exports.gobj_flag_t = gobj_flag_t;
 	exports.gobj_full_name = gobj_full_name;
 	exports.gobj_gclass_name = gobj_gclass_name;
+	exports.gobj_global_trace_level = gobj_global_trace_level;
 	exports.gobj_has_attr = gobj_has_attr;
 	exports.gobj_has_event = gobj_has_event;
 	exports.gobj_has_output_event = gobj_has_output_event;
@@ -6326,12 +6591,19 @@
 	exports.gobj_read_pointer_attr = gobj_read_pointer_attr;
 	exports.gobj_read_str_attr = gobj_read_str_attr;
 	exports.gobj_remove_persistent_attrs = gobj_remove_persistent_attrs;
+	exports.gobj_repr_global_trace_levels = gobj_repr_global_trace_levels;
 	exports.gobj_reset_volatil_attrs = gobj_reset_volatil_attrs;
 	exports.gobj_save_persistent_attrs = gobj_save_persistent_attrs;
 	exports.gobj_search_path = gobj_search_path;
 	exports.gobj_send_event = gobj_send_event;
 	exports.gobj_services = gobj_services;
 	exports.gobj_set_bottom_gobj = gobj_set_bottom_gobj;
+	exports.gobj_set_deep_trace = gobj_set_deep_trace;
+	exports.gobj_set_gclass_trace = gobj_set_gclass_trace;
+	exports.gobj_set_global_no_trace = gobj_set_global_no_trace;
+	exports.gobj_set_global_trace = gobj_set_global_trace;
+	exports.gobj_set_gobj_no_trace = gobj_set_gobj_no_trace;
+	exports.gobj_set_gobj_trace = gobj_set_gobj_trace;
 	exports.gobj_set_trace_machine_format = gobj_set_trace_machine_format;
 	exports.gobj_short_name = gobj_short_name;
 	exports.gobj_start = gobj_start;
@@ -6343,7 +6615,9 @@
 	exports.gobj_stop_children = gobj_stop_children;
 	exports.gobj_stop_tree = gobj_stop_tree;
 	exports.gobj_subscribe_event = gobj_subscribe_event;
+	exports.gobj_trace_level = gobj_trace_level;
 	exports.gobj_trace_machine_format = gobj_trace_machine_format;
+	exports.gobj_trace_no_level = gobj_trace_no_level;
 	exports.gobj_unsubscribe_event = gobj_unsubscribe_event;
 	exports.gobj_unsubscribe_list = gobj_unsubscribe_list;
 	exports.gobj_walk_gobj_children = gobj_walk_gobj_children;
@@ -6462,6 +6736,7 @@
 	exports.template_get_field_desc = template_get_field_desc;
 	exports.timeTracker = timeTracker;
 	exports.trace_json = trace_json;
+	exports.trace_level_t = trace_level_t;
 	exports.trace_msg = trace_msg;
 	exports.treedb_decoder_fkey = treedb_decoder_fkey;
 	exports.treedb_decoder_hook = treedb_decoder_hook;