@yuneta/gobj-js 7.9.11 → 7.12.0

package/dist/gobj-js.cjs.js

@@ -87,9 +87,7 @@ function sprintf_format(parse_tree, argv) {
 			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 {
@@ -777,9 +775,7 @@ function set_default(gobj, sdata, it) {
 			}
 			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}`);
@@ -849,9 +845,7 @@ function json2item(gobj, sdata, it, jn_value_) {
 				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;
@@ -1130,6 +1124,7 @@ function gclass_find_by_name(gclass_name, verbose) {
 	} catch (e) {}
 	if (!gclass) {
 		if (verbose) log_error(`gclass not found: ${gclass_name}`);
+		return null;
 	}
 	return gclass;
 }
@@ -1154,8 +1149,8 @@ function gobj_default_service() {
 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;
@@ -1415,6 +1410,7 @@ function gobj_destroy(gobj) {
 		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);
@@ -1570,12 +1566,14 @@ function gobj_play(gobj) {
 		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;
@@ -2354,13 +2352,97 @@ function gobj_has_output_event(gobj, event, event_flag) {
 	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
@@ -2596,7 +2678,7 @@ function gobj_subscribe_event(publisher, event, kw, subscriber) {
 		log_error(`subscriber NULL: ev ${event}`);
 		return 0;
 	}
-	const IGNORED_KEYS = new Set([
+	const IGNORED_KEYS = /* @__PURE__ */ new Set([
 		"__config__",
 		"__global__",
 		"__local__",
@@ -2652,7 +2734,7 @@ function gobj_unsubscribe_event(publisher, event, kw, subscriber) {
 		log_error(`subscriber NULL: ev ${event}`);
 		return 0;
 	}
-	const IGNORED_KEYS = new Set([
+	const IGNORED_KEYS = /* @__PURE__ */ new Set([
 		"__config__",
 		"__global__",
 		"__local__",
@@ -2846,9 +2928,10 @@ function gobj_command(gobj, command, kw, src) {
 		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
@@ -2955,22 +3038,26 @@ function format_log(format) {
 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);
 }
@@ -4006,10 +4093,12 @@ function list2options(list, field_id, field_value) {
 				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];
@@ -4325,13 +4414,15 @@ function jdb_update(jdb, topic_name, path, kw) {
 		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;
 }
@@ -4357,13 +4448,15 @@ function jdb_delete(jdb, topic_name, path, kw) {
 		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;
 }
@@ -5090,41 +5183,42 @@ function treedb_hook_data_size(value) {
 *      }
 ************************************************************/
 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
@@ -5166,38 +5260,39 @@ function treedb_encoder_fkey(col, fkey) {
 *      }
 ********************************************/
 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
 	};
@@ -5303,9 +5398,7 @@ function treedb_get_field_desc(col) {
 				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) {
@@ -5318,9 +5411,7 @@ function treedb_get_field_desc(col) {
 			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;
@@ -5357,9 +5448,7 @@ function template_get_field_desc(key, value) {
 				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";
@@ -5383,7 +5472,8 @@ function create_template_record(template, kw) {
 	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;
 }
@@ -5464,7 +5554,6 @@ function mt_writing$2(gobj, path) {
 			if (priv.msec > 0) {
 				if (!gobj_is_running(gobj)) gobj_start(gobj);
 			} else if (gobj_is_running(gobj)) gobj_stop(gobj);
-			break;
 	}
 }
 /***************************************************************
@@ -5823,9 +5912,7 @@ function mt_writing(gobj, path) {
 		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");
 	}
 }
 /***************************************************************
@@ -6367,12 +6454,13 @@ function ac_on_message(gobj, event, kw, src) {
 		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;
 }
@@ -6577,6 +6665,7 @@ exports.gobj_create_volatil = gobj_create_volatil;
 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;
@@ -6608,6 +6697,7 @@ exports.gobj_parent = gobj_parent;
 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;