@conduction/nextcloud-vue 2.80.0 → 2.81.0

package/dist/esm/utils/userGroupsPeek.js

@@ -0,0 +1,91 @@
+import { reactive } from 'vue';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The synchronous, reactive read of the current user's group ids, without
+ * the request that loads them.
+ *
+ * `resolveFilterTokens` (and through it `visibleWhen`) needs the groups for
+ * `@myGroups`, and those utilities are used on public, signed-out pages too.
+ * Importing `widgetVisibility.js` statically pulled `@nextcloud/axios` and
+ * `@nextcloud/router` into every bundle that resolves a filter token: a public
+ * site bundle broke its size budget, and node specs crashed because axios
+ * reads the request token when it is imported. This module imports no
+ * `@nextcloud/*` package. It loads `widgetVisibility.js` lazily, only the
+ * first time a signed-in user's groups are actually peeked.
+ *
+ * @module utils/userGroupsPeek
+ */
+
+
+/**
+ * Reactive mirror of the group cache, keyed by user id. A computed that reads
+ * a missing key tracks it, so it re-runs when the groups arrive.
+ *
+ * @type {{ byUser: Record<string, string[]> }}
+ */
+const _peek = reactive({ byUser: {} });
+
+/** User ids whose groups a peek already asked for (not reactive on purpose). */
+const _peekRequested = new Set();
+
+/**
+ * Get the current Nextcloud user ID from OC.currentUser.
+ *
+ * @return {string|null} The current user ID, or null if not logged in
+ */
+function getCurrentUserId() {
+	return window.OC?.currentUser?.uid
+		|| window.OC?.currentUser
+		|| null
+}
+
+/**
+ * Synchronous, reactive read of the current user's group ids, for code that
+ * cannot await (the `@myGroups` filter token). Returns the ids once they are
+ * loaded, `null` while the first request is in flight (and starts that
+ * request on first use), and `[]` when nobody is signed in. Read inside a
+ * computed, the computed re-runs when the groups arrive.
+ *
+ * @spec openspec/changes/nextcloud-group-surfaces/specs/schema-utilities/spec.md#requirement-mygroups-resolves-to-the-current-users-group-ids
+ * @return {string[]|null} The group ids, or null while loading.
+ */
+function peekCurrentUserGroups() {
+	const userId = getCurrentUserId();
+	if (!userId) {
+		return []
+	}
+	const known = _peek.byUser[userId];
+	if (Array.isArray(known)) {
+		return known
+	}
+	if (!_peekRequested.has(userId)) {
+		_peekRequested.add(userId);
+		import('./widgetVisibility.js')
+			.then((module) => module.getCurrentUserGroups())
+			.then((groups) => {
+				_peek.byUser[userId] = Array.isArray(groups) ? [...groups] : [];
+			})
+			.catch(() => {
+				_peek.byUser[userId] = [];
+			});
+	}
+	return null
+}
+
+/**
+ * Forget every peeked group list. `resetVisibilityCache()` calls this.
+ *
+ * @spec exclude test helper behind resetVisibilityCache, no behaviour of its own
+ */
+function resetGroupsPeek() {
+	_peekRequested.clear();
+	for (const key of Object.keys(_peek.byUser)) {
+		delete _peek.byUser[key];
+	}
+}
+
+export { getCurrentUserId, peekCurrentUserGroups, resetGroupsPeek };
+//# sourceMappingURL=userGroupsPeek.js.map

package/dist/esm/utils/userGroupsPeek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userGroupsPeek.js","sources":["../../../src/utils/userGroupsPeek.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * The synchronous, reactive read of the current user's group ids, without\n * the request that loads them.\n *\n * `resolveFilterTokens` (and through it `visibleWhen`) needs the groups for\n * `@myGroups`, and those utilities are used on public, signed-out pages too.\n * Importing `widgetVisibility.js` statically pulled `@nextcloud/axios` and\n * `@nextcloud/router` into every bundle that resolves a filter token: a public\n * site bundle broke its size budget, and node specs crashed because axios\n * reads the request token when it is imported. This module imports no\n * `@nextcloud/*` package. It loads `widgetVisibility.js` lazily, only the\n * first time a signed-in user's groups are actually peeked.\n *\n * @module utils/userGroupsPeek\n */\n\nimport { reactive } from 'vue'\n\n/**\n * Reactive mirror of the group cache, keyed by user id. A computed that reads\n * a missing key tracks it, so it re-runs when the groups arrive.\n *\n * @type {{ byUser: Record<string, string[]> }}\n */\nconst _peek = reactive({ byUser: {} })\n\n/** User ids whose groups a peek already asked for (not reactive on purpose). */\nconst _peekRequested = new Set()\n\n/**\n * Get the current Nextcloud user ID from OC.currentUser.\n *\n * @return {string|null} The current user ID, or null if not logged in\n */\nexport function getCurrentUserId() {\n\treturn window.OC?.currentUser?.uid\n\t\t|| window.OC?.currentUser\n\t\t|| null\n}\n\n/**\n * Synchronous, reactive read of the current user's group ids, for code that\n * cannot await (the `@myGroups` filter token). Returns the ids once they are\n * loaded, `null` while the first request is in flight (and starts that\n * request on first use), and `[]` when nobody is signed in. Read inside a\n * computed, the computed re-runs when the groups arrive.\n *\n * @spec openspec/changes/nextcloud-group-surfaces/specs/schema-utilities/spec.md#requirement-mygroups-resolves-to-the-current-users-group-ids\n * @return {string[]|null} The group ids, or null while loading.\n */\nexport function peekCurrentUserGroups() {\n\tconst userId = getCurrentUserId()\n\tif (!userId) {\n\t\treturn []\n\t}\n\tconst known = _peek.byUser[userId]\n\tif (Array.isArray(known)) {\n\t\treturn known\n\t}\n\tif (!_peekRequested.has(userId)) {\n\t\t_peekRequested.add(userId)\n\t\timport('./widgetVisibility.js')\n\t\t\t.then((module) => module.getCurrentUserGroups())\n\t\t\t.then((groups) => {\n\t\t\t\t_peek.byUser[userId] = Array.isArray(groups) ? [...groups] : []\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\t_peek.byUser[userId] = []\n\t\t\t})\n\t}\n\treturn null\n}\n\n/**\n * Forget every peeked group list. `resetVisibilityCache()` calls this.\n *\n * @spec exclude test helper behind resetVisibilityCache, no behaviour of its own\n */\nexport function resetGroupsPeek() {\n\t_peekRequested.clear()\n\tfor (const key of Object.keys(_peek.byUser)) {\n\t\tdelete _peek.byUser[key]\n\t}\n}\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAC;AACtC;AACA;AACA,MAAM,cAAc,GAAG,IAAI,GAAG,GAAE;AAChC;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,GAAG;AACnC,CAAC,OAAO,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG;AACnC,KAAK,MAAM,CAAC,EAAE,EAAE,WAAW;AAC3B,KAAK,IAAI;AACT,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,qBAAqB,GAAG;AACxC,CAAC,MAAM,MAAM,GAAG,gBAAgB,GAAE;AAClC,CAAC,IAAI,CAAC,MAAM,EAAE;AACd,EAAE,OAAO,EAAE;AACX,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAC;AACnC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AAC3B,EAAE,OAAO,KAAK;AACd,EAAE;AACF,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;AAClC,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,EAAC;AAC5B,EAAE,OAAO,uBAAuB,CAAC;AACjC,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,oBAAoB,EAAE,CAAC;AACnD,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK;AACrB,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,GAAE;AACnE,IAAI,CAAC;AACL,IAAI,KAAK,CAAC,MAAM;AAChB,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAE;AAC7B,IAAI,EAAC;AACL,EAAE;AACF,CAAC,OAAO,IAAI;AACZ,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,eAAe,GAAG;AAClC,CAAC,cAAc,CAAC,KAAK,GAAE;AACvB,CAAC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;AAC9C,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,EAAC;AAC1B,EAAE;AACF;;;;"}