@yuneta/gobj-js 7.21.0 → 7.22.1

package/dist/gobj-js.iife.js

@@ -195,7 +195,7 @@ var gobjJs = (function(exports) {
 	*
 	*      Licence: MIT (http://www.opensource.org/licenses/mit-license)
 	*      Copyright (c) 2014,2024 Niyamaka.
-	*      Copyright (c) 2025, ArtGins.
+	*      Copyright (c) 2025-2026, ArtGins.
 	*********************************************************************************/
 	/**************************************************************************
 	*        Constants
@@ -430,6 +430,7 @@ var gobjJs = (function(exports) {
 		TRACE_URING_TIME: 536870912,
 		TRACE_COMMANDS: 1073741824
 	});
+	var TRACE_USER_LEVEL = 65535;
 	var TRACE_GLOBAL_LEVEL1 = 268369920;
 	var s_global_trace_level = [
 		[
@@ -511,17 +512,28 @@ var gobjJs = (function(exports) {
 	var __global_trace_level__ = 0;
 	var __global_trace_no_level__ = 0;
 	var __deep_trace__ = 0;
-	function level2bit(level) {
+	function level2bit(level, s_user_trace_level) {
 		for (const [name, bit] of s_global_trace_level) if (name === level) return bit;
+		if (Array.isArray(s_user_trace_level)) {
+			for (let i = 0; i < s_user_trace_level.length && i < 16; i++) if (s_user_trace_level[i] && s_user_trace_level[i][0] === level) return 1 << i;
+		}
 		return 0;
 	}
-	function trace_bitmask(level, who) {
-		if (empty_string(level)) return TRACE_GLOBAL_LEVEL1;
+	function bit2level(bitmask, s_user_trace_level) {
+		let levels = [];
+		for (const [name, bit] of s_global_trace_level) if (bitmask & bit) levels.push(name);
+		if (Array.isArray(s_user_trace_level)) {
+			for (let i = 0; i < s_user_trace_level.length && i < 16; i++) if (s_user_trace_level[i] && bitmask & 1 << i) levels.push(s_user_trace_level[i][0]);
+		}
+		return levels;
+	}
+	function trace_bitmask(level, who, s_user_trace_level) {
+		if (empty_string(level)) return s_user_trace_level === void 0 ? TRACE_GLOBAL_LEVEL1 : TRACE_USER_LEVEL;
 		if (/^[0-9]+$/.test(String(level))) {
 			const n = Number(level);
 			if (n) return n;
 		}
-		const bit = level2bit(String(level));
+		const bit = level2bit(String(level), s_user_trace_level);
 		if (!bit) {
 			log_error(`${who}: trace level NOT FOUND: ${level}`);
 			return 0;
@@ -550,32 +562,30 @@ var gobjJs = (function(exports) {
 		}
 		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;
+		return gobj_trace_level(gobj) & trace_level_t.TRACE_CREATE_DELETE;
+	}
+	function __trace_gobj_subscriptions__(gobj) {
+		return gobj_trace_level(gobj) & trace_level_t.TRACE_SUBSCRIPTIONS;
 	}
 	function __trace_gobj_start_stop__(gobj) {
-		return (gobj_trace_level(gobj) | legacy_yuno_trace_bits()) & trace_level_t.TRACE_START_STOP;
+		return gobj_trace_level(gobj) & 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;
+		return gobj_trace_level(gobj) & trace_level_t.TRACE_EV_KW;
 	}
 	function __trace_gobj_states__(gobj) {
 		return gobj_trace_level(gobj) & trace_level_t.TRACE_STATES;
 	}
 	/************************************************************
+	*  Must trace a command? — the C kernel's is_commands_tracing()
+	************************************************************/
+	function is_commands_tracing(gobj) {
+		if (__deep_trace__ > 1) return true;
+		if (!gobj) return false;
+		return gobj_trace_level(gobj) & trace_level_t.TRACE_COMMANDS ? true : false;
+	}
+	/************************************************************
 	*  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.
@@ -583,7 +593,7 @@ var gobjJs = (function(exports) {
 	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();
+		const level = gobj_trace_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;
 	}
 	/************************************************************
@@ -616,6 +626,49 @@ var gobjJs = (function(exports) {
 	function gobj_global_trace_level() {
 		return __global_trace_level__;
 	}
+	function gobj_global_trace_no_level() {
+		return __global_trace_no_level__;
+	}
+	function gobj_set_global_trace2(bitmask, set) {
+		if (set) __global_trace_level__ = (__global_trace_level__ | bitmask) >>> 0;
+		else __global_trace_level__ = (__global_trace_level__ & ~bitmask) >>> 0;
+		return 0;
+	}
+	function gobj_set_global_no_trace2(bitmask, set) {
+		if (set) __global_trace_no_level__ = (__global_trace_no_level__ | bitmask) >>> 0;
+		else __global_trace_no_level__ = (__global_trace_no_level__ & ~bitmask) >>> 0;
+		return 0;
+	}
+	function gobj_get_global_trace_level() {
+		return bit2level(__global_trace_level__, null);
+	}
+	function gobj_get_global_trace_no_level() {
+		return bit2level(__global_trace_no_level__, null);
+	}
+	function gobj_get_gclass_trace_level(gclass) {
+		const gclass_ = is_string(gclass) ? gclass_find_by_name(gclass) : gclass;
+		if (!gclass_) {
+			log_error(`gobj_get_gclass_trace_level: gclass NOT FOUND: ${gclass}`);
+			return [];
+		}
+		return bit2level(gclass_.trace_level | __global_trace_level__, gclass_.s_user_trace_level);
+	}
+	function gobj_get_gclass_trace_level2(gclass) {
+		const gclass_ = is_string(gclass) ? gclass_find_by_name(gclass) : gclass;
+		if (!gclass_) {
+			log_error(`gobj_get_gclass_trace_level2: gclass NOT FOUND: ${gclass}`);
+			return [];
+		}
+		return bit2level(gclass_.trace_level, gclass_.s_user_trace_level);
+	}
+	function gobj_get_gclass_trace_no_level(gclass) {
+		const gclass_ = is_string(gclass) ? gclass_find_by_name(gclass) : gclass;
+		if (!gclass_) {
+			log_error(`gobj_get_gclass_trace_no_level: gclass NOT FOUND: ${gclass}`);
+			return [];
+		}
+		return bit2level(gclass_.no_trace_level, gclass_.s_user_trace_level);
+	}
 	function gobj_set_deep_trace(value) {
 		__deep_trace__ = Number(value) || 0;
 		return 0;
@@ -626,7 +679,7 @@ var gobjJs = (function(exports) {
 			log_error(`gobj_set_gclass_trace: gclass NOT FOUND: ${gclass}`);
 			return -1;
 		}
-		const bitmask = trace_bitmask(level, "gobj_set_gclass_trace");
+		const bitmask = level === null ? 4294967295 : trace_bitmask(level, "gobj_set_gclass_trace", gclass_.s_user_trace_level || null);
 		if (!bitmask) return -1;
 		if (set) gclass_.trace_level |= bitmask;
 		else gclass_.trace_level &= ~bitmask;
@@ -637,7 +690,7 @@ var gobjJs = (function(exports) {
 			log_error(`gobj_set_gobj_trace: gobj NULL`);
 			return -1;
 		}
-		const bitmask = trace_bitmask(level, "gobj_set_gobj_trace");
+		const bitmask = trace_bitmask(level, "gobj_set_gobj_trace", gobj.gclass && gobj.gclass.s_user_trace_level || null);
 		if (!bitmask) return -1;
 		if (set) gobj.trace_level |= bitmask;
 		else gobj.trace_level &= ~bitmask;
@@ -649,7 +702,7 @@ var gobjJs = (function(exports) {
 			log_error(`gobj_set_gclass_no_trace: gclass NOT FOUND: ${gclass}`);
 			return -1;
 		}
-		const bitmask = trace_bitmask(level, "gobj_set_gclass_no_trace");
+		const bitmask = level === null ? 4294967295 : trace_bitmask(level, "gobj_set_gclass_no_trace", gclass_.s_user_trace_level || null);
 		if (!bitmask) return -1;
 		if (set) gclass_.no_trace_level |= bitmask;
 		else gclass_.no_trace_level &= ~bitmask;
@@ -660,7 +713,7 @@ var gobjJs = (function(exports) {
 			log_error(`gobj_set_gobj_no_trace: gobj NULL`);
 			return -1;
 		}
-		const bitmask = trace_bitmask(level, "gobj_set_gobj_no_trace");
+		const bitmask = trace_bitmask(level, "gobj_set_gobj_no_trace", gobj.gclass && gobj.gclass.s_user_trace_level || null);
 		if (!bitmask) return -1;
 		if (set) gobj.no_trace_level |= bitmask;
 		else gobj.no_trace_level &= ~bitmask;
@@ -2664,7 +2717,7 @@ var gobjJs = (function(exports) {
 		if (kw_get_int(gobj, subs, "subs_flag", null, kw_flag_t.KW_REQUIRED) & subs_flag_t.__hard_subscription__ ? 1 : 0) {
 			if (!force) return -1;
 		}
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_subscriptions")) {
+		if (__trace_gobj_subscriptions__(subscriber) || __trace_gobj_subscriptions__(publisher)) {
 			trace_machine(sprintf("💜💜👎 unsubscribing event '%s': publisher %s, subscriber'%s'", event ? event : "", gobj_short_name(publisher), gobj_short_name(subscriber)));
 			trace_json(subs);
 		}
@@ -2735,7 +2788,7 @@ var gobjJs = (function(exports) {
 		}
 		json_array_append(publisher.dl_subscriptions, subs);
 		json_array_append(subscriber.dl_subscribings, subs);
-		if (__yuno__ && gobj_read_bool_attr(__yuno__, "trace_subscriptions")) {
+		if (__trace_gobj_subscriptions__(subscriber) || __trace_gobj_subscriptions__(publisher)) {
 			trace_machine(sprintf("💜💜👍 subscribing event '%s', publisher '%s', subscriber %s", event ? event : "", gobj_short_name(publisher), gobj_short_name(subscriber)));
 			if (kw) trace_json(kw);
 		}
@@ -2873,7 +2926,7 @@ var gobjJs = (function(exports) {
 				return -1;
 			}
 		}
-		let tracea = __yuno__ && gobj_read_bool_attr(__yuno__, "trace_subscriptions");
+		let tracea = (__trace_gobj_subscriptions__(publisher) || is_machine_tracing(publisher, event)) && !is_machine_not_tracing(publisher, event);
 		if (tracea) {
 			if (__trace_machine_format__ === 1) trace_machine(sprintf("🔝🔝 %s %s%s %s", event ? event : "", !publisher.running ? "!!" : "", gobj_short_name(publisher), publisher.current_state.state_name));
 			else trace_machine(sprintf("🔝🔝 mach(%s%s^%s), st: %s, ev: %s%s%s", !publisher.running ? "!!" : "", gobj_gclass_name(publisher), gobj_name(publisher), publisher.current_state.state_name, "", event ? event : "", ""));
@@ -2951,10 +3004,9 @@ var gobjJs = (function(exports) {
 			log_error("gobj NULL or DESTROYED");
 			return -1;
 		}
-		let tracea = __yuno__ && gobj_read_integer_attr(__yuno__, "tracing");
-		if (tracea) {
+		if (is_commands_tracing(gobj) || is_machine_tracing(gobj, null) && !is_machine_not_tracing(src, null)) {
 			trace_machine(sprintf("🌀🌀 mach(%s%s), cmd: %s, src: %s", !gobj_is_running(gobj) ? "!!" : "", gobj_short_name(gobj), command, gobj_short_name(src)));
-			if (tracea > 1) trace_json(kw);
+			if (__trace_gobj_ev_kw__(gobj)) trace_json(kw);
 		}
 		if (gobj.gclass.gmt.mt_command_parser) return gobj.gclass.gmt.mt_command_parser(gobj, command, kw, src);
 		if (gobj.gclass.command_table) {
@@ -5052,12 +5104,13 @@ var gobjJs = (function(exports) {
 	*  Get the current timestamp in ISO 8601 format with milliseconds and time zone.
 	*  Example Output: "2024-02-24T14:05:30.123+0200"
 	************************************************************/
-	function current_timestamp() {
-		const now = /* @__PURE__ */ new Date();
-		const timestamp = now.toISOString().slice(0, 19);
-		const milliseconds = String(now.getMilliseconds()).padStart(3, "0");
+	function current_timestamp(now) {
+		now = now || /* @__PURE__ */ new Date();
+		const pad = (n, w) => String(n).padStart(w, "0");
+		const timestamp = `${now.getFullYear()}-${pad(now.getMonth() + 1, 2)}-${pad(now.getDate(), 2)}T${pad(now.getHours(), 2)}:${pad(now.getMinutes(), 2)}:${pad(now.getSeconds(), 2)}`;
+		const milliseconds = pad(now.getMilliseconds(), 3);
 		const offsetMinutes = now.getTimezoneOffset();
-		return `${timestamp}.${milliseconds}${`${offsetMinutes > 0 ? "-" : "+"}${String(Math.abs(offsetMinutes) / 60).padStart(2, "0")}${String(Math.abs(offsetMinutes) % 60).padStart(2, "0")}`}`;
+		return `${timestamp}.${milliseconds}${offsetMinutes > 0 ? "-" : "+"}${pad(Math.floor(Math.abs(offsetMinutes) / 60), 2)}${pad(Math.abs(offsetMinutes) % 60, 2)}`;
 	}
 	/********************************************
 	*  Return UTC time of right now
@@ -6038,7 +6091,7 @@ var gobjJs = (function(exports) {
 	*
 	*          The default yuno in js
 	*
-	*          Copyright (c) 2025, ArtGins.
+	*          Copyright (c) 2025-2026, ArtGins.
 	*          All Rights Reserved. ****************************************************************************/
 	/***************************************************************
 	*              Constants
@@ -6061,15 +6114,9 @@ var gobjJs = (function(exports) {
 		SDATA(data_type_t.DTP_STRING, "yuno_version", 0, "", "Yuno version (APP_VERSION)"),
 		SDATA(data_type_t.DTP_STRING, "yuneta_version", 0, YUNETA_VERSION, "Yuneta version"),
 		SDATA(data_type_t.DTP_LIST, "required_services", 0, "[]", "Required services"),
-		SDATA(data_type_t.DTP_INTEGER, "tracing", 0, 0, "Tracing level"),
-		SDATA(data_type_t.DTP_BOOLEAN, "trace_timer", 0, 0, "Trace timers"),
-		SDATA(data_type_t.DTP_BOOLEAN, "trace_inter_event", 0, 0, "Trace traffic"),
-		SDATA(data_type_t.DTP_POINTER, "trace_ievent_callback", 0, null, "Trace traffic callback"),
-		SDATA(data_type_t.DTP_BOOLEAN, "trace_creation", 0, 0, "Trace creation"),
-		SDATA(data_type_t.DTP_BOOLEAN, "trace_start_stop", 0, 0, "Trace start/stop"),
-		SDATA(data_type_t.DTP_BOOLEAN, "trace_subscriptions", 0, 0, "Trace subscription"),
-		SDATA(data_type_t.DTP_BOOLEAN, "trace_i18n", 0, 0, "Trace i18n"),
-		SDATA(data_type_t.DTP_BOOLEAN, "no_poll", 0, 0, "no poll"),
+		SDATA(data_type_t.DTP_DICT, "trace_levels", sdata_flag_t.SDF_PERSIST, "{}", "Trace levels"),
+		SDATA(data_type_t.DTP_DICT, "no_trace_levels", sdata_flag_t.SDF_PERSIST, "{}", "No trace levels"),
+		SDATA(data_type_t.DTP_POINTER, "trace_ievent_callback", 0, null, "Where the traffic trace goes (C_IEVENT_CLI levels ievents/ievents2); console when null"),
 		SDATA(data_type_t.DTP_BOOLEAN, "developer", 0, false, "Developer mode enabled"),
 		SDATA(data_type_t.DTP_INTEGER, "periodic_timeout", 0, "1000", "Timeout periodic, in miliseconds."),
 		SDATA_END()
@@ -6088,6 +6135,8 @@ var gobjJs = (function(exports) {
 		gobj_write_str_attr(gobj, "node_uuid", node_uuid());
 		gobj.priv.gobj_timer = gobj_create_pure_child(gobj_name(gobj), "C_TIMER", {}, gobj);
 		priv.periodic_timeout = gobj_read_attr(gobj, "periodic_timeout");
+		set_user_gclass_traces(gobj);
+		set_user_gclass_no_traces(gobj);
 	}
 	/***************************************************************
 	*          Framework Method: Writing
@@ -6132,8 +6181,135 @@ var gobjJs = (function(exports) {
 	*      Local Methods
 	***************************/
 	/***************************************************************
+	*  Restore the trace levels the user persisted.
 	*
+	*  A saved scope REPLACES what is in force: main() sets its defaults
+	*  (gobj_set_global_no_trace("timer_periodic"), a gclass it wants quiet)
+	*  before the yuno is created, and a default the user turned off must
+	*  stay off. A scope is saved whole, empty included (save_global_trace());
+	*  a scope never saved keeps main()'s. The C kernel's C_YUNO does the same.
 	***************************************************************/
+	function set_user_gclass_traces(gobj) {
+		let jn_trace_levels = gobj_read_attr(gobj, "trace_levels");
+		if (!is_object(jn_trace_levels)) return 0;
+		let jn_global = jn_trace_levels["__global_trace__"];
+		if (is_array(jn_global)) {
+			gobj_set_global_trace2(4294967295, false);
+			for (let level of jn_global) gobj_set_global_trace(level, true);
+		}
+		for (const [name, jn_levels] of Object.entries(jn_trace_levels)) {
+			let gclass = gclass_find_by_name(name);
+			if (!gclass) continue;
+			if (!is_array(jn_levels)) {
+				log_error(`${gobj_name(gobj)}: trace_levels of ${name} MUST be a list`);
+				continue;
+			}
+			gobj_set_gclass_trace(gclass, null, false);
+			for (let level of jn_levels) gobj_set_gclass_trace(gclass, level, true);
+		}
+		return 0;
+	}
+	/***************************************************************
+	*  Restore the no-trace levels, see set_user_gclass_traces()
+	***************************************************************/
+	function set_user_gclass_no_traces(gobj) {
+		let jn_no_trace_levels = gobj_read_attr(gobj, "no_trace_levels");
+		if (!is_object(jn_no_trace_levels)) return 0;
+		let jn_global = jn_no_trace_levels["__global_no_trace__"];
+		if (is_array(jn_global)) {
+			gobj_set_global_no_trace2(4294967295, false);
+			for (let level of jn_global) gobj_set_global_no_trace(level, true);
+		}
+		for (const [name, jn_levels] of Object.entries(jn_no_trace_levels)) {
+			let gclass = gclass_find_by_name(name);
+			if (!gclass) continue;
+			if (!is_array(jn_levels)) {
+				log_error(`${gobj_name(gobj)}: no_trace_levels of ${name} MUST be a list`);
+				continue;
+			}
+			gobj_set_gclass_no_trace(gclass, null, false);
+			for (let level of jn_levels) gobj_set_gclass_no_trace(gclass, level, true);
+		}
+		return 0;
+	}
+	/***************************************************************
+	*  Save a scope WHOLE, from the levels in force (see
+	*  set_user_gclass_traces()): a saved scope replaces main()'s, so it
+	*  has to carry everything that must be in force.
+	***************************************************************/
+	function save_trace_scope(gobj, attr, scope, levels) {
+		let jn_levels = gobj_read_attr(gobj, attr);
+		if (!is_object(jn_levels)) jn_levels = {};
+		jn_levels[scope] = levels;
+		gobj_write_attr(gobj, attr, jn_levels);
+		return gobj_save_persistent_attrs(gobj, attr);
+	}
+	/***************************************************************
+	*  "set" as the C command reads it: TRUE / set / 1, FALSE / reset / 0
+	***************************************************************/
+	function parse_set(value) {
+		if (value === true || value === false) return value;
+		let v = String(value === void 0 || value === null ? "" : value).toLowerCase();
+		if (v === "true" || v === "set") return true;
+		if (v === "false" || v === "reset") return false;
+		if (v === "" || isNaN(Number(v))) return null;
+		return Number(v) ? true : false;
+	}
+	function yuno_prefix() {
+		return `${gobj_yuno_role()}^${gobj_yuno_name()}`;
+	}
+	/***************************
+	*      Commands
+	***************************/
+	/***************************************************************
+	*  The trace commands of the C kernel's C_YUNO, same names and same
+	*  parameters (`level`, `set`, `gclass_name` / `gclass`). Setting a
+	*  level saves its scope.
+	***************************************************************/
+	function mt_command_parser(gobj, command, kw, src) {
+		kw = kw || {};
+		switch (command) {
+			case "get-global-trace": return build_command_response(gobj, 0, null, null, gobj_get_global_trace_level());
+			case "get-global-no-trace": return build_command_response(gobj, 0, null, null, gobj_get_global_trace_no_level());
+			case "set-global-trace":
+			case "set-global-no-trace": {
+				let no = command === "set-global-no-trace";
+				let level = kw.level;
+				let set = parse_set(kw.set);
+				if (!level) return build_command_response(gobj, -1, `${yuno_prefix()}: what level?`, null, null);
+				if (set === null) return build_command_response(gobj, -1, `${yuno_prefix()}: bitmask set or re-set?`, null, null);
+				if ((no ? gobj_set_global_no_trace(level, set) : gobj_set_global_trace(level, set)) < 0) return build_command_response(gobj, -1, `${yuno_prefix()}: global trace level not found: ${level}`, null, null);
+				if (no) {
+					save_trace_scope(gobj, "no_trace_levels", "__global_no_trace__", gobj_get_global_trace_no_level());
+					return build_command_response(gobj, 0, null, null, gobj_get_global_trace_no_level());
+				}
+				save_trace_scope(gobj, "trace_levels", "__global_trace__", gobj_get_global_trace_level());
+				return build_command_response(gobj, 0, null, null, gobj_get_global_trace_level());
+			}
+			case "get-gclass-trace":
+			case "get-gclass-no-trace":
+			case "set-gclass-trace":
+			case "set-gclass-no-trace": {
+				let no = command.indexOf("no-trace") >= 0;
+				let gclass_name = kw.gclass_name || kw.gclass || "";
+				let gclass = gclass_find_by_name(gclass_name);
+				if (!gclass) return build_command_response(gobj, -1, `${yuno_prefix()}: what gclass is '${gclass_name}'?`, null, null);
+				if (command.indexOf("get-") === 0) return build_command_response(gobj, 0, null, null, no ? gobj_get_gclass_trace_no_level(gclass) : gobj_get_gclass_trace_level(gclass));
+				let level = kw.level;
+				let set = parse_set(kw.set);
+				if (!level) return build_command_response(gobj, -1, `${yuno_prefix()}: what level?`, null, null);
+				if (set === null) return build_command_response(gobj, -1, `${yuno_prefix()}: bitmask set or re-set?`, null, null);
+				if ((no ? gobj_set_gclass_no_trace(gclass, level, set) : gobj_set_gclass_trace(gclass, level, set)) < 0) return build_command_response(gobj, -1, `${yuno_prefix()}: trace level of ${gclass_name} not found: ${level}`, null, null);
+				if (no) {
+					save_trace_scope(gobj, "no_trace_levels", gclass_name, gobj_get_gclass_trace_no_level(gclass));
+					return build_command_response(gobj, 0, null, null, gobj_get_gclass_trace_no_level(gclass));
+				}
+				save_trace_scope(gobj, "trace_levels", gclass_name, gobj_get_gclass_trace_level2(gclass));
+				return build_command_response(gobj, 0, null, null, gobj_get_gclass_trace_level(gclass));
+			}
+			default: return build_command_response(gobj, -1, `${yuno_prefix()}: command not available: ${command}`, null, null);
+		}
+	}
 	/***************************
 	*      Actions
 	***************************/
@@ -6154,7 +6330,8 @@ var gobjJs = (function(exports) {
 		mt_stop: mt_stop$1,
 		mt_destroy: mt_destroy$1,
 		mt_play,
-		mt_pause
+		mt_pause,
+		mt_command_parser
 	};
 	/***************************************************************
 	*          Create the GClass
@@ -6190,7 +6367,7 @@ var gobjJs = (function(exports) {
 	*
 	*      Licence: MIT (http://www.opensource.org/licenses/mit-license)
 	*      Copyright (c) 2014,2024 Niyamaka.
-	*      Copyright (c) 2025, ArtGins.
+	*      Copyright (c) 2025-2026, ArtGins.
 	**************************************************************************/
 	/***************************************************************
 	*              Constants
@@ -6220,6 +6397,14 @@ var gobjJs = (function(exports) {
 		SDATA(data_type_t.DTP_POINTER, "subscriber", 0, 0, "subscriber of output-events. If null then subscriber is the parent"),
 		SDATA_END()
 	];
+	var s_user_trace_level = [
+		["ievents", "Trace inter-events with metadata of kw"],
+		["ievents2", "Trace inter-events with full kw"],
+		["identity-card", "Trace identity_card messages"]
+	];
+	function is_traffic_tracing(gobj) {
+		return gobj_trace_level(gobj) & 3 ? true : false;
+	}
 	var PRIVATE_DATA = {
 		url: null,
 		remote_yuno_name: null,
@@ -6482,7 +6667,7 @@ var gobjJs = (function(exports) {
 	function send_iev(gobj, iev) {
 		let priv = gobj.priv;
 		let msg = JSON.stringify(iev);
-		if (gobj_read_bool_attr(gobj_yuno(), "trace_inter_event")) {
+		if (is_traffic_tracing(gobj)) {
 			let url = gobj_read_str_attr(gobj, "url");
 			let prefix = gobj_name(gobj_yuno()) + " ==> " + url;
 			let trace_ievent_callback = gobj_read_attr(gobj_yuno(), "trace_ievent_callback");
@@ -6776,7 +6961,7 @@ var gobjJs = (function(exports) {
 	function ac_on_message(gobj, event, kw, src) {
 		let url = gobj.priv.url;
 		let iev_msg = iev_create_from_json(gobj, kw.data);
-		if (gobj_read_bool_attr(gobj_yuno(), "trace_inter_event")) {
+		if (is_traffic_tracing(gobj)) {
 			let prefix = gobj_name(gobj_yuno()) + " <== " + url;
 			let size = kw.data.length;
 			let trace_ievent_callback = gobj_read_attr(gobj_yuno(), "trace_ievent_callback");
@@ -6949,7 +7134,7 @@ var gobjJs = (function(exports) {
 			["EV_ON_OPEN_ERROR", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],
 			["EV_TIMEOUT", 0],
 			[null, 0]
-		], states, gmt, 0, attrs_table, PRIVATE_DATA, 0, 0, 0, gclass_flag_t.gcflag_no_check_output_events);
+		], states, gmt, 0, attrs_table, PRIVATE_DATA, 0, 0, s_user_trace_level, gclass_flag_t.gcflag_no_check_output_events);
 		if (!__gclass__) return -1;
 		return 0;
 	}
@@ -7041,7 +7226,13 @@ var gobjJs = (function(exports) {
 	exports.gobj_flag_t = gobj_flag_t;
 	exports.gobj_full_name = gobj_full_name;
 	exports.gobj_gclass_name = gobj_gclass_name;
+	exports.gobj_get_gclass_trace_level = gobj_get_gclass_trace_level;
+	exports.gobj_get_gclass_trace_level2 = gobj_get_gclass_trace_level2;
+	exports.gobj_get_gclass_trace_no_level = gobj_get_gclass_trace_no_level;
+	exports.gobj_get_global_trace_level = gobj_get_global_trace_level;
+	exports.gobj_get_global_trace_no_level = gobj_get_global_trace_no_level;
 	exports.gobj_global_trace_level = gobj_global_trace_level;
+	exports.gobj_global_trace_no_level = gobj_global_trace_no_level;
 	exports.gobj_has_attr = gobj_has_attr;
 	exports.gobj_has_event = gobj_has_event;
 	exports.gobj_has_output_event = gobj_has_output_event;
@@ -7083,7 +7274,9 @@ var gobjJs = (function(exports) {
 	exports.gobj_set_gclass_no_trace = gobj_set_gclass_no_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_no_trace2 = gobj_set_global_no_trace2;
 	exports.gobj_set_global_trace = gobj_set_global_trace;
+	exports.gobj_set_global_trace2 = gobj_set_global_trace2;
 	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;