@conduction/nextcloud-vue 2.91.0 → 2.93.0

package/src/utils/roadmapIssues.js

@@ -0,0 +1,82 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * roadmapIssues: the forge issues a roadmap shows, fetched through
+ * OpenRegister's `github-issue-proxy` with the curated label filter
+ * (`enhancement,feature`, per openregister design D23), most-reacted first.
+ *
+ * @module utils/roadmapIssues
+ * @spec openspec/changes/screens-roadmap-board-look/specs/features-roadmap-board-look/spec.md#requirement-the-next-card-lists-the-most-requested-issues
+ */
+
+import axios from '@nextcloud/axios'
+import { generateUrl } from '@nextcloud/router'
+
+/**
+ * Fetch the roadmap issues of a repository.
+ *
+ * `degraded` names why there are none: `pat_not_configured` (OpenRegister has
+ * no GitHub token), `rate_limited` (HTTP 429), `error` (anything else), or
+ * null when the fetch worked.
+ *
+ * @param {string} repo `<owner>/<repo>` on the forge.
+ * @return {Promise<{items: Array<object>, degraded: (string|null)}>} The issues, most-reacted first.
+ * @spec openspec/changes/screens-roadmap-board-look/specs/features-roadmap-board-look/spec.md#requirement-the-next-card-lists-the-most-requested-issues
+ */
+export async function fetchRoadmapIssues(repo) {
+	try {
+		const response = await axios.get(generateUrl('/apps/openregister/api/github/issues'), {
+			params: { repo, labels: 'enhancement,feature' },
+		})
+		const data = response.data || {}
+		if (data.hint === 'github_pat_not_configured') {
+			return { items: [], degraded: 'pat_not_configured' }
+		}
+		return { items: sortByReactions(Array.isArray(data.items) ? data.items : []), degraded: null }
+	} catch (e) {
+		const status = e?.response?.status
+		const code = e?.response?.data?.error
+		if (status === 429 || code === 'github_rate_limited' || code === 'rate_limited') {
+			return { items: [], degraded: 'rate_limited' }
+		}
+		return { items: [], degraded: 'error' }
+	}
+}
+
+/**
+ * Issues ordered by their reaction count, most first.
+ *
+ * @param {Array<object>} items The issues.
+ * @return {Array<object>} A sorted copy.
+ * @spec openspec/changes/screens-roadmap-board-look/specs/features-roadmap-board-look/spec.md#requirement-the-next-card-lists-the-most-requested-issues
+ */
+export function sortByReactions(items) {
+	return [...items].sort((a, b) => (b.reactions?.total_count || 0) - (a.reactions?.total_count || 0))
+}
+
+/**
+ * The roadmap status of an issue from its labels: the first label that
+ * `labelStatuses` maps (case-insensitive) decides, else ''.
+ *
+ * @param {object} issue The issue, with `labels: [{name}]` or `labels: ['name']`.
+ * @param {object} labelStatuses Label name to status (`in_progress`, `planned`).
+ * @return {string} The status, or '' for no badge.
+ * @spec openspec/changes/screens-roadmap-board-look/specs/features-roadmap-board-look/spec.md#requirement-the-next-card-lists-the-most-requested-issues
+ */
+export function issueStatus(issue, labelStatuses) {
+	if (!labelStatuses || typeof labelStatuses !== 'object') {
+		return ''
+	}
+	const map = {}
+	for (const [label, status] of Object.entries(labelStatuses)) {
+		map[label.toLowerCase()] = status
+	}
+	for (const label of Array.isArray(issue?.labels) ? issue.labels : []) {
+		const name = String(typeof label === 'string' ? label : label?.name || '').toLowerCase()
+		if (map[name]) {
+			return map[name]
+		}
+	}
+	return ''
+}

package/src/utils/userDisplayName.js

@@ -0,0 +1,54 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * userDisplayName: a user id's display name for synchronous text (a template
+ * token), looked up once through `resolveNextcloudUser` and kept in a
+ * reactive cache, so a computed that read it renders again when the name
+ * arrives.
+ *
+ * @module utils/userDisplayName
+ * @spec openspec/changes/screens-header-meta-tokens/specs/detail-page-board-look/spec.md#requirement-the-header-meta-line-formats-users-long-dates-and-enum-labels
+ */
+
+import { reactive } from 'vue'
+import { resolveNextcloudUser } from './userAutocomplete.js'
+
+const names = reactive({})
+
+/**
+ * The display name of a user id: the cached name, or '' while it is being
+ * looked up (the first call starts the lookup). A user that cannot be
+ * resolved reads as its id.
+ *
+ * @param {unknown} uid The user id.
+ * @return {string} The display name, or '' while loading.
+ * @spec openspec/changes/screens-header-meta-tokens/specs/detail-page-board-look/spec.md#requirement-the-header-meta-line-formats-users-long-dates-and-enum-labels
+ */
+export function userDisplayName(uid) {
+	if (uid === null || uid === undefined || uid === '' || typeof uid === 'object') {
+		return ''
+	}
+	const id = String(uid)
+	if (typeof names[id] === 'string') {
+		return names[id]
+	}
+	if (names[id] === undefined) {
+		names[id] = null
+		resolveNextcloudUser(id)
+			.then((option) => { names[id] = option && option.label ? String(option.label) : id })
+			.catch(() => { names[id] = id })
+	}
+	return ''
+}
+
+/**
+ * Forget every cached name (tests).
+ *
+ * @return {void}
+ */
+export function clearUserDisplayNames() {
+	for (const key of Object.keys(names)) {
+		delete names[key]
+	}
+}