@yuneta/gobj-js 7.9.4 → 7.9.5

package/dist/gobj-js.cjs.js

@@ -400,6 +400,269 @@ function trace_machine(msg) {
 	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
 ************************************************************/
@@ -1080,7 +1343,7 @@ function gobj_create2(gobj_name, gclass_name, kw, parent, gobj_flag) {
 	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;
@@ -1140,7 +1403,7 @@ function gobj_destroy(gobj) {
 		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) {
@@ -1190,7 +1453,7 @@ function gobj_start(gobj) {
 		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);
@@ -1225,7 +1488,7 @@ function gobj_start_tree(gobj) {
 		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);
@@ -1247,7 +1510,7 @@ function gobj_stop(gobj) {
 		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);
@@ -1275,7 +1538,7 @@ function gobj_stop_tree(gobj) {
 		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);
 }
@@ -1302,7 +1565,7 @@ function gobj_play(gobj) {
 		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) {
@@ -1323,7 +1586,7 @@ function gobj_pause(gobj) {
 		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;
@@ -2000,6 +2263,9 @@ function gobj_change_state(gobj, state_name) {
 	}
 	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;
 }
 /***************************************************************************
@@ -2031,7 +2297,7 @@ function gobj_change_parent(gobj, parent) {
 	}
 	_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;
@@ -2101,9 +2367,7 @@ function gobj_send_event(dst, event, kw, src) {
 		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) {
@@ -2132,7 +2396,7 @@ function gobj_send_event(dst, event, kw, src) {
 			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);
 			}
 		}
@@ -2679,10 +2943,10 @@ function format_log(format) {
 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);
@@ -2690,10 +2954,10 @@ function log_error(format) {
 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);
@@ -6294,6 +6558,7 @@ exports.gobj_find_subscriptions = gobj_find_subscriptions;
 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;
@@ -6323,12 +6588,19 @@ exports.gobj_read_integer_attr = gobj_read_integer_attr;
 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;
@@ -6340,7 +6612,9 @@ exports.gobj_stop = gobj_stop;
 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;
@@ -6459,6 +6733,7 @@ exports.strstr = strstr;
 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;