Diff

mod_pubsub_subscription/mod_pubsub_subscription.lua @ 4511:97fac0ba0469

mod_pubsub_subscription: New module providing an API for pubsub subscriptions This lets other modules hook events from local or remote XEP-0060 pubsub services. API allows keeping track of items added, removed or if the whole node gets cleared or even deleted. Requested by MattJ.
author Kim Alvefur <zash@zash.se>
date Mon, 15 Mar 2021 16:31:23 +0100
child 5674:b40750891bee
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_pubsub_subscription/mod_pubsub_subscription.lua	Mon Mar 15 16:31:23 2021 +0100
@@ -0,0 +1,145 @@
+local st = require "util.stanza";
+local uuid = require "util.uuid";
+local mt = require "util.multitable";
+local cache = require "util.cache";
+
+local xmlns_pubsub = "http://jabber.org/protocol/pubsub";
+local xmlns_pubsub_event = "http://jabber.org/protocol/pubsub#event";
+
+-- TODO persist
+-- TODO query known pubsub nodes to sync current subscriptions
+-- TODO subscription ids per 'item' would be handy
+
+local pending_subscription = cache.new(256); -- uuid → node
+local pending_unsubscription = cache.new(256); -- uuid → node
+local active_subscriptions = mt.new() -- service | node | uuid | { item }
+function module.save()
+	return { active_subscriptions = active_subscriptions.data }
+end
+function module.restore(data)
+	if data and data.active_subscriptions then
+		active_subscriptions.data = data.active_subscriptions
+	end
+end
+
+local valid_events = {"subscribed"; "unsubscribed"; "error"; "item"; "retract"; "purge"; "delete"}
+
+local function subscription_added(item_event)
+	local item = item_event.item;
+	assert(item.service, "pubsub subscription item MUST have a 'service' field.");
+	assert(item.node, "pubsub subscription item MUST have a 'node' field.");
+
+	local already_subscibed = false;
+	for _ in active_subscriptions:iter(item.service, item.node, nil) do -- luacheck: ignore 512
+		already_subscibed = true;
+		break
+	end
+
+	item._id = uuid.generate();
+	local iq_id = uuid.generate();
+	pending_subscription:set(iq_id, item._id);
+	active_subscriptions:set(item.service, item.node, item._id, item);
+
+	if not already_subscibed then
+		module:send(st.iq({ type = "set", id = iq_id, from = module.host, to = item.service })
+			:tag("pubsub", { xmlns = xmlns_pubsub })
+				:tag("subscribe", { jid = module.host, node = item.node }));
+	end
+end
+
+for _, event_name in ipairs(valid_events) do
+	module:hook("pubsub-event/host/"..event_name, function (event)
+		for _, _, _, _, cb in active_subscriptions:iter(event.service, event.node, nil, "on_"..event_name) do
+			pcall(cb, event);
+		end
+	end);
+end
+
+module:hook("iq/host", function (event)
+	local stanza = event.stanza;
+	local service = stanza.attr.from;
+
+	if not stanza.attr.id then return end -- shouldn't be possible
+
+	local subscribed_node = pending_subscription:get(stanza.attr.id);
+	pending_subscription:set(stanza.attr.id, nil);
+	local unsubscribed_node = pending_unsubscription:get(stanza.attr.id);
+	pending_unsubscription:set(stanza.attr.id, nil);
+
+	if stanza.attr.type == "result" then
+		local pubsub_wrapper = stanza:get_child("pubsub", xmlns_pubsub);
+		local subscription = pubsub_wrapper and pubsub_wrapper:get_child("subscription");
+		if not subscription then return end
+		local node = subscription.attr.node;
+
+		local what;
+		if subscription.attr.subscription == "subscribed" then
+			what = "on_subscribed";
+		elseif subscription.attr.subscription == "none" then
+			what = "on_unsubscribed";
+		end
+		if not what then return end -- there are other states but we don't handle them
+		for _, _, _, _, cb in active_subscriptions:iter(service, node, nil, what) do
+			cb(event);
+		end
+		return true;
+
+	elseif stanza.attr.type == "error" then
+		local node = subscribed_node or unsubscribed_node;
+		local error_type, error_condition, reason, pubsub_error = stanza:get_error();
+		local err = { type = error_type, condition = error_condition, text = reason, extra = pubsub_error };
+		if active_subscriptions:get(service) then
+			for _, _, _, _, cb in active_subscriptions:iter(service, node, nil, "on_error") do
+				cb(err);
+			end
+			return true;
+		end
+	end
+end, 1);
+
+local function subscription_removed(item_event)
+	local item = item_event.item;
+	active_subscriptions:set(item.service, item.node, item._id, nil);
+	local node_subs = active_subscriptions:get(item.service, item.node);
+	if node_subs and next(node_subs) then return end
+
+	local iq_id = uuid.generate();
+	pending_unsubscription:set(iq_id, item._id);
+
+	module:send(st.iq({ type = "set", id = iq_id, from = module.host, to = item.service })
+		:tag("pubsub", { xmlns = xmlns_pubsub })
+			:tag("unsubscribe", { jid = module.host, node = item.node }))
+end
+
+module:handle_items("pubsub-subscription", subscription_added, subscription_removed, true);
+
+module:hook("message/host", function(event)
+	local origin, stanza = event.origin, event.stanza;
+	local ret = nil;
+	local service = stanza.attr.from;
+	module:log("debug", "Got message/host: %s", stanza:top_tag());
+	for event_container in stanza:childtags("event", xmlns_pubsub_event) do
+		for pubsub_event in event_container:childtags() do
+			module:log("debug", "Got pubsub event %s", pubsub_event:top_tag());
+			local node = pubsub_event.attr.node;
+			module:fire_event("pubsub-event/host/"..pubsub_event.name, {
+					stanza = stanza;
+					origin = origin;
+					event = pubsub_event;
+					service = service;
+					node = node;
+				});
+			ret = true;
+		end
+	end
+	return ret;
+end);
+
+module:hook("pubsub-event/host/items", function (event)
+	for item in event.event:childtags() do
+		module:log("debug", "Got pubsub item event %s", item:top_tag());
+		event.item = item;
+		event.payload = item.tags[1];
+		module:fire_event("pubsub-event/host/"..item.name, event);
+	end
+end);