@conduction/nextcloud-vue 2.132.0 → 2.134.0

package/src/utils/objectParties.js

@@ -13,6 +13,7 @@
  */
 
 import { translate as t } from '@nextcloud/l10n'
+import { readPath } from './readPath.js'
 
 /**
  * What a role is called: the app's own word (`roleLabels`), else the label
@@ -174,3 +175,80 @@ export function documentsOfParty(documents, identifier, fields = {}) {
 export function kindCode(kind) {
 	return String(kind?.code || kind?.key || '')
 }
+
+/**
+ * Write a value at a dotted path, creating the objects on the way.
+ *
+ * @param {object} target The object written into.
+ * @param {string} path The dotted path (`name.surname`).
+ * @param {unknown} value The value.
+ * @return {void}
+ */
+function writePath(target, path, value) {
+	const keys = String(path).split('.').filter((key) => key !== '')
+	let node = target
+	keys.slice(0, -1).forEach((key) => {
+		if (!node[key] || typeof node[key] !== 'object') {
+			node[key] = {}
+		}
+		node = node[key]
+	})
+	if (keys.length > 0) {
+		node[keys[keys.length - 1]] = value
+	}
+}
+
+/**
+ * The record a new party is saved as, from the fields a host declares.
+ *
+ * Each field `{ key, path?, address? }` writes its trimmed value at `path`
+ * (default `key`); a field with `address: { path, kind, type }` instead adds
+ * `{ kind, type, value }` to the list at that path, the shape OpenRegister's
+ * party model reads as the party's addresses. `compose` names the paths a
+ * derived field joins with a space, skipping the empty ones
+ * (`{ displayName: ["name.givenNames", "name.namePrefix", "name.surname"] }`).
+ * A field of `type: "integer"` is saved as a number when it reads as one.
+ * An empty value is left out.
+ *
+ * @param {{fields?: Array<object>, compose?: Record<string, Array<string>>}} create The declaration.
+ * @param {Record<string, string>} values The values by field key.
+ * @return {object} The record.
+ * @spec openspec/changes/object-parties-manage/specs/record-widgets/spec.md#requirement-the-parties-widget-can-add-and-remove-parties
+ */
+export function newPartyRecord(create, values) {
+	const record = {}
+	for (const field of Array.isArray(create?.fields) ? create.fields : []) {
+		const value = String(values?.[field?.key] ?? '').trim()
+		if (!field || !field.key || value === '') {
+			continue
+		}
+		if (field.address && field.address.path) {
+			const list = readPath(record, field.address.path)
+			const entry = { kind: field.address.kind || 'correspondence', type: field.address.type || 'email', value }
+			writePath(record, field.address.path, [...(Array.isArray(list) ? list : []), entry])
+			continue
+		}
+		writePath(record, field.path || field.key, field.type === 'integer' && /^-?\d+$/.test(value) ? Number(value) : value)
+	}
+	for (const [target, paths] of Object.entries(create?.compose && typeof create.compose === 'object' ? create.compose : {})) {
+		const joined = (Array.isArray(paths) ? paths : [])
+			.map((path) => String(readPath(record, path) ?? '').trim())
+			.filter((part) => part !== '')
+			.join(' ')
+		if (joined !== '') {
+			writePath(record, target, joined)
+		}
+	}
+	return record
+}
+
+/**
+ * The uuid a create answered with: `id`, `uuid` or `@self.id`.
+ *
+ * @param {object} saved The saved object.
+ * @return {string} The uuid, or ''.
+ * @spec openspec/changes/object-parties-manage/specs/record-widgets/spec.md#requirement-the-parties-widget-can-add-and-remove-parties
+ */
+export function savedUuid(saved) {
+	return String(saved?.['@self']?.id || saved?.uuid || saved?.id || '')
+}

package/src/utils/objectRows.js

@@ -0,0 +1,55 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The rows a record holds in one of its fields, as `objectRows` names them:
+ * `{ path, where?, valuePath? }`. The list at `path`, narrowed to the entry
+ * matching `where` when set (`{ name: "onderzoeksstappen" }` in a case's
+ * answers), its `valuePath` taken; a JSON string is decoded. Anything that is
+ * not a list of objects is no rows. The record is read as the page read it, so
+ * its own read rules already decided what is in it.
+ *
+ * @spec openspec/changes/record-list-object-rows/specs/record-list/spec.md#requirement-a-record-list-can-list-rows-the-page-record-holds
+ */
+import { readPath } from './readPath.js'
+
+/**
+ * Whether a declaration names rows on a record.
+ *
+ * @param {unknown} spec The declaration.
+ * @return {boolean}
+ */
+export function isObjectRowsSpec(spec) {
+	return Boolean(spec && typeof spec === 'object' && typeof spec.path === 'string' && spec.path !== '')
+}
+
+/**
+ * The rows a record holds where `spec` points.
+ *
+ * @param {object|null} object The record.
+ * @param {{path: string, where?: object, valuePath?: string}} spec The declaration.
+ * @return {Array<object>} The rows.
+ */
+export function objectRowsOf(object, spec) {
+	if (!object || typeof object !== 'object' || !isObjectRowsSpec(spec)) {
+		return []
+	}
+	const valuePath = typeof spec.valuePath === 'string' && spec.valuePath !== '' ? spec.valuePath : ''
+	let value = readPath(object, spec.path)
+	if (spec.where && typeof spec.where === 'object') {
+		const entries = Array.isArray(value) ? value : []
+		const match = entries.find((entry) => entry && typeof entry === 'object'
+			&& Object.entries(spec.where).every(([key, wanted]) => entry[key] === wanted))
+		value = match && valuePath ? readPath(match, valuePath) : match
+	} else if (valuePath) {
+		value = readPath(value, valuePath)
+	}
+	if (typeof value === 'string') {
+		try {
+			value = JSON.parse(value)
+		} catch {
+			value = undefined
+		}
+	}
+	return Array.isArray(value) ? value.filter((row) => row && typeof row === 'object' && !Array.isArray(row)) : []
+}