From 9f1907242694ff0f086423545e8dd14572c1931f Mon Sep 17 00:00:00 2001
From: Oliver <oliver@noreply.localhost>
Date: Sat, 28 Mar 2026 18:42:11 -0600
Subject: [PATCH] Add a utility method for performing a document update on any
 arbitrary document

---
 module/apps/utils.mjs | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 module/apps/utils.mjs

diff --git a/module/apps/utils.mjs b/module/apps/utils.mjs
new file mode 100644
index 0000000..e2af7d4
--- /dev/null
+++ b/module/apps/utils.mjs
@@ -0,0 +1,32 @@
+/*
+This file contains utility methods used by Applications in order to be
+DRYer
+*/
+
+/**
+ * Updates a document using the UUID, this is most useful for editing
+ * documents from a sheet of another document (e.g. an Item embedded
+ * in an Actor). This requires the dataset of the element to have a
+ * "data-foreign-name" which is the data path of the property being
+ * edited. As well as the input, or a parent of it, to have the
+ * "data-foreign-uuid" attribute, representing the UUID of the document
+ * to edit.
+ */
+export async function updateForeignDocumentFromEvent(event) {
+	const target = event.currentTarget;
+	const name = target.dataset.foreignName;
+	let uuid = target.dataset.foreignUuid;
+	uuid ??= target.closest(`[data-foreign-uuid]`)?.dataset.foreignUuid;
+
+	if (!name || !uuid) {
+		throw `Cannot edit foreign document with the name and UUID`;
+	};
+
+	let value = target.value;
+	switch (target.type) {
+		case `checkbox`: value = target.checked; break;
+	};
+
+	let doc = await fromUuid(uuid);
+	await doc?.update({ [name]: value });
+};