@conduction/nextcloud-vue 2.102.0 → 2.104.0

package/dist/esm/utils/nextcloudDirectory.js

@@ -65,6 +65,23 @@ async function fetchGroupMembers(axios, groupId) {
 	return Array.isArray(users) ? users : Object.values(users)
 }
 
+/**
+ * Every user the reader may list, with their details: all users for an
+ * admin, the users of their groups for a sub-admin. Refused for others.
+ *
+ * @param {object} axios The axios instance.
+ * @param {{limit?: number}} [options] How many to read.
+ * @return {Promise<Array<object>>} Nextcloud's user details, one per user.
+ */
+async function fetchUsers(axios, options = {}) {
+	const res = await axios.get(generateOcsUrl('cloud/users/details'), {
+		params: { limit: options.limit || 500, format: 'json' },
+		headers: OCS_HEADERS,
+	});
+	const users = (ocsData(res) && ocsData(res).users) || {};
+	return Array.isArray(users) ? users : Object.values(users)
+}
+
 /**
  * Whether a user is in today: an out-of-office period that runs now (the
  * dav app's absence, Nextcloud 28 and later), else their user status.
@@ -117,5 +134,5 @@ async function fetchStatuses(axios) {
 	}
 }
 
-export { fetchGroupMembers, fetchGroups, fetchPresence, fetchStatuses };
+export { fetchGroupMembers, fetchGroups, fetchPresence, fetchStatuses, fetchUsers };
 //# sourceMappingURL=nextcloudDirectory.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"nextcloudDirectory.js","sources":["../../../src/utils/nextcloudDirectory.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\nimport { generateOcsUrl } from '@nextcloud/router'\n\n/**\n * Nextcloud's own directory: groups, the users in a group, and whether a\n * user is in today. Read through the OCS API with the reader's session, so\n * Nextcloud decides what the reader may see (listing a group's members needs\n * an admin or the group's sub-admin).\n *\n * @module utils/nextcloudDirectory\n */\n\nconst OCS_HEADERS = { 'OCS-APIRequest': 'true' }\n\n/**\n * The `ocs.data` of an OCS response, or null.\n *\n * @param {object} res An axios response.\n * @return {object|null}\n */\nfunction ocsData(res) {\n\treturn (res && res.data && res.data.ocs && res.data.ocs.data) || null\n}\n\n/**\n * The groups, with their member counts.\n *\n * @param {object} axios The axios instance.\n * @param {{search?: string, limit?: number}} [options] Narrowing.\n * @return {Promise<Array<{id: string, name: string, count: number}>>}\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchGroups(axios, options = {}) {\n\tconst res = await axios.get(generateOcsUrl('cloud/groups/details'), {\n\t\tparams: { search: options.search || '', limit: options.limit || 200, format: 'json' },\n\t\theaders: OCS_HEADERS,\n\t})\n\tconst groups = (ocsData(res) && ocsData(res).groups) || []\n\treturn groups.map((group) => ({\n\t\tid: String(group.id),\n\t\tname: group.displayname || String(group.id),\n\t\tcount: Number(group.usercount) || 0,\n\t}))\n}\n\n/**\n * The members of one group, with their details.\n *\n * @param {object} axios The axios instance.\n * @param {string} groupId The group id.\n * @return {Promise<Array<object>>} Nextcloud's user details, one per member.\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchGroupMembers(axios, groupId) {\n\tconst res = await axios.get(generateOcsUrl('cloud/groups/{groupId}/users/details', { groupId }), {\n\t\tparams: { format: 'json' },\n\t\theaders: OCS_HEADERS,\n\t})\n\tconst users = (ocsData(res) && ocsData(res).users) || {}\n\treturn Array.isArray(users) ? users : Object.values(users)\n}\n\n/**\n * Whether a user is in today: an out-of-office period that runs now (the\n * dav app's absence, Nextcloud 28 and later), else their user status.\n *\n * @param {object} axios The axios instance.\n * @param {string} userId The user id.\n * @param {object|null} status The user's entry from the user status list, or null.\n * @return {Promise<{state: string, until: (string|null), message: string}>}\n *   `state` is `absent` (with `until`, an ISO date), `away`, `present` or `unknown`.\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchPresence(axios, userId, status) {\n\ttry {\n\t\tconst res = await axios.get(generateOcsUrl('apps/dav/api/v1/outOfOffice/{userId}/now', { userId }), { params: { format: 'json' }, headers: OCS_HEADERS })\n\t\tconst ooo = ocsData(res)\n\t\tif (ooo && ooo.endDate) {\n\t\t\tconst end = typeof ooo.endDate === 'number' ? new Date(ooo.endDate * 1000) : new Date(ooo.endDate)\n\t\t\treturn { state: 'absent', until: Number.isNaN(end.getTime()) ? null : end.toISOString().slice(0, 10), message: ooo.shortMessage || '' }\n\t\t}\n\t} catch {\n\t\t// 404: no absence now, or an instance without the absence API.\n\t}\n\tif (status && typeof status === 'object') {\n\t\tconst message = typeof status.message === 'string' ? status.message : ''\n\t\tif (status.status === 'online') {\n\t\t\treturn { state: 'present', until: null, message }\n\t\t}\n\t\tif (status.status === 'away' || status.status === 'dnd') {\n\t\t\treturn { state: 'away', until: null, message }\n\t\t}\n\t}\n\treturn { state: 'unknown', until: null, message: '' }\n}\n\n/**\n * The user statuses Nextcloud shares with the reader, by user id. Empty when\n * the user status app is off.\n *\n * @param {object} axios The axios instance.\n * @return {Promise<Record<string, object>>}\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchStatuses(axios) {\n\ttry {\n\t\tconst res = await axios.get(generateOcsUrl('apps/user_status/api/v1/statuses'), { params: { limit: 500, format: 'json' }, headers: OCS_HEADERS })\n\t\tconst list = ocsData(res) || []\n\t\treturn Object.fromEntries((Array.isArray(list) ? list : []).map((entry) => [entry.userId, entry]))\n\t} catch {\n\t\treturn {}\n\t}\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"nextcloudDirectory.js","sources":["../../../src/utils/nextcloudDirectory.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\nimport { generateOcsUrl } from '@nextcloud/router'\n\n/**\n * Nextcloud's own directory: groups, the users in a group, and whether a\n * user is in today. Read through the OCS API with the reader's session, so\n * Nextcloud decides what the reader may see (listing a group's members needs\n * an admin or the group's sub-admin).\n *\n * @module utils/nextcloudDirectory\n */\n\nconst OCS_HEADERS = { 'OCS-APIRequest': 'true' }\n\n/**\n * The `ocs.data` of an OCS response, or null.\n *\n * @param {object} res An axios response.\n * @return {object|null}\n */\nfunction ocsData(res) {\n\treturn (res && res.data && res.data.ocs && res.data.ocs.data) || null\n}\n\n/**\n * The groups, with their member counts.\n *\n * @param {object} axios The axios instance.\n * @param {{search?: string, limit?: number}} [options] Narrowing.\n * @return {Promise<Array<{id: string, name: string, count: number}>>}\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchGroups(axios, options = {}) {\n\tconst res = await axios.get(generateOcsUrl('cloud/groups/details'), {\n\t\tparams: { search: options.search || '', limit: options.limit || 200, format: 'json' },\n\t\theaders: OCS_HEADERS,\n\t})\n\tconst groups = (ocsData(res) && ocsData(res).groups) || []\n\treturn groups.map((group) => ({\n\t\tid: String(group.id),\n\t\tname: group.displayname || String(group.id),\n\t\tcount: Number(group.usercount) || 0,\n\t}))\n}\n\n/**\n * The members of one group, with their details.\n *\n * @param {object} axios The axios instance.\n * @param {string} groupId The group id.\n * @return {Promise<Array<object>>} Nextcloud's user details, one per member.\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchGroupMembers(axios, groupId) {\n\tconst res = await axios.get(generateOcsUrl('cloud/groups/{groupId}/users/details', { groupId }), {\n\t\tparams: { format: 'json' },\n\t\theaders: OCS_HEADERS,\n\t})\n\tconst users = (ocsData(res) && ocsData(res).users) || {}\n\treturn Array.isArray(users) ? users : Object.values(users)\n}\n\n/**\n * Every user the reader may list, with their details: all users for an\n * admin, the users of their groups for a sub-admin. Refused for others.\n *\n * @param {object} axios The axios instance.\n * @param {{limit?: number}} [options] How many to read.\n * @return {Promise<Array<object>>} Nextcloud's user details, one per user.\n */\nexport async function fetchUsers(axios, options = {}) {\n\tconst res = await axios.get(generateOcsUrl('cloud/users/details'), {\n\t\tparams: { limit: options.limit || 500, format: 'json' },\n\t\theaders: OCS_HEADERS,\n\t})\n\tconst users = (ocsData(res) && ocsData(res).users) || {}\n\treturn Array.isArray(users) ? users : Object.values(users)\n}\n\n/**\n * Whether a user is in today: an out-of-office period that runs now (the\n * dav app's absence, Nextcloud 28 and later), else their user status.\n *\n * @param {object} axios The axios instance.\n * @param {string} userId The user id.\n * @param {object|null} status The user's entry from the user status list, or null.\n * @return {Promise<{state: string, until: (string|null), message: string}>}\n *   `state` is `absent` (with `until`, an ISO date), `away`, `present` or `unknown`.\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchPresence(axios, userId, status) {\n\ttry {\n\t\tconst res = await axios.get(generateOcsUrl('apps/dav/api/v1/outOfOffice/{userId}/now', { userId }), { params: { format: 'json' }, headers: OCS_HEADERS })\n\t\tconst ooo = ocsData(res)\n\t\tif (ooo && ooo.endDate) {\n\t\t\tconst end = typeof ooo.endDate === 'number' ? new Date(ooo.endDate * 1000) : new Date(ooo.endDate)\n\t\t\treturn { state: 'absent', until: Number.isNaN(end.getTime()) ? null : end.toISOString().slice(0, 10), message: ooo.shortMessage || '' }\n\t\t}\n\t} catch {\n\t\t// 404: no absence now, or an instance without the absence API.\n\t}\n\tif (status && typeof status === 'object') {\n\t\tconst message = typeof status.message === 'string' ? status.message : ''\n\t\tif (status.status === 'online') {\n\t\t\treturn { state: 'present', until: null, message }\n\t\t}\n\t\tif (status.status === 'away' || status.status === 'dnd') {\n\t\t\treturn { state: 'away', until: null, message }\n\t\t}\n\t}\n\treturn { state: 'unknown', until: null, message: '' }\n}\n\n/**\n * The user statuses Nextcloud shares with the reader, by user id. Empty when\n * the user status app is off.\n *\n * @param {object} axios The axios instance.\n * @return {Promise<Record<string, object>>}\n * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members\n */\nexport async function fetchStatuses(axios) {\n\ttry {\n\t\tconst res = await axios.get(generateOcsUrl('apps/user_status/api/v1/statuses'), { params: { limit: 500, format: 'json' }, headers: OCS_HEADERS })\n\t\tconst list = ocsData(res) || []\n\t\treturn Object.fromEntries((Array.isArray(list) ? list : []).map((entry) => [entry.userId, entry]))\n\t} catch {\n\t\treturn {}\n\t}\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/sortOrder.js

@@ -0,0 +1,61 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+
+/**
+ * Read an order a manifest writes into the `[{ key, order }]` list a self-fetch
+ * index page sorts by. Accepted forms:
+ *
+ * - `"title"` ascending, `"-createdAt"` descending, `"priority:desc"`;
+ * - several of those, comma separated, in priority order (`"-priority,title"`);
+ * - an OpenRegister `_order` map, `{ "priority": "desc", "title": "asc" }`;
+ * - a `[{ key, order? }]` list.
+ *
+ * @param {string|object|Array|null|undefined} value The order.
+ * @return {Array<{key: string, order: 'asc'|'desc'}>} The sort keys, possibly empty.
+ */
+function orderToSortKeys(value) {
+	const direction = (order) => (String(order || '').toLowerCase() === 'desc' ? 'desc' : 'asc');
+	if (Array.isArray(value)) {
+		return value
+			.filter((entry) => entry && typeof entry.key === 'string' && entry.key !== '')
+			.map((entry) => ({ key: entry.key, order: direction(entry.order) }))
+	}
+	if (value && typeof value === 'object') {
+		return Object.entries(value)
+			.filter(([key]) => key !== '')
+			.map(([key, order]) => ({ key, order: direction(order) }))
+	}
+	if (typeof value !== 'string') {
+		return []
+	}
+	return value.split(',')
+		.map((part) => part.trim())
+		.filter(Boolean)
+		.map((part) => {
+			if (part.startsWith('-')) {
+				return { key: part.slice(1), order: 'desc' }
+			}
+			const [key, order] = part.split(':');
+			return { key, order: direction(order) }
+		})
+		.filter((entry) => entry.key !== '')
+}
+
+/**
+ * Whether two sort key lists order the same way.
+ *
+ * @param {Array<{key: string, order: string}>} a One list.
+ * @param {Array<{key: string, order: string}>} b The other.
+ * @return {boolean} True when they name the same keys, directions and priority.
+ */
+function sameSortKeys(a, b) {
+	const left = Array.isArray(a) ? a : [];
+	const right = Array.isArray(b) ? b : [];
+	return left.length === right.length
+		&& left.every((entry, index) => entry.key === right[index].key && (entry.order || 'asc') === (right[index].order || 'asc'))
+}
+
+export { orderToSortKeys, sameSortKeys };
+//# sourceMappingURL=sortOrder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sortOrder.js","sources":["../../../src/utils/sortOrder.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\n/**\n * Read an order a manifest writes into the `[{ key, order }]` list a self-fetch\n * index page sorts by. Accepted forms:\n *\n * - `\"title\"` ascending, `\"-createdAt\"` descending, `\"priority:desc\"`;\n * - several of those, comma separated, in priority order (`\"-priority,title\"`);\n * - an OpenRegister `_order` map, `{ \"priority\": \"desc\", \"title\": \"asc\" }`;\n * - a `[{ key, order? }]` list.\n *\n * @param {string|object|Array|null|undefined} value The order.\n * @return {Array<{key: string, order: 'asc'|'desc'}>} The sort keys, possibly empty.\n */\nexport function orderToSortKeys(value) {\n\tconst direction = (order) => (String(order || '').toLowerCase() === 'desc' ? 'desc' : 'asc')\n\tif (Array.isArray(value)) {\n\t\treturn value\n\t\t\t.filter((entry) => entry && typeof entry.key === 'string' && entry.key !== '')\n\t\t\t.map((entry) => ({ key: entry.key, order: direction(entry.order) }))\n\t}\n\tif (value && typeof value === 'object') {\n\t\treturn Object.entries(value)\n\t\t\t.filter(([key]) => key !== '')\n\t\t\t.map(([key, order]) => ({ key, order: direction(order) }))\n\t}\n\tif (typeof value !== 'string') {\n\t\treturn []\n\t}\n\treturn value.split(',')\n\t\t.map((part) => part.trim())\n\t\t.filter(Boolean)\n\t\t.map((part) => {\n\t\t\tif (part.startsWith('-')) {\n\t\t\t\treturn { key: part.slice(1), order: 'desc' }\n\t\t\t}\n\t\t\tconst [key, order] = part.split(':')\n\t\t\treturn { key, order: direction(order) }\n\t\t})\n\t\t.filter((entry) => entry.key !== '')\n}\n\n/**\n * Whether two sort key lists order the same way.\n *\n * @param {Array<{key: string, order: string}>} a One list.\n * @param {Array<{key: string, order: string}>} b The other.\n * @return {boolean} True when they name the same keys, directions and priority.\n */\nexport function sameSortKeys(a, b) {\n\tconst left = Array.isArray(a) ? a : []\n\tconst right = Array.isArray(b) ? b : []\n\treturn left.length === right.length\n\t\t&& left.every((entry, index) => entry.key === right[index].key && (entry.order || 'asc') === (right[index].order || 'asc'))\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,eAAe,CAAC,KAAK,EAAE;AACvC,CAAC,MAAM,SAAS,GAAG,CAAC,KAAK,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,GAAG,MAAM,GAAG,KAAK,EAAC;AAC7F,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AAC3B,EAAE,OAAO,KAAK;AACd,IAAI,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC;AACjF,IAAI,GAAG,CAAC,CAAC,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACvE,EAAE;AACF,CAAC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AACzC,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;AAC9B,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC;AACjC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC7D,EAAE;AACF,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAChC,EAAE,OAAO,EAAE;AACX,EAAE;AACF,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;AACxB,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;AAC7B,GAAG,MAAM,CAAC,OAAO,CAAC;AAClB,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK;AACjB,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAC7B,IAAI,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;AAChD,IAAI;AACJ,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAC;AACvC,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE;AAC1C,GAAG,CAAC;AACJ,GAAG,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC;AACtC,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE;AACnC,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAE;AACvC,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAE;AACxC,CAAC,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;AACpC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;AAC7H;;;;"}