@conduction/nextcloud-vue 2.120.0 → 2.121.0

package/src/components/CnWidgetGrid/registerDashboardWidgets.js

@@ -37,6 +37,7 @@ import CnRelatedObjectsWidgetForm from '../CnRelatedObjectsWidgetForm/CnRelatedO
 import CnRetentionWidget from '../CnRetentionWidget/CnRetentionWidget.vue'
 import CnSavedViewWidget2 from '../CnSavedViewWidget/CnSavedViewWidget.vue'
 import CnSavedViewWidgetForm2 from '../CnSavedViewWidgetForm/CnSavedViewWidgetForm.vue'
+import CnSchemaRulesWidget from '../CnSchemaRulesWidget/CnSchemaRulesWidget.vue'
 import CnStackedBarWidget from '../CnStackedBarWidget/CnStackedBarWidget.vue'
 import CnStackedBarWidgetForm from '../CnStackedBarWidgetForm/CnStackedBarWidgetForm.vue'
 import CnStagesWidget from '../CnStagesWidget/CnStagesWidget.vue'
@@ -311,6 +312,15 @@ registerDashboardWidget('retention', {
 	ownsTitle: true,
 })
 
+registerDashboardWidget('schema-rules', {
+	renderer: CnSchemaRulesWidget,
+	form: null,
+	defaultContent: { register: '', schema: '', objectId: '' },
+	displayName: 'Schema rules',
+	icon: 'ScaleBalance',
+	surfaces: ['detail-page'],
+})
+
 registerDashboardWidget('plan', {
 	renderer: CnPlanWidget,
 	form: null,

package/src/components/index.js

@@ -464,3 +464,7 @@ export { CnBrandStripe } from './CnBrandStripe/index.js'
 export { CnDuplicateWarning } from './CnDuplicateWarning/index.js'
 export { CnEndpointNotice } from './CnEndpointNotice/index.js'
 export { CnCountTablesReport } from './CnCountTablesReport/index.js'
+export { CnShippedConfigurationSection } from './CnShippedConfigurationSection/index.js'
+export { CnSearchIndexStatus } from './CnSearchIndexStatus/index.js'
+export { CnSchemaRulesWidget } from './CnSchemaRulesWidget/index.js'
+export { CnReadinessChecklist } from './CnReadinessChecklist/index.js'

package/src/composables/indexSources.js

@@ -737,6 +737,14 @@ function readRowsPath(body, path) {
 	return String(path).split('.').reduce((value, key) => (value && typeof value === 'object' ? value[key] : undefined), body)
 }
 
+/**
+ * The `sourceConfig` keys the endpoint source reads itself; every other key
+ * goes along as a query parameter.
+ *
+ * @type {Array<string>}
+ */
+const ENDPOINT_SOURCE_KEYS = ['url', 'rowsPath', 'totalPath', 'searchParam', 'searchFields', 'notePath', 'noteText', 'refusedText']
+
 /**
  * The endpoint source: rows from an app's own endpoint
  * (`entitySource: "endpoint"`), for a list that is not OpenRegister objects,
@@ -759,25 +767,46 @@ function readRowsPath(body, path) {
  * request with that tab's filter, its total read at `sourceConfig.totalPath`
  * (`total` by default), else the number of rows the answer holds.
  *
+ * Three more keys shape what the page says around the rows:
+ * - `searchParam`: the page's search box sends its term as this parameter
+ *   (`sender`), so the endpoint does the searching.
+ * - `notePath` and `noteText`: a value read off the answer (`filterOrder`) and
+ *   the sentence it is said in ("Filters run in this order: {order}", its one
+ *   placeholder taking the value); a list
+ *   is joined with commas. Shown above the rows.
+ * - `refusedText`: what a refused load (403) says when the endpoint gave no
+ *   `message` of its own. A refusal is not an empty list, so the page shows it
+ *   instead of the rows, and a failed load is not one either.
+ * - `searchFields`: the filters the endpoint takes, in the same shape a
+ *   registered source declares them (`{ status: { param: 'status', single:
+ *   true } }`), so a filter strip or sidebar on the page narrows the
+ *   endpoint's query.
+ *
+ * @param {object} [declared] The page's `sourceConfig`, for `searchParam` and `searchFields`.
+ * @param {object} [context] The page's helpers; `translate` is the app's catalogue.
  * @return {object} The source adapter.
  * @spec openspec/changes/index-endpoint-source/specs/index-page/spec.md#requirement-an-index-page-can-list-rows-from-an-app-endpoint
  */
-function endpointSource() {
-	const state = reactive({ rows: [], loading: false })
+function endpointSource(declared = {}, context = {}) {
+	const state = reactive({ rows: [], loading: false, refusal: '', failed: false, note: '' })
+	const translate = typeof context.translate === 'function' ? context.translate : (text) => text
+	const searchParam = typeof declared.searchParam === 'string' && declared.searchParam !== '' ? declared.searchParam : null
+	const searchFields = declared.searchFields && typeof declared.searchFields === 'object' && !Array.isArray(declared.searchFields) ? declared.searchFields : null
 	let seq = 0
 	let warned = false
 
 	/**
-	 * The query parameters for a config: every key but the url and the paths,
-	 * empty values left out, a list joined by commas.
+	 * The query parameters for a config: every key but the source's own
+	 * (`url`, the paths, the texts), empty values left out, a list joined by
+	 * commas.
 	 *
-	 * @param {object} rest The config without `url`, `rowsPath` and `totalPath`.
+	 * @param {object} config The config.
 	 * @return {object} The parameters.
 	 */
-	const paramsOf = (rest) => {
+	const paramsOf = (config) => {
 		const params = {}
-		for (const [key, value] of Object.entries(rest)) {
-			if (value === undefined || value === null || value === '') {
+		for (const [key, value] of Object.entries(config)) {
+			if (ENDPOINT_SOURCE_KEYS.includes(key) || value === undefined || value === null || value === '') {
 				continue
 			}
 			params[key] = Array.isArray(value) ? value.join(',') : (typeof value === 'object' ? JSON.stringify(value) : value)
@@ -797,15 +826,61 @@ function endpointSource() {
 		return typeof url === 'string' && url !== '' && !Object.hasOwn(config, 'entitySource')
 	}
 
+	/**
+	 * The note read off an answer, in the page's sentence.
+	 *
+	 * @param {object} body The response body.
+	 * @param {string} [path] Where the value sits.
+	 * @param {string} [text] The sentence, with one `{placeholder}` where the value goes.
+	 * @return {string} The note, or '' when there is nothing to say.
+	 */
+	const noteOf = (body, path, text) => {
+		if (!path || !body || typeof body !== 'object' || Array.isArray(body)) {
+			return ''
+		}
+		const raw = readRowsPath(body, path)
+		const value = Array.isArray(raw) ? raw.filter((v) => v !== null && v !== undefined && v !== '').join(', ') : (raw === null || raw === undefined ? '' : String(raw))
+		if (value === '') {
+			return ''
+		}
+		return text ? translate(text).replace(/\{\w+\}/, value) : value
+	}
+
+	/**
+	 * The sentence a refused load is said in: the endpoint's own, else the
+	 * page's, else the library's.
+	 *
+	 * @param {object} body The refusal's body.
+	 * @param {string} [text] The page's `refusedText`.
+	 * @return {string} The sentence.
+	 */
+	const refusalOf = (body, text) => {
+		if (body && typeof body.message === 'string' && body.message.trim() !== '') {
+			return body.message
+		}
+		return text ? translate(text) : t('nextcloud-vue', 'You may not read this list.')
+	}
+
 	return {
+		/**
+		 * The parameter the page's search term is sent as, or null when this
+		 * endpoint takes no search.
+		 */
+		searchParam,
+
+		/**
+		 * The page filters this endpoint takes, and the parameter each becomes.
+		 */
+		searchFields,
+
 		/**
 		 * Fetch the rows.
 		 *
 		 * @param {object} config The page's source config with the tab filter merged in.
-		 * @return {Promise<void>} Resolves when loaded; a failed request leaves no rows and rethrows.
+		 * @return {Promise<void>} Resolves when loaded or refused; a failed request leaves no rows and rethrows.
 		 */
 		load: async (config) => {
-			const { url, rowsPath, totalPath, ...rest } = config || {}
+			const { url, rowsPath, notePath, noteText, refusedText } = config || {}
 			const mine = ++seq
 			if (!requestable(config)) {
 				state.rows = []
@@ -817,7 +892,7 @@ function endpointSource() {
 				}
 				return
 			}
-			const params = paramsOf(rest)
+			const params = paramsOf(config)
 			state.loading = true
 			try {
 				const { default: axios } = await import('@nextcloud/axios')
@@ -826,12 +901,22 @@ function endpointSource() {
 				const rows = Array.isArray(body) ? body : readRowsPath(body, rowsPath || 'results')
 				if (mine === seq) {
 					state.rows = Array.isArray(rows) ? rows : []
+					state.refusal = ''
+					state.failed = false
+					state.note = noteOf(body, notePath, noteText)
 				}
 			} catch (error) {
-				if (mine === seq) {
-					state.rows = []
+				if (mine !== seq) {
+					return
+				}
+				state.rows = []
+				state.note = ''
+				const refused = error && error.response && error.response.status === 403
+				state.refusal = refused ? refusalOf(error.response.data, refusedText) : ''
+				state.failed = !refused
+				if (!refused) {
+					throw error
 				}
-				throw error
 			} finally {
 				if (mine === seq) {
 					state.loading = false
@@ -850,9 +935,9 @@ function endpointSource() {
 			if (!requestable(config)) {
 				return Number.NaN
 			}
-			const { url, rowsPath, totalPath, ...rest } = config
+			const { url, rowsPath, totalPath } = config
 			const { default: axios } = await import('@nextcloud/axios')
-			const res = await axios.get(generateUrl(url), { params: paramsOf(rest) })
+			const res = await axios.get(generateUrl(url), { params: paramsOf(config) })
 			const body = res ? res.data : null
 			const total = body && typeof body === 'object' && !Array.isArray(body) ? readRowsPath(body, totalPath || 'total') : undefined
 			if (typeof total === 'number' && Number.isFinite(total)) {
@@ -871,6 +956,21 @@ function endpointSource() {
 		 * @return {boolean} Whether a load is in flight.
 		 */
 		loading: () => state.loading,
+
+		/**
+		 * @return {string} The sentence the last load was refused with, or ''.
+		 */
+		refusal: () => state.refusal,
+
+		/**
+		 * @return {boolean} Whether the last load failed for another reason than a refusal.
+		 */
+		failed: () => state.failed,
+
+		/**
+		 * @return {string} The note read off the last answer, or ''.
+		 */
+		note: () => state.note,
 	}
 }
 

package/src/css/index-page.css

@@ -222,6 +222,13 @@
 	color: var(--color-text-maxcontrast);
 }
 
+/* A note the named source read off its answer, above the rows. */
+.cn-index-page__source-note {
+	margin: 0 0 8px;
+	color: var(--color-text-maxcontrast);
+	font-size: 0.9em;
+}
+
 .cn-index-page__scope-heading {
 	display: flex;
 	flex-direction: column;

package/src/index.js

@@ -275,6 +275,7 @@ export {
 	CnQuicklinksWidget,
 	CnQuicklinksWidgetForm,
 	CnRadioCardsWidget,
+	CnReadinessChecklist,
 	CnRecordListWidget,
 	CnRedactionEditor,
 	CnReferencePreview,
@@ -304,6 +305,8 @@ export {
 	CnSavedViewWidgetForm,
 	CnSaveViewDialog,
 	CnSchemaFormDialog,
+	CnSchemaRulesWidget,
+	CnSearchIndexStatus,
 	CnSearchPage,
 	CnSearchSelect,
 	CnSectionsWidget,
@@ -315,6 +318,7 @@ export {
 	CnSettingsPage,
 	CnSettingsSection,
 	CnSetupWizard,
+	CnShippedConfigurationSection,
 	CnSignatureCapture,
 	CnSpendAnalyticsWidget,
 	CnSpendAnalyticsWidgetForm,

package/src/utils/libraryWidgetKeys.js

@@ -151,6 +151,7 @@ export const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'retention',
 	'saved-view',
 	'saved-views',
+	'schema-rules',
 	'sections',
 	'settings-form',
 	'spend-analytics',