@yuneta/gobj-ui 7.8.1 → 7.9.1

package/dist/gobj-ui.cjs.js

@@ -14497,6 +14497,7 @@ var attrs_table$6 = [
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_POINTER, "gobj_remote_yuno", 0, null, "Remote yuno for data fetching"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_STRING, "treedb_name", 0, null, "Remote TreeDB service name"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_JSON, "descs", 0, null, "Description of topics"),
+	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_remote_paging", 0, false, "Each topic table pulls its rows a PAGE at a time (`nodes` from/limit) instead of loading the topic whole. Safe against a backend that cannot page: it answers the whole list, which the table reads as one page"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "system", 0, false, "Manage system topics (true) or user topics (false)"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_STRING, "tabs_style", 0, "is-toggle is-fullwidth", "Bulma tab styling"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_cards_landing", 0, false, "Land on a grid of topic cards (list->detail): a card opens its table, with the tabs bar + a back-to-grid button. Off = tabs only (legacy)."),
@@ -15310,7 +15311,8 @@ function process_treedb_descs$1(gobj) {
 			with_delete_button: !readonly,
 			treedb_name,
 			topic_name: key,
-			desc
+			desc,
+			with_remote_paging: (0, _yuneta_gobj_js.gobj_read_bool_attr)(gobj, "with_remote_paging")
 		};
 		let id = `${(0, _yuneta_gobj_js.gobj_name)(gobj)}?${desc.topic_name}`;
 		let gobj_topic_form = (0, _yuneta_gobj_js.gobj_create_service)(id, "C_YUI_TREEDB_TOPIC_WITH_FORM", kw_topic_form, gobj);
@@ -15381,6 +15383,8 @@ function register_sub_routes$1(gobj) {
 function get_nodes$1(gobj, topic_name) {
 	const treedb_name = gobj.priv.treedb_name;
 	subscribe_treedb$1(gobj, topic_name);
+	let gobj_topic_form = get_gobj_formtable(gobj, topic_name);
+	if (gobj_topic_form && (0, _yuneta_gobj_js.gobj_read_bool_attr)(gobj_topic_form, "with_remote_paging")) return;
 	treedb_nodes$1(gobj, treedb_name, topic_name, { list_dict: true });
 }
 /************************************************************
@@ -15428,7 +15432,7 @@ function get_gobj_formtable(gobj, topic_name) {
 /************************************************************
 *  Command to remote service
 ************************************************************/
-function treedb_nodes$1(gobj, treedb_name, topic_name, options) {
+function treedb_nodes$1(gobj, treedb_name, topic_name, options, page) {
 	let command = "nodes";
 	let gobj_remote_yuno = (0, _yuneta_gobj_js.gobj_read_pointer_attr)(gobj, "gobj_remote_yuno");
 	let kw = {
@@ -15438,8 +15442,17 @@ function treedb_nodes$1(gobj, treedb_name, topic_name, options) {
 		options: options || {}
 	};
 	kw.__md_command__ = { topic_name };
+	if (page) {
+		kw.from = page.from;
+		kw.limit = page.limit;
+		kw.__md_command__.req_id = page.req_id;
+	}
 	let ret = (0, _yuneta_gobj_js.gobj_command)(gobj_remote_yuno, command, kw, gobj);
-	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
+	if (ret) {
+		(0, _yuneta_gobj_js.log_error)(ret);
+		return -1;
+	}
+	return 0;
 }
 /************************************************************
 *  Command to remote service
@@ -15673,7 +15686,7 @@ function ac_mt_command_answer$2(gobj, event, kw, src) {
 			yui_shell_show_error(yui_shell_of(gobj), comment, { t: i18next.t });
 			if (command === "update-node" || command === "create-node") {
 				let failed_topic = (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0);
-				if (failed_topic) treedb_nodes$1(gobj, (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"), failed_topic, { list_dict: true });
+				if (failed_topic) (0, _yuneta_gobj_js.gobj_send_event)(gobj, "EV_REFRESH_TOPIC", { topic_name: failed_topic }, gobj);
 			}
 		}
 		return 0;
@@ -15689,7 +15702,15 @@ function ac_mt_command_answer$2(gobj, event, kw, src) {
 			let topic_name = (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", _yuneta_gobj_js.kw_flag_t.KW_REQUIRED);
 			if (result >= 0) {
 				let gobj_topic_form = (0, _yuneta_gobj_js.gobj_find_child)(gobj, { __gobj_name__: `${(0, _yuneta_gobj_js.gobj_name)(gobj)}?${topic_name}` });
-				(0, _yuneta_gobj_js.gobj_send_event)(gobj_topic_form, "EV_LOAD_NODES", nodes_answer(data).rows, gobj);
+				let answer = nodes_answer(data);
+				let req_id = (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "req_id", "", 0);
+				if (req_id) (0, _yuneta_gobj_js.gobj_send_event)(gobj_topic_form, "EV_PAGE_LOADED", {
+					req_id,
+					rows: answer.rows,
+					pages: answer.pages,
+					total: answer.total
+				}, gobj);
+				else (0, _yuneta_gobj_js.gobj_send_event)(gobj_topic_form, "EV_LOAD_NODES", answer.rows, gobj);
 			}
 			break;
 		case "create-node":
@@ -15915,6 +15936,31 @@ function ac_create_record(gobj, event, kw, src) {
 	});
 }
 /********************************************
+*  A topic table wants a page.
+*
+*  The transport is ours, so the table asks and we fetch; the answer
+*  finds its way back by the `req_id` we echo. A backend that cannot
+*  page answers the whole list, which the table takes as one page —
+*  which is the truth, and is why the table can ask without knowing
+*  what it is talking to.
+********************************************/
+function ac_request_page(gobj, event, kw, src) {
+	let topic_name = kw.topic_name || (0, _yuneta_gobj_js.gobj_read_attr)(src, "topic_name");
+	if (!topic_name || !kw.req_id) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: a page request with no topic or no id`);
+		return -1;
+	}
+	if (treedb_nodes$1(gobj, (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"), topic_name, { list_dict: true }, {
+		from: kw.from,
+		limit: kw.limit,
+		req_id: kw.req_id
+	}) < 0) (0, _yuneta_gobj_js.gobj_send_event)(src, "EV_PAGE_FAILED", {
+		req_id: kw.req_id,
+		error: "cannot reach the backend"
+	}, gobj);
+	return 0;
+}
+/********************************************
 *  Event from formtable: ONE field of one record, edited in place.
 *
 *  Written as a PARTIAL update and, deliberately, with NO `autolink`.
@@ -15981,6 +16027,11 @@ function ac_delete_record(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_refresh_topic(gobj, event, kw, src) {
+	let gobj_topic_form = get_gobj_formtable(gobj, kw.topic_name);
+	if (gobj_topic_form && (0, _yuneta_gobj_js.gobj_read_bool_attr)(gobj_topic_form, "with_remote_paging")) {
+		(0, _yuneta_gobj_js.gobj_send_event)(gobj_topic_form, "EV_REPULL_PAGE", {}, gobj);
+		return 0;
+	}
 	treedb_nodes$1(gobj, (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"), kw.topic_name, { list_dict: true });
 	return 0;
 }
@@ -16070,6 +16121,11 @@ function create_gclass$6(gclass_name) {
 			ac_update_field,
 			null
 		],
+		[
+			"EV_REQUEST_PAGE",
+			ac_request_page,
+			null
+		],
 		[
 			"EV_DELETE_RECORD",
 			ac_delete_record,
@@ -16144,6 +16200,7 @@ function create_gclass$6(gclass_name) {
 		["EV_CREATE_RECORD", 0],
 		["EV_UPDATE_RECORD", 0],
 		["EV_UPDATE_FIELD", 0],
+		["EV_REQUEST_PAGE", 0],
 		["EV_DELETE_RECORD", 0],
 		["EV_RECORD_WRITTEN", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT | _yuneta_gobj_js.event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_REFRESH_TOPIC", 0],
@@ -16358,6 +16415,8 @@ var attrs_table$5 = [
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_export_button", 0, true, "Button toolbar EXPORT (download as CSV what the table holds)"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_header_filters", 0, true, "Per-column filter box in the table header, on the columns a text/number match means something (not hooks, fkeys or json)"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_inline_edit", 0, true, "Edit a writable scalar cell in place while in edition mode (the record form keeps the rest)"),
+	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_remote_paging", 0, false, "Pull the topic a PAGE at a time from the backend (`nodes` from/limit) instead of loading it whole. Needs a backend that pages"),
+	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_INTEGER, "page_size", 0, 200, "Rows per page when with_remote_paging. Generous on purpose: a treedb that fits in one page behaves exactly as it did, paginator hidden and every filter seeing every row"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_in_row_edit_icons", 0, true, "Add a last column with internal EDIT/DELETE icon"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "editable", 0, false, "Edit state"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "with_checkbox", 0, true, "Auxiliary first column to select rows"),
@@ -16386,6 +16445,8 @@ var attrs_table$5 = [
 	(0, _yuneta_gobj_js.SDATA_END)()
 ];
 var PRIVATE_DATA$5 = {
+	_pending_pages: null,
+	_page_seq: 0,
 	$container: null,
 	treedb_name: "",
 	topic_name: "",
@@ -17111,6 +17172,25 @@ function create_tabulator(gobj) {
 	let pkey = desc.pkey || "id";
 	let selectable = with_checkbox ? "highlight" : with_radio ? 1 : false;
 	let tabulator_settings = (0, _yuneta_gobj_js.json_deep_copy)((0, _yuneta_gobj_js.gobj_read_attr)(gobj, "tabulator_settings"));
+	if ((0, _yuneta_gobj_js.gobj_read_bool_attr)(gobj, "with_remote_paging")) {
+		let page_size = (0, _yuneta_gobj_js.gobj_read_integer_attr)(gobj, "page_size") || 200;
+		Object.assign(tabulator_settings, {
+			pagination: true,
+			paginationMode: "remote",
+			filterMode: "local",
+			paginationSize: page_size,
+			paginationSizeSelector: [
+				50,
+				100,
+				200,
+				500
+			],
+			ajaxURL: "nodes",
+			ajaxRequestFunc: function(url, config, params) {
+				return request_page(gobj, params.page || 1, params.size || page_size);
+			}
+		});
+	}
 	Object.assign(tabulator_settings, {
 		index: pkey,
 		columns,
@@ -18312,6 +18392,99 @@ function ac_show_schema(gobj, event, kw, src) {
 	return 0;
 }
 /************************************************************
+*  Ask the host for one page and park the promise Tabulator wants.
+*
+*  The transport belongs to the HOST, so the request goes up as an event
+*  and the answer comes back down as one; what lives here is only the
+*  promise, keyed by a correlation id the host echoes.
+*
+*  Rejected right away when there is nobody to ask: a request that can
+*  never be answered would leave the table spinning for ever and leak
+*  one entry per attempt. Same for the watchdog — the link can stay up
+*  and the answer still never land.
+************************************************************/
+var PAGE_TIMEOUT_MS = 2e4;
+function request_page(gobj, page, size) {
+	let priv = gobj.priv;
+	return new Promise(function(resolve, reject) {
+		if (!priv._pending_pages) priv._pending_pages = {};
+		let req_id = `p${++priv._page_seq}`;
+		let timer = window.setTimeout(function() {
+			(0, _yuneta_gobj_js.gobj_send_event)(gobj, "EV_PAGE_TIMEOUT", { req_id }, gobj);
+		}, PAGE_TIMEOUT_MS);
+		priv._pending_pages[req_id] = {
+			resolve,
+			reject,
+			timer
+		};
+		(0, _yuneta_gobj_js.gobj_publish_event)(gobj, "EV_REQUEST_PAGE", {
+			topic_name: (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "topic_name"),
+			req_id,
+			from: (page - 1) * size + 1,
+			limit: size
+		});
+	});
+}
+/************************************************************
+*  Settle a parked page request, however it ended.
+************************************************************/
+function settle_page(gobj, req_id, value, error) {
+	let priv = gobj.priv;
+	let pend = priv._pending_pages ? priv._pending_pages[req_id] : null;
+	if (!pend) return;
+	delete priv._pending_pages[req_id];
+	if (pend.timer) window.clearTimeout(pend.timer);
+	if (error) {
+		pend.reject(new Error(error));
+		return;
+	}
+	pend.resolve(value);
+}
+/************************************************************
+*  Pull the current page again. `replaceData()` re-runs
+*  ajaxRequestFunc for the page the reader is on, so a refresh keeps
+*  their position instead of throwing them back to the first page.
+************************************************************/
+function ac_repull_page(gobj, event, kw, src) {
+	let tabulator = (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "tabulator");
+	if (!tabulator) return 0;
+	try {
+		tabulator.replaceData();
+	} catch (e) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: cannot re-pull the page: ${e}`);
+		return -1;
+	}
+	return 0;
+}
+/************************************************************
+*  The host answered a page.
+************************************************************/
+function ac_page_loaded(gobj, event, kw, src) {
+	settle_page(gobj, kw.req_id, {
+		data: (0, _yuneta_gobj_js.is_array)(kw.rows) ? kw.rows : [],
+		last_page: kw.pages || 1,
+		last_row: typeof kw.total === "number" ? kw.total : 0
+	}, null);
+	return 0;
+}
+/************************************************************
+*  The host could not answer it.
+************************************************************/
+function ac_page_failed(gobj, event, kw, src) {
+	let why = kw && kw.error || "page request failed";
+	(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: ${why}`);
+	settle_page(gobj, kw.req_id, null, why);
+	return 0;
+}
+/************************************************************
+*  Nobody answered in time.
+************************************************************/
+function ac_page_timeout(gobj, event, kw, src) {
+	(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: no answer for page request '${kw.req_id}' in ${PAGE_TIMEOUT_MS}ms`);
+	settle_page(gobj, kw.req_id, null, "page request timed out");
+	return 0;
+}
+/************************************************************
 *  Filter the loaded rows by a term matched against every non-internal
 *  field. `clearFilter()` with no argument drops only THIS filter: the
 *  per-column header filters are a separate layer and survive, so a
@@ -18559,6 +18732,26 @@ function create_gclass$5(gclass_name) {
 			ac_cell_edited,
 			null
 		],
+		[
+			"EV_REPULL_PAGE",
+			ac_repull_page,
+			null
+		],
+		[
+			"EV_PAGE_LOADED",
+			ac_page_loaded,
+			null
+		],
+		[
+			"EV_PAGE_FAILED",
+			ac_page_failed,
+			null
+		],
+		[
+			"EV_PAGE_TIMEOUT",
+			ac_page_timeout,
+			null
+		],
 		[
 			"EV_SEARCH",
 			ac_search,
@@ -18610,7 +18803,12 @@ function create_gclass$5(gclass_name) {
 		["EV_REFRESH", 0],
 		["EV_SHOW_SCHEMA", 0],
 		["EV_CELL_EDITED", 0],
+		["EV_REPULL_PAGE", 0],
+		["EV_PAGE_LOADED", 0],
+		["EV_PAGE_FAILED", 0],
+		["EV_PAGE_TIMEOUT", 0],
 		["EV_UPDATE_FIELD", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
+		["EV_REQUEST_PAGE", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_SEARCH", 0],
 		["EV_OPEN_COLUMNS", 0],
 		["EV_TOGGLE_COLUMN", 0],

package/dist/gobj-ui.es.js

@@ -14492,6 +14492,7 @@ var attrs_table$6 = [
 	SDATA(data_type_t.DTP_POINTER, "gobj_remote_yuno", 0, null, "Remote yuno for data fetching"),
 	SDATA(data_type_t.DTP_STRING, "treedb_name", 0, null, "Remote TreeDB service name"),
 	SDATA(data_type_t.DTP_JSON, "descs", 0, null, "Description of topics"),
+	SDATA(data_type_t.DTP_BOOLEAN, "with_remote_paging", 0, false, "Each topic table pulls its rows a PAGE at a time (`nodes` from/limit) instead of loading the topic whole. Safe against a backend that cannot page: it answers the whole list, which the table reads as one page"),
 	SDATA(data_type_t.DTP_BOOLEAN, "system", 0, false, "Manage system topics (true) or user topics (false)"),
 	SDATA(data_type_t.DTP_STRING, "tabs_style", 0, "is-toggle is-fullwidth", "Bulma tab styling"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_cards_landing", 0, false, "Land on a grid of topic cards (list->detail): a card opens its table, with the tabs bar + a back-to-grid button. Off = tabs only (legacy)."),
@@ -15305,7 +15306,8 @@ function process_treedb_descs$1(gobj) {
 			with_delete_button: !readonly,
 			treedb_name,
 			topic_name: key,
-			desc
+			desc,
+			with_remote_paging: gobj_read_bool_attr(gobj, "with_remote_paging")
 		};
 		let id = `${gobj_name(gobj)}?${desc.topic_name}`;
 		let gobj_topic_form = gobj_create_service(id, "C_YUI_TREEDB_TOPIC_WITH_FORM", kw_topic_form, gobj);
@@ -15376,6 +15378,8 @@ function register_sub_routes$1(gobj) {
 function get_nodes$1(gobj, topic_name) {
 	const treedb_name = gobj.priv.treedb_name;
 	subscribe_treedb$1(gobj, topic_name);
+	let gobj_topic_form = get_gobj_formtable(gobj, topic_name);
+	if (gobj_topic_form && gobj_read_bool_attr(gobj_topic_form, "with_remote_paging")) return;
 	treedb_nodes$1(gobj, treedb_name, topic_name, { list_dict: true });
 }
 /************************************************************
@@ -15423,7 +15427,7 @@ function get_gobj_formtable(gobj, topic_name) {
 /************************************************************
 *  Command to remote service
 ************************************************************/
-function treedb_nodes$1(gobj, treedb_name, topic_name, options) {
+function treedb_nodes$1(gobj, treedb_name, topic_name, options, page) {
 	let command = "nodes";
 	let gobj_remote_yuno = gobj_read_pointer_attr(gobj, "gobj_remote_yuno");
 	let kw = {
@@ -15433,8 +15437,17 @@ function treedb_nodes$1(gobj, treedb_name, topic_name, options) {
 		options: options || {}
 	};
 	kw.__md_command__ = { topic_name };
+	if (page) {
+		kw.from = page.from;
+		kw.limit = page.limit;
+		kw.__md_command__.req_id = page.req_id;
+	}
 	let ret = gobj_command(gobj_remote_yuno, command, kw, gobj);
-	if (ret) log_error(ret);
+	if (ret) {
+		log_error(ret);
+		return -1;
+	}
+	return 0;
 }
 /************************************************************
 *  Command to remote service
@@ -15668,7 +15681,7 @@ function ac_mt_command_answer$2(gobj, event, kw, src) {
 			yui_shell_show_error(yui_shell_of(gobj), comment, { t });
 			if (command === "update-node" || command === "create-node") {
 				let failed_topic = kw_get_str(gobj, kw_command, "topic_name", "", 0);
-				if (failed_topic) treedb_nodes$1(gobj, gobj_read_str_attr(gobj, "treedb_name"), failed_topic, { list_dict: true });
+				if (failed_topic) gobj_send_event(gobj, "EV_REFRESH_TOPIC", { topic_name: failed_topic }, gobj);
 			}
 		}
 		return 0;
@@ -15684,7 +15697,15 @@ function ac_mt_command_answer$2(gobj, event, kw, src) {
 			let topic_name = kw_get_str(gobj, kw_command, "topic_name", "", kw_flag_t.KW_REQUIRED);
 			if (result >= 0) {
 				let gobj_topic_form = gobj_find_child(gobj, { __gobj_name__: `${gobj_name(gobj)}?${topic_name}` });
-				gobj_send_event(gobj_topic_form, "EV_LOAD_NODES", nodes_answer(data).rows, gobj);
+				let answer = nodes_answer(data);
+				let req_id = kw_get_str(gobj, kw_command, "req_id", "", 0);
+				if (req_id) gobj_send_event(gobj_topic_form, "EV_PAGE_LOADED", {
+					req_id,
+					rows: answer.rows,
+					pages: answer.pages,
+					total: answer.total
+				}, gobj);
+				else gobj_send_event(gobj_topic_form, "EV_LOAD_NODES", answer.rows, gobj);
 			}
 			break;
 		case "create-node":
@@ -15910,6 +15931,31 @@ function ac_create_record(gobj, event, kw, src) {
 	});
 }
 /********************************************
+*  A topic table wants a page.
+*
+*  The transport is ours, so the table asks and we fetch; the answer
+*  finds its way back by the `req_id` we echo. A backend that cannot
+*  page answers the whole list, which the table takes as one page —
+*  which is the truth, and is why the table can ask without knowing
+*  what it is talking to.
+********************************************/
+function ac_request_page(gobj, event, kw, src) {
+	let topic_name = kw.topic_name || gobj_read_attr(src, "topic_name");
+	if (!topic_name || !kw.req_id) {
+		log_error(`${gobj_short_name(gobj)}: a page request with no topic or no id`);
+		return -1;
+	}
+	if (treedb_nodes$1(gobj, gobj_read_str_attr(gobj, "treedb_name"), topic_name, { list_dict: true }, {
+		from: kw.from,
+		limit: kw.limit,
+		req_id: kw.req_id
+	}) < 0) gobj_send_event(src, "EV_PAGE_FAILED", {
+		req_id: kw.req_id,
+		error: "cannot reach the backend"
+	}, gobj);
+	return 0;
+}
+/********************************************
 *  Event from formtable: ONE field of one record, edited in place.
 *
 *  Written as a PARTIAL update and, deliberately, with NO `autolink`.
@@ -15976,6 +16022,11 @@ function ac_delete_record(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_refresh_topic(gobj, event, kw, src) {
+	let gobj_topic_form = get_gobj_formtable(gobj, kw.topic_name);
+	if (gobj_topic_form && gobj_read_bool_attr(gobj_topic_form, "with_remote_paging")) {
+		gobj_send_event(gobj_topic_form, "EV_REPULL_PAGE", {}, gobj);
+		return 0;
+	}
 	treedb_nodes$1(gobj, gobj_read_str_attr(gobj, "treedb_name"), kw.topic_name, { list_dict: true });
 	return 0;
 }
@@ -16065,6 +16116,11 @@ function create_gclass$6(gclass_name) {
 			ac_update_field,
 			null
 		],
+		[
+			"EV_REQUEST_PAGE",
+			ac_request_page,
+			null
+		],
 		[
 			"EV_DELETE_RECORD",
 			ac_delete_record,
@@ -16139,6 +16195,7 @@ function create_gclass$6(gclass_name) {
 		["EV_CREATE_RECORD", 0],
 		["EV_UPDATE_RECORD", 0],
 		["EV_UPDATE_FIELD", 0],
+		["EV_REQUEST_PAGE", 0],
 		["EV_DELETE_RECORD", 0],
 		["EV_RECORD_WRITTEN", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_REFRESH_TOPIC", 0],
@@ -16353,6 +16410,8 @@ var attrs_table$5 = [
 	SDATA(data_type_t.DTP_BOOLEAN, "with_export_button", 0, true, "Button toolbar EXPORT (download as CSV what the table holds)"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_header_filters", 0, true, "Per-column filter box in the table header, on the columns a text/number match means something (not hooks, fkeys or json)"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_inline_edit", 0, true, "Edit a writable scalar cell in place while in edition mode (the record form keeps the rest)"),
+	SDATA(data_type_t.DTP_BOOLEAN, "with_remote_paging", 0, false, "Pull the topic a PAGE at a time from the backend (`nodes` from/limit) instead of loading it whole. Needs a backend that pages"),
+	SDATA(data_type_t.DTP_INTEGER, "page_size", 0, 200, "Rows per page when with_remote_paging. Generous on purpose: a treedb that fits in one page behaves exactly as it did, paginator hidden and every filter seeing every row"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_in_row_edit_icons", 0, true, "Add a last column with internal EDIT/DELETE icon"),
 	SDATA(data_type_t.DTP_BOOLEAN, "editable", 0, false, "Edit state"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_checkbox", 0, true, "Auxiliary first column to select rows"),
@@ -16381,6 +16440,8 @@ var attrs_table$5 = [
 	SDATA_END()
 ];
 var PRIVATE_DATA$5 = {
+	_pending_pages: null,
+	_page_seq: 0,
 	$container: null,
 	treedb_name: "",
 	topic_name: "",
@@ -17106,6 +17167,25 @@ function create_tabulator(gobj) {
 	let pkey = desc.pkey || "id";
 	let selectable = with_checkbox ? "highlight" : with_radio ? 1 : false;
 	let tabulator_settings = json_deep_copy(gobj_read_attr(gobj, "tabulator_settings"));
+	if (gobj_read_bool_attr(gobj, "with_remote_paging")) {
+		let page_size = gobj_read_integer_attr(gobj, "page_size") || 200;
+		Object.assign(tabulator_settings, {
+			pagination: true,
+			paginationMode: "remote",
+			filterMode: "local",
+			paginationSize: page_size,
+			paginationSizeSelector: [
+				50,
+				100,
+				200,
+				500
+			],
+			ajaxURL: "nodes",
+			ajaxRequestFunc: function(url, config, params) {
+				return request_page(gobj, params.page || 1, params.size || page_size);
+			}
+		});
+	}
 	Object.assign(tabulator_settings, {
 		index: pkey,
 		columns,
@@ -18307,6 +18387,99 @@ function ac_show_schema(gobj, event, kw, src) {
 	return 0;
 }
 /************************************************************
+*  Ask the host for one page and park the promise Tabulator wants.
+*
+*  The transport belongs to the HOST, so the request goes up as an event
+*  and the answer comes back down as one; what lives here is only the
+*  promise, keyed by a correlation id the host echoes.
+*
+*  Rejected right away when there is nobody to ask: a request that can
+*  never be answered would leave the table spinning for ever and leak
+*  one entry per attempt. Same for the watchdog — the link can stay up
+*  and the answer still never land.
+************************************************************/
+var PAGE_TIMEOUT_MS = 2e4;
+function request_page(gobj, page, size) {
+	let priv = gobj.priv;
+	return new Promise(function(resolve, reject) {
+		if (!priv._pending_pages) priv._pending_pages = {};
+		let req_id = `p${++priv._page_seq}`;
+		let timer = window.setTimeout(function() {
+			gobj_send_event(gobj, "EV_PAGE_TIMEOUT", { req_id }, gobj);
+		}, PAGE_TIMEOUT_MS);
+		priv._pending_pages[req_id] = {
+			resolve,
+			reject,
+			timer
+		};
+		gobj_publish_event(gobj, "EV_REQUEST_PAGE", {
+			topic_name: gobj_read_str_attr(gobj, "topic_name"),
+			req_id,
+			from: (page - 1) * size + 1,
+			limit: size
+		});
+	});
+}
+/************************************************************
+*  Settle a parked page request, however it ended.
+************************************************************/
+function settle_page(gobj, req_id, value, error) {
+	let priv = gobj.priv;
+	let pend = priv._pending_pages ? priv._pending_pages[req_id] : null;
+	if (!pend) return;
+	delete priv._pending_pages[req_id];
+	if (pend.timer) window.clearTimeout(pend.timer);
+	if (error) {
+		pend.reject(new Error(error));
+		return;
+	}
+	pend.resolve(value);
+}
+/************************************************************
+*  Pull the current page again. `replaceData()` re-runs
+*  ajaxRequestFunc for the page the reader is on, so a refresh keeps
+*  their position instead of throwing them back to the first page.
+************************************************************/
+function ac_repull_page(gobj, event, kw, src) {
+	let tabulator = gobj_read_attr(gobj, "tabulator");
+	if (!tabulator) return 0;
+	try {
+		tabulator.replaceData();
+	} catch (e) {
+		log_error(`${gobj_short_name(gobj)}: cannot re-pull the page: ${e}`);
+		return -1;
+	}
+	return 0;
+}
+/************************************************************
+*  The host answered a page.
+************************************************************/
+function ac_page_loaded(gobj, event, kw, src) {
+	settle_page(gobj, kw.req_id, {
+		data: is_array(kw.rows) ? kw.rows : [],
+		last_page: kw.pages || 1,
+		last_row: typeof kw.total === "number" ? kw.total : 0
+	}, null);
+	return 0;
+}
+/************************************************************
+*  The host could not answer it.
+************************************************************/
+function ac_page_failed(gobj, event, kw, src) {
+	let why = kw && kw.error || "page request failed";
+	log_error(`${gobj_short_name(gobj)}: ${why}`);
+	settle_page(gobj, kw.req_id, null, why);
+	return 0;
+}
+/************************************************************
+*  Nobody answered in time.
+************************************************************/
+function ac_page_timeout(gobj, event, kw, src) {
+	log_error(`${gobj_short_name(gobj)}: no answer for page request '${kw.req_id}' in ${PAGE_TIMEOUT_MS}ms`);
+	settle_page(gobj, kw.req_id, null, "page request timed out");
+	return 0;
+}
+/************************************************************
 *  Filter the loaded rows by a term matched against every non-internal
 *  field. `clearFilter()` with no argument drops only THIS filter: the
 *  per-column header filters are a separate layer and survive, so a
@@ -18554,6 +18727,26 @@ function create_gclass$5(gclass_name) {
 			ac_cell_edited,
 			null
 		],
+		[
+			"EV_REPULL_PAGE",
+			ac_repull_page,
+			null
+		],
+		[
+			"EV_PAGE_LOADED",
+			ac_page_loaded,
+			null
+		],
+		[
+			"EV_PAGE_FAILED",
+			ac_page_failed,
+			null
+		],
+		[
+			"EV_PAGE_TIMEOUT",
+			ac_page_timeout,
+			null
+		],
 		[
 			"EV_SEARCH",
 			ac_search,
@@ -18605,7 +18798,12 @@ function create_gclass$5(gclass_name) {
 		["EV_REFRESH", 0],
 		["EV_SHOW_SCHEMA", 0],
 		["EV_CELL_EDITED", 0],
+		["EV_REPULL_PAGE", 0],
+		["EV_PAGE_LOADED", 0],
+		["EV_PAGE_FAILED", 0],
+		["EV_PAGE_TIMEOUT", 0],
 		["EV_UPDATE_FIELD", event_flag_t.EVF_OUTPUT_EVENT],
+		["EV_REQUEST_PAGE", event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_SEARCH", 0],
 		["EV_OPEN_COLUMNS", 0],
 		["EV_TOGGLE_COLUMN", 0],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuneta/gobj-ui",
-  "version": "7.8.1",
+  "version": "7.9.1",
   "type": "module",
   "main": "dist/gobj-ui.cjs.js",
   "module": "dist/gobj-ui.es.js",

package/src/c_yui_treedb_topic_with_form.js

@@ -48,6 +48,7 @@ import {
     gclass_find_by_name,
     gobj_write_attr,
     gobj_read_bool_attr,
+    gobj_read_integer_attr,
     gobj_read_str_attr,
     gobj_write_bool_attr,
     gobj_publish_event,
@@ -112,6 +113,8 @@ SDATA(data_type_t.DTP_BOOLEAN,  "with_columns_button",       0,  true,   "Button
 SDATA(data_type_t.DTP_BOOLEAN,  "with_export_button",        0,  true,   "Button toolbar EXPORT (download as CSV what the table holds)"),
 SDATA(data_type_t.DTP_BOOLEAN,  "with_header_filters",       0,  true,   "Per-column filter box in the table header, on the columns a text/number match means something (not hooks, fkeys or json)"),
 SDATA(data_type_t.DTP_BOOLEAN,  "with_inline_edit",          0,  true,   "Edit a writable scalar cell in place while in edition mode (the record form keeps the rest)"),
+SDATA(data_type_t.DTP_BOOLEAN,  "with_remote_paging",        0,  false,  "Pull the topic a PAGE at a time from the backend (`nodes` from/limit) instead of loading it whole. Needs a backend that pages"),
+SDATA(data_type_t.DTP_INTEGER,  "page_size",                 0,  200,    "Rows per page when with_remote_paging. Generous on purpose: a treedb that fits in one page behaves exactly as it did, paginator hidden and every filter seeing every row"),
 SDATA(data_type_t.DTP_BOOLEAN,  "with_in_row_edit_icons",    0,  true,   "Add a last column with internal EDIT/DELETE icon"),
 
 SDATA(data_type_t.DTP_BOOLEAN,  "editable",             0,  false,  "Edit state"),
@@ -146,6 +149,8 @@ SDATA_END()
 ];
 
 let PRIVATE_DATA = {
+    _pending_pages:     null,       // req_id -> {resolve, reject, timer}
+    _page_seq:          0,          // correlation id of a page request
     $container:         null,
     treedb_name:        "",
     topic_name:         "",
@@ -1095,6 +1100,36 @@ function create_tabulator(gobj)
 
     let tabulator_settings = json_deep_copy(gobj_read_attr(gobj, "tabulator_settings"));
 
+    /*  Remote paging: the TABLE pulls, instead of the host pushing the whole
+     *  topic down. The page size is generous on purpose — a treedb that fits
+     *  in one page behaves exactly as it did before, with the paginator
+     *  hidden and every filter seeing every row. Only a topic that does NOT
+     *  fit pays for paging, and for that one loading it whole was never an
+     *  option anyway.
+     *
+     *  `filterMode: "local"` says the plain truth: the header filters and the
+     *  search box work on the page that is loaded. Same as the tranger
+     *  browser's Rows card, and for the same reason — the alternative is
+     *  pushing every filter to the backend and changing what "search" means.
+     */
+    if(gobj_read_bool_attr(gobj, "with_remote_paging")) {
+        let page_size = gobj_read_integer_attr(gobj, "page_size") || 200;
+        Object.assign(tabulator_settings, {
+            pagination:             true,
+            paginationMode:         "remote",
+            filterMode:             "local",
+            paginationSize:         page_size,
+            paginationSizeSelector: [50, 100, 200, 500],
+            ajaxURL:                "nodes",   /*  dummy: only fires the func  */
+            ajaxRequestFunc: function(url, config, params) {
+                /*  Widget plumbing, not an action: Tabulator wants a PROMISE
+                 *  back — it is a data source. The action is the event this
+                 *  parks on. */
+                return request_page(gobj, params.page || 1, params.size || page_size);
+            }
+        });
+    }
+
     Object.assign(tabulator_settings, {
         index: pkey,
         columns: columns,
@@ -2965,6 +3000,125 @@ function ac_show_schema(gobj, event, kw, src)
     return 0;
 }
 
+/************************************************************
+ *  Ask the host for one page and park the promise Tabulator wants.
+ *
+ *  The transport belongs to the HOST, so the request goes up as an event
+ *  and the answer comes back down as one; what lives here is only the
+ *  promise, keyed by a correlation id the host echoes.
+ *
+ *  Rejected right away when there is nobody to ask: a request that can
+ *  never be answered would leave the table spinning for ever and leak
+ *  one entry per attempt. Same for the watchdog — the link can stay up
+ *  and the answer still never land.
+ ************************************************************/
+const PAGE_TIMEOUT_MS = 20000;
+
+function request_page(gobj, page, size)
+{
+    let priv = gobj.priv;
+
+    return new Promise(function(resolve, reject) {
+        if(!priv._pending_pages) {
+            priv._pending_pages = {};
+        }
+        let req_id = `p${++priv._page_seq}`;
+
+        let timer = window.setTimeout(function() {
+            gobj_send_event(gobj, "EV_PAGE_TIMEOUT", {req_id: req_id}, gobj);
+        }, PAGE_TIMEOUT_MS);
+
+        priv._pending_pages[req_id] = {resolve: resolve, reject: reject, timer: timer};
+
+        gobj_publish_event(
+            gobj,
+            "EV_REQUEST_PAGE",
+            {
+                topic_name: gobj_read_str_attr(gobj, "topic_name"),
+                req_id:     req_id,
+                from:       (page - 1) * size + 1,   /*  `nodes` counts from 1  */
+                limit:      size
+            }
+        );
+    });
+}
+
+/************************************************************
+ *  Settle a parked page request, however it ended.
+ ************************************************************/
+function settle_page(gobj, req_id, value, error)
+{
+    let priv = gobj.priv;
+    let pend = priv._pending_pages? priv._pending_pages[req_id] : null;
+    if(!pend) {
+        return;     /*  already settled: a late answer after a timeout  */
+    }
+    delete priv._pending_pages[req_id];
+    if(pend.timer) {
+        window.clearTimeout(pend.timer);
+    }
+    if(error) {
+        pend.reject(new Error(error));
+        return;
+    }
+    pend.resolve(value);
+}
+
+/************************************************************
+ *  Pull the current page again. `replaceData()` re-runs
+ *  ajaxRequestFunc for the page the reader is on, so a refresh keeps
+ *  their position instead of throwing them back to the first page.
+ ************************************************************/
+function ac_repull_page(gobj, event, kw, src)
+{
+    let tabulator = gobj_read_attr(gobj, "tabulator");
+    if(!tabulator) {
+        return 0;
+    }
+    try {
+        tabulator.replaceData();
+    } catch(e) {
+        log_error(`${gobj_short_name(gobj)}: cannot re-pull the page: ${e}`);
+        return -1;
+    }
+    return 0;
+}
+
+/************************************************************
+ *  The host answered a page.
+ ************************************************************/
+function ac_page_loaded(gobj, event, kw, src)
+{
+    settle_page(gobj, kw.req_id, {
+        data:      is_array(kw.rows)? kw.rows : [],
+        last_page: kw.pages || 1,
+        last_row:  (typeof kw.total === "number")? kw.total : 0
+    }, null);
+    return 0;
+}
+
+/************************************************************
+ *  The host could not answer it.
+ ************************************************************/
+function ac_page_failed(gobj, event, kw, src)
+{
+    let why = (kw && kw.error) || "page request failed";
+    log_error(`${gobj_short_name(gobj)}: ${why}`);
+    settle_page(gobj, kw.req_id, null, why);
+    return 0;
+}
+
+/************************************************************
+ *  Nobody answered in time.
+ ************************************************************/
+function ac_page_timeout(gobj, event, kw, src)
+{
+    log_error(`${gobj_short_name(gobj)}: no answer for page request ` +
+              `'${kw.req_id}' in ${PAGE_TIMEOUT_MS}ms`);
+    settle_page(gobj, kw.req_id, null, "page request timed out");
+    return 0;
+}
+
 /************************************************************
  *  Filter the loaded rows by a term matched against every non-internal
  *  field. `clearFilter()` with no argument drops only THIS filter: the
@@ -3187,6 +3341,10 @@ function create_gclass(gclass_name)
             ["EV_REFRESH",              ac_refresh,            null],
             ["EV_SHOW_SCHEMA",          ac_show_schema,        null],
             ["EV_CELL_EDITED",          ac_cell_edited,        null],
+            ["EV_REPULL_PAGE",          ac_repull_page,        null],
+            ["EV_PAGE_LOADED",          ac_page_loaded,        null],
+            ["EV_PAGE_FAILED",          ac_page_failed,        null],
+            ["EV_PAGE_TIMEOUT",         ac_page_timeout,       null],
             ["EV_SEARCH",               ac_search,             null],
             ["EV_OPEN_COLUMNS",         ac_open_columns,       null],
             ["EV_TOGGLE_COLUMN",        ac_toggle_column,      null],
@@ -3220,7 +3378,12 @@ function create_gclass(gclass_name)
         ["EV_REFRESH",              0],
         ["EV_SHOW_SCHEMA",          0],
         ["EV_CELL_EDITED",          0],
+        ["EV_REPULL_PAGE",          0],
+        ["EV_PAGE_LOADED",          0],
+        ["EV_PAGE_FAILED",          0],
+        ["EV_PAGE_TIMEOUT",         0],
         ["EV_UPDATE_FIELD",         event_flag_t.EVF_OUTPUT_EVENT],
+        ["EV_REQUEST_PAGE",         event_flag_t.EVF_OUTPUT_EVENT],
         ["EV_SEARCH",               0],
         ["EV_OPEN_COLUMNS",         0],
         ["EV_TOGGLE_COLUMN",        0],

package/src/c_yui_treedb_topics.js

@@ -75,6 +75,7 @@ SDATA(data_type_t.DTP_POINTER,  "subscriber",       0,  null,   "Subscriber of o
 SDATA(data_type_t.DTP_POINTER,  "gobj_remote_yuno", 0,  null,   "Remote yuno for data fetching"),
 SDATA(data_type_t.DTP_STRING,   "treedb_name",      0,  null,   "Remote TreeDB service name"),
 SDATA(data_type_t.DTP_JSON,     "descs",            0,  null,   "Description of topics"),
+SDATA(data_type_t.DTP_BOOLEAN,  "with_remote_paging",   0,  false,  "Each topic table pulls its rows a PAGE at a time (`nodes` from/limit) instead of loading the topic whole. Safe against a backend that cannot page: it answers the whole list, which the table reads as one page"),
 SDATA(data_type_t.DTP_BOOLEAN,  "system",           0,  false,  "Manage system topics (true) or user topics (false)"),
 SDATA(data_type_t.DTP_STRING,   "tabs_style",       0,  "is-toggle is-fullwidth", "Bulma tab styling"),
 SDATA(data_type_t.DTP_BOOLEAN,  "with_cards_landing",0, false,  "Land on a grid of topic cards (list->detail): a card opens its table, with the tabs bar + a back-to-grid button. Off = tabs only (legacy)."),
@@ -1037,7 +1038,8 @@ function process_treedb_descs(gobj)
 
             treedb_name: treedb_name,
             topic_name: key,
-            desc: desc
+            desc: desc,
+            with_remote_paging: gobj_read_bool_attr(gobj, "with_remote_paging")
         };
 
         let id = `${gobj_name(gobj)}?${desc.topic_name}`;
@@ -1171,8 +1173,15 @@ function get_nodes(gobj, topic_name)
     subscribe_treedb(gobj, topic_name);
 
     /*
-     *  Get data
+     *  Get data — unless the table pulls its own pages, in which case it has
+     *  already asked (or is about to) and a second whole-topic fetch would be
+     *  the very transfer paging exists to avoid.
      */
+    let gobj_topic_form = get_gobj_formtable(gobj, topic_name);
+    if(gobj_topic_form && gobj_read_bool_attr(gobj_topic_form, "with_remote_paging")) {
+        return;
+    }
+
     treedb_nodes(
         gobj,
         treedb_name,
@@ -1328,7 +1337,7 @@ function get_gobj_formtable(gobj, topic_name)
 /************************************************************
  *  Command to remote service
  ************************************************************/
-function treedb_nodes(gobj, treedb_name, topic_name, options)
+function treedb_nodes(gobj, treedb_name, topic_name, options, page)
 {
     let command = "nodes";
 
@@ -1344,6 +1353,16 @@ function treedb_nodes(gobj, treedb_name, topic_name, options)
         topic_name: topic_name,
     };
 
+    /*  A PAGE, when the table asked for one. `from` is 1-based and a
+     *  backend that does not know these two answers the whole list, which
+     *  nodes_answer() reads as one page — so an old backend degrades to
+     *  exactly what it always did. */
+    if(page) {
+        kw.from = page.from;
+        kw.limit = page.limit;
+        kw.__md_command__.req_id = page.req_id;
+    }
+
     // TODO review msg_iev_write_key(kw, "__topic_name__", topic_name);
 
     let ret = gobj_command(
@@ -1354,7 +1373,9 @@ function treedb_nodes(gobj, treedb_name, topic_name, options)
     );
     if(ret) {
         log_error(ret);
+        return -1;
     }
+    return 0;
 }
 
 /************************************************************
@@ -1749,8 +1770,8 @@ function ac_mt_command_answer(gobj, event, kw, src)
             if(command === "update-node" || command === "create-node") {
                 let failed_topic = kw_get_str(gobj, kw_command, "topic_name", "", 0);
                 if(failed_topic) {
-                    treedb_nodes(gobj, gobj_read_str_attr(gobj, "treedb_name"),
-                                 failed_topic, {list_dict: true});
+                    gobj_send_event(gobj, "EV_REFRESH_TOPIC",
+                        {topic_name: failed_topic}, gobj);
                 }
             }
         }
@@ -1778,13 +1799,38 @@ function ac_mt_command_answer(gobj, event, kw, src)
                  *  answers the plain list whatever is asked of it. Reading
                  *  the shape rather than assuming it is what keeps the table
                  *  from rendering an object's keys as rows the day a backend
-                 *  upgrades. */
-                gobj_send_event(
-                    gobj_topic_form,
-                    "EV_LOAD_NODES",
-                    nodes_answer(data).rows,
-                    gobj
-                );
+                 *  upgrades — and it is what lets a paging table survive a
+                 *  backend that cannot page: the whole list arrives as one
+                 *  page, which is the truth. */
+                let answer = nodes_answer(data);
+                /*  The correlation id rides in `__md_command__`, which is the
+                 *  same place `topic_name` rides — and `kw_command` IS that
+                 *  object: C_IEVENT_CLI EXTRACTS `__md_command__` from the kw
+                 *  and pushes it as the command stack's `kw`. So it is read
+                 *  flat, one level up from where the sent kw put it, and it
+                 *  never travels to the backend as a parameter it does not
+                 *  know. */
+                let req_id = kw_get_str(gobj, kw_command, "req_id", "", 0);
+                if(req_id) {
+                    gobj_send_event(
+                        gobj_topic_form,
+                        "EV_PAGE_LOADED",
+                        {
+                            req_id: req_id,
+                            rows:   answer.rows,
+                            pages:  answer.pages,
+                            total:  answer.total
+                        },
+                        gobj
+                    );
+                } else {
+                    gobj_send_event(
+                        gobj_topic_form,
+                        "EV_LOAD_NODES",
+                        answer.rows,
+                        gobj
+                    );
+                }
             }
             break;
 
@@ -2147,6 +2193,40 @@ function ac_create_record(gobj, event, kw, src)
     );
 }
 
+/********************************************
+ *  A topic table wants a page.
+ *
+ *  The transport is ours, so the table asks and we fetch; the answer
+ *  finds its way back by the `req_id` we echo. A backend that cannot
+ *  page answers the whole list, which the table takes as one page —
+ *  which is the truth, and is why the table can ask without knowing
+ *  what it is talking to.
+ ********************************************/
+function ac_request_page(gobj, event, kw, src)
+{
+    let topic_name = kw.topic_name || gobj_read_attr(src, "topic_name");
+    if(!topic_name || !kw.req_id) {
+        log_error(`${gobj_short_name(gobj)}: a page request with no topic or no id`);
+        return -1;
+    }
+
+    let ret = treedb_nodes(
+        gobj,
+        gobj_read_str_attr(gobj, "treedb_name"),
+        topic_name,
+        {list_dict: true},
+        {from: kw.from, limit: kw.limit, req_id: kw.req_id}
+    );
+
+    if(ret < 0) {
+        /*  The command never went out, so no answer will ever come: tell the
+         *  table now instead of leaving it spinning until its watchdog. */
+        gobj_send_event(src, "EV_PAGE_FAILED",
+            {req_id: kw.req_id, error: "cannot reach the backend"}, gobj);
+    }
+    return 0;
+}
+
 /********************************************
  *  Event from formtable: ONE field of one record, edited in place.
  *
@@ -2256,6 +2336,14 @@ function ac_delete_record(gobj, event, kw, src)
  ********************************************/
 function ac_refresh_topic(gobj, event, kw, src)
 {
+    let gobj_topic_form = get_gobj_formtable(gobj, kw.topic_name);
+    if(gobj_topic_form && gobj_read_bool_attr(gobj_topic_form, "with_remote_paging")) {
+        /*  A table that pulls refreshes by pulling: pushing a whole topic
+         *  into a paged table would replace its page with everything. */
+        gobj_send_event(gobj_topic_form, "EV_REPULL_PAGE", {}, gobj);
+        return 0;
+    }
+
     let options = {
         list_dict: true
     };
@@ -2357,6 +2445,7 @@ function create_gclass(gclass_name)
             ["EV_CREATE_RECORD",        ac_create_record,           null],
             ["EV_UPDATE_RECORD",        ac_update_record,           null],
             ["EV_UPDATE_FIELD",         ac_update_field,            null],
+            ["EV_REQUEST_PAGE",         ac_request_page,            null],
             ["EV_DELETE_RECORD",        ac_delete_record,           null],
             ["EV_REFRESH_TOPIC",        ac_refresh_topic,           null],
             ["EV_OPEN_JSON",            ac_open_json,               null],
@@ -2384,6 +2473,7 @@ function create_gclass(gclass_name)
         ["EV_CREATE_RECORD",        0],
         ["EV_UPDATE_RECORD",        0],
         ["EV_UPDATE_FIELD",         0],
+        ["EV_REQUEST_PAGE",         0],
         ["EV_DELETE_RECORD",        0],
         ["EV_RECORD_WRITTEN",       event_flag_t.EVF_OUTPUT_EVENT|
                                     event_flag_t.EVF_NO_WARN_SUBS],