@yuneta/gobj-js 7.9.11 → 7.12.0

package/dist/gobj-js.umd.js

@@ -90,9 +90,7 @@
 				case "x":
 					arg = (parseInt(arg, 10) >>> 0).toString(16);
 					break;
-				case "X":
-					arg = (parseInt(arg, 10) >>> 0).toString(16).toUpperCase();
-					break;
+				case "X": arg = (parseInt(arg, 10) >>> 0).toString(16).toUpperCase();
 			}
 			if (re.json.test(ph.type)) output += arg;
 			else {
@@ -780,9 +778,7 @@
 				}
 				else jn_value = svalue;
 				break;
-			case data_type_t.DTP_POINTER:
-				jn_value = svalue;
-				break;
+			case data_type_t.DTP_POINTER: jn_value = svalue;
 		}
 		if (jn_value === void 0) {
 			log_error(`default_value WRONG, it: ${it.name}, value: ${it.default_value}`);
@@ -852,9 +848,7 @@
 					return -1;
 				}
 				break;
-			case data_type_t.DTP_POINTER:
-				jn_value2 = jn_value_;
-				break;
+			case data_type_t.DTP_POINTER: jn_value2 = jn_value_;
 		}
 		if (jn_value2 === void 0) log_error(`${gobj_short_name(gobj)}: attr undefined: ${it.name}`);
 		sdata[it.name] = jn_value2;
@@ -1133,6 +1127,7 @@
 		} catch (e) {}
 		if (!gclass) {
 			if (verbose) log_error(`gclass not found: ${gclass_name}`);
+			return null;
 		}
 		return gclass;
 	}
@@ -1157,8 +1152,8 @@
 	function gobj_find_service(service_name, verbose) {
 		service_name = service_name.toLowerCase();
 		let service_gobj = __jn_services__[service_name];
-		if (!service_gobj && verbose) {
-			log_error(`gobj service not found: ${service_name}`);
+		if (!service_gobj) {
+			if (verbose) log_error(`gobj service not found: ${service_name}`);
 			return null;
 		}
 		return service_gobj;
@@ -1418,6 +1413,7 @@
 			gobj_stop(gobj);
 		}
 		gobj.obflag |= obflag_t.obflag_destroying;
+		purge_posted_events(gobj);
 		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);
@@ -1573,12 +1569,14 @@
 			log_error(`${gobj_short_name(gobj)}: GObj DISABLED`);
 			return -1;
 		}
-		if (!gobj_is_running(gobj)) if (!(gobj.gclass.gclass_flag & gclass_flag_t.gcflag_required_start_to_play)) {
-			log_warning(`${gobj_short_name(gobj)}: GObj playing without previous start`);
-			gobj_start(gobj);
-		} else {
-			log_error(`${gobj_short_name(gobj)}: Cannot play, start not done`);
-			return -1;
+		if (!gobj_is_running(gobj)) {
+			if (!(gobj.gclass.gclass_flag & gclass_flag_t.gcflag_required_start_to_play)) {
+				log_warning(`${gobj_short_name(gobj)}: GObj playing without previous start`);
+				gobj_start(gobj);
+			} else {
+				log_error(`${gobj_short_name(gobj)}: Cannot play, start not done`);
+				return -1;
+			}
 		}
 		if (__trace_gobj_start_stop__(gobj)) trace_machine(sprintf("⏯ ⏯ play: %s", gobj_full_name(gobj)));
 		gobj.playing = true;
@@ -2357,13 +2355,97 @@
 		return true;
 	}
 	/************************************************************
-	*      post_event, by now only in js
+	*      Posted events: gobj_send_event(), but on the next turn
+	*
+	*  Same contract as the C side (see gobj.h). It exists to get out of the
+	*  stack you are standing on: gobj_publish_event() dispatches synchronously,
+	*  so a subscriber action runs inside the publisher's own stack, and
+	*  destroying that publisher there dismantles what is still iterating.
+	*
+	*  The queue is drained with setTimeout(0) and NOT with queueMicrotask():
+	*  a microtask runs before the browser can paint or handle an input, so a
+	*  chain of posted events would hold the page exactly the way it used to
+	*  hold the event loop in C. A macrotask gives the browser its turn between
+	*  one event and the next.
+	*
+	*  Delivery is a SNAPSHOT: the events queued when the drain begins are the
+	*  ones delivered in it, and whatever an action posts while it runs waits
+	*  for the following turn.
 	************************************************************/
-	function gobj_post_event(gobj, event, kw, src) {
-		setTimeout(() => {
-			if (gobj_is_destroying(gobj)) return;
-			gobj_send_event(gobj, event, kw, src);
-		}, 10);
+	var MAX_POSTED_EVENTS = 1e4;
+	var __dl_posted_events__ = [];
+	var __posted_events_scheduled__ = false;
+	function gobj_post_event(dst, event, kw, src) {
+		if (!dst || !(dst instanceof GObj)) {
+			log_error(`gobj_post_event(): gobj dst NULL, event ${event}`);
+			return -1;
+		}
+		if (dst.obflag & (obflag_t.obflag_destroyed | obflag_t.obflag_destroying)) {
+			log_error(`gobj_post_event(): gobj dst DESTROYING, event ${event}`);
+			return -1;
+		}
+		if (empty_string(event)) {
+			log_error(`gobj_post_event(): event EMPTY`);
+			return -1;
+		}
+		if (!gobj_has_event(dst, event, 0)) {
+			log_error(`gobj_post_event(): event NOT DEFINED in gclass ${gobj_gclass_name(dst)}, event ${event}`);
+			return -1;
+		}
+		if (__dl_posted_events__.length >= MAX_POSTED_EVENTS) {
+			log_error(`gobj_post_event(): too many posted events, this is NOT a work queue, event ${event}, pending ${__dl_posted_events__.length}`);
+			return -1;
+		}
+		__dl_posted_events__.push({
+			dst,
+			event,
+			kw,
+			src
+		});
+		if (is_machine_tracing(dst, event) && !is_machine_not_tracing(src, event)) trace_machine(sprintf("📬 posted(%s%s), ev: %s, pending: %d", !dst.running ? "!!" : "", gobj_short_name(dst), event, __dl_posted_events__.length));
+		if (!__posted_events_scheduled__) {
+			__posted_events_scheduled__ = true;
+			setTimeout(gobj_deliver_posted_events, 0);
+		}
+		return 0;
+	}
+	/************************************************************
+	*      How many posted events wait for delivery
+	************************************************************/
+	function gobj_posted_events_size() {
+		return __dl_posted_events__.length;
+	}
+	/************************************************************
+	*      Deliver the posted events. One turn, one snapshot.
+	************************************************************/
+	function gobj_deliver_posted_events() {
+		__posted_events_scheduled__ = false;
+		let snapshot = __dl_posted_events__;
+		__dl_posted_events__ = [];
+		let delivered = 0;
+		for (let msg of snapshot) {
+			if (msg.dst.obflag & (obflag_t.obflag_destroyed | obflag_t.obflag_destroying)) continue;
+			gobj_send_event(msg.dst, msg.event, msg.kw, msg.src);
+			delivered++;
+		}
+		if (__dl_posted_events__.length > 0 && !__posted_events_scheduled__) {
+			__posted_events_scheduled__ = true;
+			setTimeout(gobj_deliver_posted_events, 0);
+		}
+		return delivered;
+	}
+	/************************************************************
+	*      Take a gobj out of the queue of posted events.
+	*
+	*  Called from gobj_destroy(), and the two halves are not the same thing:
+	*  as DESTINATION the entry is dropped, as SOURCE only the pointer is
+	*  cleared -- the destination still wants its event, and it arrives with
+	*  src null, which every action already has to accept.
+	************************************************************/
+	function purge_posted_events(gobj) {
+		if (__dl_posted_events__.length === 0) return;
+		for (let msg of __dl_posted_events__) if (msg.src === gobj) msg.src = null;
+		__dl_posted_events__ = __dl_posted_events__.filter((msg) => msg.dst !== gobj);
 	}
 	/************************************************************
 	*      send_event
@@ -2599,7 +2681,7 @@
 			log_error(`subscriber NULL: ev ${event}`);
 			return 0;
 		}
-		const IGNORED_KEYS = new Set([
+		const IGNORED_KEYS = /* @__PURE__ */ new Set([
 			"__config__",
 			"__global__",
 			"__local__",
@@ -2655,7 +2737,7 @@
 			log_error(`subscriber NULL: ev ${event}`);
 			return 0;
 		}
-		const IGNORED_KEYS = new Set([
+		const IGNORED_KEYS = /* @__PURE__ */ new Set([
 			"__config__",
 			"__global__",
 			"__local__",
@@ -2849,9 +2931,10 @@
 			if (tracea > 1) 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) if (__global_command_parser_fn__) return __global_command_parser_fn__(gobj, command, kw, src);
-		else return build_command_response(gobj, -1, sprintf("%s: global command parser not available", gobj_short_name(gobj)), 0, 0);
-		else return build_command_response(gobj, -1, sprintf("%s: command table not available", gobj_short_name(gobj)), 0, 0);
+		if (gobj.gclass.command_table) {
+			if (__global_command_parser_fn__) return __global_command_parser_fn__(gobj, command, kw, src);
+			else return build_command_response(gobj, -1, sprintf("%s: global command parser not available", gobj_short_name(gobj)), 0, 0);
+		} else return build_command_response(gobj, -1, sprintf("%s: command table not available", gobj_short_name(gobj)), 0, 0);
 	}
 	/************************************************************
 	*  Exec gobj stats. Return a webix
@@ -2958,22 +3041,26 @@
 	function log_error(format) {
 		let msg = format_log(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");
-		} else {
-			if (__console_output_enabled__) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
-			f_error(`${hora} ERROR: ${String(msg)}`);
+		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__) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
+				f_error(`${hora} ERROR: ${String(msg)}`);
+			}
 		}
 		emit_log_callback("error", msg, hora);
 	}
 	function log_warning(format) {
 		let msg = format_log(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");
-		} else {
-			if (__console_output_enabled__) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
-			f_warning(`${hora} WARNING: ${String(msg)}`);
+		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__) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+				f_warning(`${hora} WARNING: ${String(msg)}`);
+			}
 		}
 		emit_log_callback("warning", msg, hora);
 	}
@@ -4009,10 +4096,12 @@
 					vv["id"] = field_id;
 					vv["value"] = v[field_id];
 				} else {
-					if (!kw_has_key(v, field_value)) if (json_size(v) > 0) field_value = Object.keys(v)[0];
-					else {
-						log_error("list2options(): object without field value: " + field_value);
-						continue;
+					if (!kw_has_key(v, field_value)) {
+						if (json_size(v) > 0) field_value = Object.keys(v)[0];
+						else {
+							log_error("list2options(): object without field value: " + field_value);
+							continue;
+						}
 					}
 					vv["id"] = v[field_id];
 					vv["value"] = v[field_value];
@@ -4328,13 +4417,15 @@
 			if (is_object(v)) v = kw_get_dict_value(null, v, jdb.hook, [], 1);
 			v = _jdb_get(v, null, id, false);
 		}
-		if (ids.length === 0 && v) if (is_array(v)) v.push(kw);
-		else if (v["id"] === kw["id"]) Object.assign(v, kw);
-		else {
-			let v_ = kw_get_dict_value(null, v, jdb.hook, [], 1);
-			let v__ = _jdb_get(v_, jdb.hook, kw["id"], false);
-			if (v__) Object.assign(v__, kw);
-			else v_.push(kw);
+		if (ids.length === 0 && v) {
+			if (is_array(v)) v.push(kw);
+			else if (v["id"] === kw["id"]) Object.assign(v, kw);
+			else {
+				let v_ = kw_get_dict_value(null, v, jdb.hook, [], 1);
+				let v__ = _jdb_get(v_, jdb.hook, kw["id"], false);
+				if (v__) Object.assign(v__, kw);
+				else v_.push(kw);
+			}
 		}
 		return topic;
 	}
@@ -4360,13 +4451,15 @@
 			if (is_object(v)) v = kw_get_dict_value(null, v, jdb.hook, null, 0);
 			v = _jdb_get(v, null, id, false);
 		}
-		if (ids.length === 0 && v) if (is_array(v)) {
-			let idx = id_index_in_obj_list(v, kw["id"]);
-			if (idx >= 0) v.splice(idx, 1);
-		} else {
-			let v_ = kw_get_dict_value(null, v, jdb.hook, null, 0);
-			let idx = id_index_in_obj_list(v_, kw["id"]);
-			if (idx >= 0) v_.splice(idx, 1);
+		if (ids.length === 0 && v) {
+			if (is_array(v)) {
+				let idx = id_index_in_obj_list(v, kw["id"]);
+				if (idx >= 0) v.splice(idx, 1);
+			} else {
+				let v_ = kw_get_dict_value(null, v, jdb.hook, null, 0);
+				let idx = id_index_in_obj_list(v_, kw["id"]);
+				if (idx >= 0) v_.splice(idx, 1);
+			}
 		}
 		return topic;
 	}
@@ -5093,41 +5186,42 @@
 	*      }
 	************************************************************/
 	function treedb_decoder_fkey(col, fkey) {
-		if (is_string(fkey)) if (fkey.indexOf("^") === -1) {
-			let fkey_desc = col.fkey;
-			if (json_object_size(fkey_desc) !== 1) {
-				log_error("bad fkey 1");
-				log_error(col);
-				log_error(fkey);
-				return null;
-			}
-			let topic_name;
-			let hook_name;
-			for (const k of Object.keys(fkey_desc)) {
-				topic_name = k;
-				hook_name = fkey_desc[k];
-				break;
-			}
-			return {
-				topic_name,
-				id: fkey,
-				hook_name
-			};
-		} else {
-			let tt = fkey.split("^");
-			if (tt.length !== 3) {
-				log_error("bad fkey 2");
-				log_error(col);
-				log_error(fkey);
-				return null;
+		if (is_string(fkey)) {
+			if (fkey.indexOf("^") === -1) {
+				let fkey_desc = col.fkey;
+				if (json_object_size(fkey_desc) !== 1) {
+					log_error("bad fkey 1");
+					log_error(col);
+					log_error(fkey);
+					return null;
+				}
+				let topic_name;
+				let hook_name;
+				for (const k of Object.keys(fkey_desc)) {
+					topic_name = k;
+					hook_name = fkey_desc[k];
+					break;
+				}
+				return {
+					topic_name,
+					id: fkey,
+					hook_name
+				};
+			} else {
+				let tt = fkey.split("^");
+				if (tt.length !== 3) {
+					log_error("bad fkey 2");
+					log_error(col);
+					log_error(fkey);
+					return null;
+				}
+				return {
+					topic_name: tt[0],
+					id: tt[1],
+					hook_name: tt[2]
+				};
 			}
-			return {
-				topic_name: tt[0],
-				id: tt[1],
-				hook_name: tt[2]
-			};
-		}
-		else if (is_object(fkey)) return {
+		} else if (is_object(fkey)) return {
 			topic_name: fkey.topic_name,
 			id: fkey.id,
 			hook_name: fkey.hook_name
@@ -5169,38 +5263,39 @@
 	*      }
 	********************************************/
 	function treedb_decoder_hook(col, hook) {
-		if (is_string(hook)) if (hook.indexOf("^") === -1) {
-			let hook_desc = col.hook;
-			if (json_object_size(hook_desc) !== 1) {
-				log_error("bad hook 1");
-				log_error(col);
-				log_error(hook);
-				return null;
-			}
-			let topic_name;
-			for (let k of Object.keys(hook_desc)) {
-				topic_name = k;
-				hook_desc[k];
-				break;
-			}
-			return {
-				topic_name,
-				id: hook
-			};
-		} else {
-			let tt = hook.split("^");
-			if (tt.length !== 2) {
-				log_error("bad hook 2");
-				log_error(col);
-				log_error(hook);
-				return null;
+		if (is_string(hook)) {
+			if (hook.indexOf("^") === -1) {
+				let hook_desc = col.hook;
+				if (json_object_size(hook_desc) !== 1) {
+					log_error("bad hook 1");
+					log_error(col);
+					log_error(hook);
+					return null;
+				}
+				let topic_name;
+				for (let k of Object.keys(hook_desc)) {
+					topic_name = k;
+					hook_desc[k];
+					break;
+				}
+				return {
+					topic_name,
+					id: hook
+				};
+			} else {
+				let tt = hook.split("^");
+				if (tt.length !== 2) {
+					log_error("bad hook 2");
+					log_error(col);
+					log_error(hook);
+					return null;
+				}
+				return {
+					topic_name: tt[0],
+					id: tt[1]
+				};
 			}
-			return {
-				topic_name: tt[0],
-				id: tt[1]
-			};
-		}
-		else if (is_object(hook)) return {
+		} else if (is_object(hook)) return {
 			topic_name: hook.topic_name,
 			id: hook.id
 		};
@@ -5306,9 +5401,7 @@
 					case "template":
 						field_desc.enum_list = col.template;
 						break;
-					case "table":
-						field_desc.enum_list = col.table;
-						break;
+					case "table": field_desc.enum_list = col.table;
 				}
 				field_desc.type = f;
 			} else if (str_in_list(treedb_field_attributes, f)) switch (f) {
@@ -5321,9 +5414,7 @@
 				case "required":
 					field_desc.is_required = true;
 					break;
-				case "hidden":
-					field_desc.is_hidden = true;
-					break;
+				case "hidden": field_desc.is_hidden = true;
 			}
 		}
 		return field_desc;
@@ -5360,9 +5451,7 @@
 					case "required":
 						field_desc.is_required = true;
 						break;
-					case "hidden":
-						field_desc.is_hidden = true;
-						break;
+					case "hidden": field_desc.is_hidden = true;
 				}
 			}
 			if (!field_desc.real_type) field_desc.real_type = "string";
@@ -5386,7 +5475,8 @@
 		Object.entries(template).forEach(([field, col]) => {
 			let default_value;
 			if (is_object(col)) default_value = col.default;
-			new_record[field] = kw_get_dict_value(null, kw, field, default_value);
+			let value = kw_get_dict_value(null, kw, field, default_value);
+			new_record[field] = value;
 		});
 		return new_record;
 	}
@@ -5467,7 +5557,6 @@
 				if (priv.msec > 0) {
 					if (!gobj_is_running(gobj)) gobj_start(gobj);
 				} else if (gobj_is_running(gobj)) gobj_stop(gobj);
-				break;
 		}
 	}
 	/***************************************************************
@@ -5826,9 +5915,7 @@
 			case "remote_yuno_role":
 				priv.remote_yuno_role = gobj_read_str_attr(gobj, "remote_yuno_role");
 				break;
-			case "remote_yuno_service":
-				priv.remote_yuno_service = gobj_read_str_attr(gobj, "remote_yuno_service");
-				break;
+			case "remote_yuno_service": priv.remote_yuno_service = gobj_read_str_attr(gobj, "remote_yuno_service");
 		}
 	}
 	/***************************************************************
@@ -6370,12 +6457,13 @@
 			return 0;
 		}
 		let gobj_service = gobj_find_service(iev_dst_service, true);
-		if (gobj_service) if (gobj_has_event(gobj_service, iev_event, event_flag_t.EVF_PUBLIC_EVENT)) gobj_send_event(gobj_service, iev_event, iev_kw, gobj);
-		else {
-			log_error(`${gobj_short_name(gobj)}: Service found but no event or not public, service '${gobj_short_name(gobj_service)}', ev '${iev_event}'`);
-			return -1;
-		}
-		else if (gobj_is_pure_child(gobj)) gobj_send_event(gobj_parent(gobj), iev_event, iev_kw, gobj);
+		if (gobj_service) {
+			if (gobj_has_event(gobj_service, iev_event, event_flag_t.EVF_PUBLIC_EVENT)) gobj_send_event(gobj_service, iev_event, iev_kw, gobj);
+			else {
+				log_error(`${gobj_short_name(gobj)}: Service found but no event or not public, service '${gobj_short_name(gobj_service)}', ev '${iev_event}'`);
+				return -1;
+			}
+		} else if (gobj_is_pure_child(gobj)) gobj_send_event(gobj_parent(gobj), iev_event, iev_kw, gobj);
 		else gobj_publish_event(gobj, iev_event, iev_kw);
 		return 0;
 	}
@@ -6580,6 +6668,7 @@
 	exports.gobj_create_yuno = gobj_create_yuno;
 	exports.gobj_current_state = gobj_current_state;
 	exports.gobj_default_service = gobj_default_service;
+	exports.gobj_deliver_posted_events = gobj_deliver_posted_events;
 	exports.gobj_destroy = gobj_destroy;
 	exports.gobj_find_child = gobj_find_child;
 	exports.gobj_find_gobj = gobj_find_gobj;
@@ -6611,6 +6700,7 @@
 	exports.gobj_pause = gobj_pause;
 	exports.gobj_play = gobj_play;
 	exports.gobj_post_event = gobj_post_event;
+	exports.gobj_posted_events_size = gobj_posted_events_size;
 	exports.gobj_publish_event = gobj_publish_event;
 	exports.gobj_read_attr = gobj_read_attr;
 	exports.gobj_read_attrs = gobj_read_attrs;