@conduction/nextcloud-vue 0.1.0-beta.6 → 0.1.0-beta.7

package/src/store/plugins/auditTrails.js

@@ -1,17 +1,357 @@
-import { createSubResourcePlugin } from '../createSubResourcePlugin.js'
+import { createSubResourcePlugin, emptyPaginated } from '../createSubResourcePlugin.js'
+import { buildHeaders, buildQueryString } from '../../utils/headers.js'
+import { parseResponseError, networkError, genericError } from '../../utils/errors.js'
 
 /**
  * Audit trails plugin for the object store.
  *
- * Adds state, getters, and actions for fetching audit trail records
- * for an object. Read-only — no create/update/delete.
+ * Extends the generic sub-resource plugin with global audit trail operations:
+ * fetching all audit trails (not scoped to one object), statistics, and delete.
  *
+ * **Object-scoped** (from createSubResourcePlugin):
  * State: auditTrails, auditTrailsLoading, auditTrailsError
  * Actions: fetchAuditTrails(type, objectId, params), clearAuditTrails()
  * Getters: getAuditTrails, isAuditTrailsLoading, getAuditTrailsError
  *
+ * **Global** (added by this plugin):
+ * State: globalAuditTrails, globalAuditTrailsLoading, globalAuditTrailsError,
+ *        auditTrailStatistics, auditTrailStatisticsLoading, auditTrailStatisticsError,
+ *        auditTrailItem, auditTrailFilters, auditTrailSearch
+ * Actions: fetchGlobalAuditTrails(params), fetchAuditTrailStatistics(),
+ *          deleteGlobalAuditTrail(id), deleteMultipleGlobalAuditTrails(ids),
+ *          refreshGlobalAuditTrails(), setAuditTrailItem(item),
+ *          setAuditTrailFilters(filters), setAuditTrailSearch(search),
+ *          clearAuditTrailFilters(), clearGlobalAuditTrails()
+ * Getters: getGlobalAuditTrails, isGlobalAuditTrailsLoading, getGlobalAuditTrailsError,
+ *          getAuditTrailStatistics, isAuditTrailStatisticsLoading, getAuditTrailStatisticsError,
+ *          getAuditTrailItem, getAuditTrailFilters, getAuditTrailSearch
+ *
  * @param {object} [options={}] Plugin options
- * @param {number} [options.limit=20] Default page size
- * @return {Function} Plugin factory
+ * @param {number} [options.limit=20] Default page size for object-scoped queries
+ * @param {number} [options.globalLimit=50] Default page size for global queries
+ * @return {object} Plugin definition
+ *
+ * @example
+ * const useStore = createObjectStore('object', {
+ *   plugins: [auditTrailsPlugin()],
+ * })
+ * const store = useStore()
+ *
+ * // Object-scoped (unchanged)
+ * await store.fetchAuditTrails('case', caseId)
+ *
+ * // Global
+ * await store.fetchGlobalAuditTrails({ _limit: 50, _page: 1 })
+ * await store.fetchAuditTrailStatistics()
+ * await store.deleteGlobalAuditTrail(id)
+ */
+
+const GLOBAL_PATH = '/audit-trails'
+
+const EMPTY_STATISTICS = {
+	total: 0,
+	create: 0,
+	update: 0,
+	delete: 0,
+	read: 0,
+}
+
+/**
+ * Build the global audit trails API URL from the store base URL.
+ * e.g. /apps/openregister/api/objects -> /apps/openregister/api/audit-trails
+ *
+ * @param {string} baseUrl Store base URL
+ * @return {string} Global audit trails endpoint URL
  */
-export const auditTrailsPlugin = createSubResourcePlugin('auditTrails', 'audit-trails')
+function buildGlobalUrl(baseUrl) {
+	return baseUrl.replace(/\/objects\/?$/, '') + GLOBAL_PATH
+}
+
+export function auditTrailsPlugin(options = {}) {
+	const base = createSubResourcePlugin('auditTrails', 'audit-trails', options)()
+	const globalLimit = options.globalLimit || 50
+
+	return {
+		...base,
+
+		state: () => ({
+			...base.state(),
+			globalAuditTrails: emptyPaginated(globalLimit),
+			globalAuditTrailsLoading: false,
+			globalAuditTrailsError: null,
+			auditTrailStatistics: { ...EMPTY_STATISTICS },
+			auditTrailStatisticsLoading: false,
+			auditTrailStatisticsError: null,
+			auditTrailItem: null,
+			auditTrailFilters: {},
+			auditTrailSearch: '',
+		}),
+
+		getters: {
+			...base.getters,
+			getGlobalAuditTrails: (state) => state.globalAuditTrails,
+			isGlobalAuditTrailsLoading: (state) => state.globalAuditTrailsLoading || false,
+			getGlobalAuditTrailsError: (state) => state.globalAuditTrailsError || null,
+			getAuditTrailStatistics: (state) => state.auditTrailStatistics,
+			isAuditTrailStatisticsLoading: (state) => state.auditTrailStatisticsLoading || false,
+			getAuditTrailStatisticsError: (state) => state.auditTrailStatisticsError || null,
+			getAuditTrailItem: (state) => state.auditTrailItem || null,
+			getAuditTrailFilters: (state) => state.auditTrailFilters || {},
+			getAuditTrailSearch: (state) => state.auditTrailSearch || '',
+		},
+
+		actions: {
+			...base.actions,
+
+			/**
+			 * Fetch audit trails from the global endpoint (not scoped to an object).
+			 *
+			 * @param {object} [params] Query parameters (_limit, _page, _search, _order, filters)
+			 * @return {Promise<Array>} The fetched results
+			 */
+			async fetchGlobalAuditTrails(params = {}) {
+				this.globalAuditTrailsLoading = true
+				this.globalAuditTrailsError = null
+
+				try {
+					const url = buildGlobalUrl(this._options.baseUrl) + buildQueryString(params)
+
+					const response = await fetch(url, {
+						method: 'GET',
+						headers: buildHeaders(),
+					})
+
+					if (!response.ok) {
+						this.globalAuditTrailsError = await parseResponseError(response, 'audit trails')
+						console.error('Error fetching global audit trails:', this.globalAuditTrailsError)
+						return []
+					}
+
+					const data = await response.json()
+					const results = data.results || data
+
+					this.globalAuditTrails = {
+						results,
+						total: data.total || results.length,
+						page: data.page || 1,
+						pages: data.pages || 0,
+						limit: params._limit || globalLimit,
+						offset: data.offset || 0,
+					}
+
+					return results
+				} catch (error) {
+					this.globalAuditTrailsError = error.name === 'TypeError'
+						? networkError(error)
+						: genericError(error)
+					console.error('Error fetching global audit trails:', error)
+					return []
+				} finally {
+					this.globalAuditTrailsLoading = false
+				}
+			},
+
+			/**
+			 * Fetch audit trail statistics from the global statistics endpoint.
+			 *
+			 * @return {Promise<object>} The statistics object
+			 */
+			async fetchAuditTrailStatistics() {
+				this.auditTrailStatisticsLoading = true
+				this.auditTrailStatisticsError = null
+
+				try {
+					const url = buildGlobalUrl(this._options.baseUrl) + '/statistics'
+
+					const response = await fetch(url, {
+						method: 'GET',
+						headers: buildHeaders(),
+					})
+
+					if (!response.ok) {
+						this.auditTrailStatisticsError = await parseResponseError(response, 'audit trail statistics')
+						console.error('Error fetching audit trail statistics:', this.auditTrailStatisticsError)
+						return { ...EMPTY_STATISTICS }
+					}
+
+					const data = await response.json()
+					this.auditTrailStatistics = { ...EMPTY_STATISTICS, ...data }
+					return this.auditTrailStatistics
+				} catch (error) {
+					this.auditTrailStatisticsError = error.name === 'TypeError'
+						? networkError(error)
+						: genericError(error)
+					console.error('Error fetching audit trail statistics:', error)
+					return { ...EMPTY_STATISTICS }
+				} finally {
+					this.auditTrailStatisticsLoading = false
+				}
+			},
+
+			/**
+			 * Delete a single audit trail by ID.
+			 *
+			 * @param {string} id The audit trail ID
+			 * @return {Promise<boolean>} True if deleted successfully
+			 */
+			async deleteGlobalAuditTrail(id) {
+				this.globalAuditTrailsLoading = true
+				this.globalAuditTrailsError = null
+
+				try {
+					const url = buildGlobalUrl(this._options.baseUrl) + `/${id}`
+
+					const response = await fetch(url, {
+						method: 'DELETE',
+						headers: buildHeaders(),
+					})
+
+					if (!response.ok) {
+						this.globalAuditTrailsError = await parseResponseError(response, 'audit trail')
+						console.error(`Error deleting audit trail ${id}:`, this.globalAuditTrailsError)
+						return false
+					}
+
+					this.globalAuditTrails = {
+						...this.globalAuditTrails,
+						results: this.globalAuditTrails.results.filter((item) => item.id !== id),
+						total: Math.max(0, this.globalAuditTrails.total - 1),
+					}
+
+					return true
+				} catch (error) {
+					this.globalAuditTrailsError = error.name === 'TypeError'
+						? networkError(error)
+						: genericError(error)
+					console.error(`Error deleting audit trail ${id}:`, error)
+					return false
+				} finally {
+					this.globalAuditTrailsLoading = false
+				}
+			},
+
+			/**
+			 * Delete multiple audit trails by IDs.
+			 *
+			 * @param {string[]} ids Array of audit trail IDs to delete
+			 * @return {Promise<boolean>} True if deleted successfully
+			 */
+			async deleteMultipleGlobalAuditTrails(ids) {
+				if (!ids?.length) return true
+
+				this.globalAuditTrailsLoading = true
+				this.globalAuditTrailsError = null
+
+				try {
+					const url = buildGlobalUrl(this._options.baseUrl)
+
+					const response = await fetch(url, {
+						method: 'DELETE',
+						headers: buildHeaders(),
+						body: JSON.stringify({ ids }),
+					})
+
+					if (!response.ok) {
+						this.globalAuditTrailsError = await parseResponseError(response, 'audit trails')
+						console.error('Error deleting audit trails:', this.globalAuditTrailsError)
+						return false
+					}
+
+					const idSet = new Set(ids)
+					const remaining = this.globalAuditTrails.results.filter((item) => !idSet.has(item.id))
+
+					this.globalAuditTrails = {
+						...this.globalAuditTrails,
+						results: remaining,
+						total: Math.max(0, this.globalAuditTrails.total - (this.globalAuditTrails.results.length - remaining.length)),
+					}
+
+					return true
+				} catch (error) {
+					this.globalAuditTrailsError = error.name === 'TypeError'
+						? networkError(error)
+						: genericError(error)
+					console.error('Error deleting audit trails:', error)
+					return false
+				} finally {
+					this.globalAuditTrailsLoading = false
+				}
+			},
+
+			/**
+			 * Re-fetch global audit trails with current pagination state.
+			 *
+			 * @return {Promise<Array>} The fetched results
+			 */
+			async refreshGlobalAuditTrails() {
+				return this.fetchGlobalAuditTrails({
+					_limit: this.globalAuditTrails.limit,
+					_page: this.globalAuditTrails.page,
+				})
+			},
+
+			/**
+			 * Set the active audit trail item (for detail views).
+			 *
+			 * @param {object|null} item The audit trail item or null to clear
+			 */
+			setAuditTrailItem(item) {
+				this.auditTrailItem = item || null
+			},
+
+			/**
+			 * Set audit trail filters (merged with existing).
+			 *
+			 * @param {object} filters Filter key-value pairs
+			 */
+			setAuditTrailFilters(filters) {
+				this.auditTrailFilters = { ...this.auditTrailFilters, ...filters }
+			},
+
+			/**
+			 * Set the audit trail search term.
+			 *
+			 * @param {string} search The search term
+			 */
+			setAuditTrailSearch(search) {
+				this.auditTrailSearch = search || ''
+			},
+
+			/**
+			 * Clear all audit trail filters and search.
+			 */
+			clearAuditTrailFilters() {
+				this.auditTrailFilters = {}
+				this.auditTrailSearch = ''
+			},
+
+			/**
+			 * Clear all global audit trail state back to defaults.
+			 */
+			clearGlobalAuditTrails() {
+				this.globalAuditTrails = emptyPaginated(globalLimit)
+				this.globalAuditTrailsLoading = false
+				this.globalAuditTrailsError = null
+				this.auditTrailStatistics = { ...EMPTY_STATISTICS }
+				this.auditTrailStatisticsLoading = false
+				this.auditTrailStatisticsError = null
+				this.auditTrailItem = null
+				this.auditTrailFilters = {}
+				this.auditTrailSearch = ''
+			},
+
+			/**
+			 * Clear all audit trail state (both object-scoped and global).
+			 * Overrides the base clearAuditTrails so clearAllSubResources() clears everything.
+			 */
+			clearAuditTrails() {
+				// Base sub-resource clear
+				this.auditTrails = emptyPaginated(options.limit || 20)
+				this.auditTrailsLoading = false
+				this.auditTrailsError = null
+				// Global clear
+				this.clearGlobalAuditTrails()
+			},
+		},
+	}
+}

package/src/store/plugins/lifecycle.js

@@ -42,7 +42,7 @@ export function lifecyclePlugin() {
 			 * @param {string} type The registered object type slug
 			 * @param {string} objectId The object ID
 			 * @param {string} action The lifecycle action endpoint (e.g. 'lock', 'publish')
-			 * @param {object} [body=null] Optional request body
+			 * @param {object} [body] Optional request body
 			 * @return {Promise<object|null>} Response data or null on error
 			 */
 			async _lifecycleAction(type, objectId, action, body = null) {
@@ -70,7 +70,7 @@ export function lifecyclePlugin() {
 					const data = await response.json()
 
 					if (this.objects[type] && data.id) {
-						this.objects[type][data.id] = data
+						this.objects = { ...this.objects, [type]: { ...this.objects[type], [data.id]: data } }
 					}
 
 					return data
@@ -115,7 +115,7 @@ export function lifecyclePlugin() {
 			 *
 			 * @param {string} type The registered object type slug
 			 * @param {string} objectId The object ID
-			 * @param {object} [options={}] Publish options
+			 * @param {object} [options] Publish options
 			 * @param {string} [options.date] Publish date (ISO 8601)
 			 * @return {Promise<object|null>} Updated object or null on error
 			 */
@@ -128,7 +128,7 @@ export function lifecyclePlugin() {
 			 *
 			 * @param {string} type The registered object type slug
 			 * @param {string} objectId The object ID
-			 * @param {object} [options={}] Depublish options
+			 * @param {object} [options] Depublish options
 			 * @param {string} [options.date] Depublish date (ISO 8601)
 			 * @return {Promise<object|null>} Updated object or null on error
 			 */

package/src/store/plugins/registerMapping.js

@@ -1,4 +1,4 @@
-import { buildHeaders } from '../../utils/headers.js'
+import { buildHeaders, prefixUrl } from '../../utils/headers.js'
 
 /**
  * Register mapping plugin for the object store.
@@ -28,7 +28,7 @@ export function registerMappingPlugin() {
 		state: () => ({
 			/** @type {Array} All available registers from OpenRegister */
 			registers: [],
-			/** @type {Object<string, Array>} Schemas keyed by register ID */
+			/** @type {{[key: string]: Array}} Schemas keyed by register ID */
 			registerSchemas: {},
 			/** @type {boolean} Whether registers are being fetched */
 			registersLoading: false,
@@ -37,18 +37,28 @@ export function registerMappingPlugin() {
 		}),
 
 		getters: {
-			/** @return {Array} Raw register list */
+			/**
+			 * @param {object} state - Pinia state
+			 * @return {Array} Raw register list
+			 */
 			getRegisters: (state) => state.registers,
 
-			/** @return {boolean} Whether registers are loading */
+			/**
+			 * @param {object} state - Pinia state
+			 * @return {boolean} Whether registers are loading
+			 */
 			isRegistersLoading: (state) => state.registersLoading,
 
-			/** @return {string|null} Last error */
+			/**
+			 * @param {object} state - Pinia state
+			 * @return {string|null} Last error
+			 */
 			getRegistersError: (state) => state.registersError,
 
 			/**
 			 * Registers as NcSelect-compatible options.
 			 *
+			 * @param {object} state - Pinia state
 			 * @return {Array<{label: string, value: string}>}
 			 */
 			registerOptions: (state) => state.registers.map((r) => ({
@@ -75,7 +85,7 @@ export function registerMappingPlugin() {
 			/**
 			 * Fetch all registers from OpenRegister with expanded schemas.
 			 *
-			 * @param {boolean} [withSchemas=true] Include schemas in response
+			 * @param {boolean} [withSchemas] Include schemas in response
 			 * @return {Promise<Array>} Fetched registers
 			 */
 			async fetchRegisters(withSchemas = true) {
@@ -83,7 +93,7 @@ export function registerMappingPlugin() {
 				this.registersError = null
 
 				try {
-					let url = '/apps/openregister/api/registers'
+					let url = prefixUrl('/apps/openregister/api/registers')
 					if (withSchemas) {
 						url += '?_extend[]=schemas'
 					}
@@ -155,7 +165,7 @@ export function registerMappingPlugin() {
 				// Fetch from API as fallback
 				try {
 					const response = await fetch(
-						`/apps/openregister/api/registers/${id}?_extend[]=schemas`,
+						prefixUrl(`/apps/openregister/api/registers/${id}?_extend[]=schemas`),
 						{ method: 'GET', headers: buildHeaders() },
 					)
 					if (!response.ok) return []

package/src/store/plugins/relations.js

@@ -18,7 +18,7 @@ const usedBase = createSubResourcePlugin('used', 'used')
 /**
  * Combined relations plugin that registers contracts, uses, and used sub-resources.
  *
- * @param {object} [options={}] Plugin options
+ * @param {object} [options] Plugin options
  * @return {Function} Plugin factory
  *
  * @example

package/src/store/plugins/search.js

@@ -124,21 +124,21 @@ export function searchPlugin() {
 		getters: {
 			/**
 			 * The current search result objects.
-			 * @param {object} state
+			 * @param {object} state Pinia state
 			 * @return {Array}
 			 */
 			searchCollection: (state) => state._searchCollection,
 
 			/**
 			 * Pagination state for the last search fetch.
-			 * @param {object} state
+			 * @param {object} state Pinia state
 			 * @return {{ total: number, page: number, pages: number, limit: number }}
 			 */
 			searchPagination: (state) => state._searchPagination,
 
 			/**
 			 * True while a search fetch is in progress.
-			 * @param {object} state
+			 * @param {object} state Pinia state
 			 * @return {boolean}
 			 */
 			searchLoading: (state) => state._searchLoading,
@@ -146,7 +146,7 @@ export function searchPlugin() {
 			/**
 			 * The schema object for the current search register/schema pair.
 			 * Populated automatically by `refetchSearchCollection`.
-			 * @param {object} state
+			 * @param {object} state Pinia state
 			 * @return {object|null}
 			 */
 			searchSchema: (state) => state._searchSchema,
@@ -154,7 +154,7 @@ export function searchPlugin() {
 			/**
 			 * The register object for the current search register/schema pair.
 			 * Populated automatically by `refetchSearchCollection`.
-			 * @param {object} state
+			 * @param {object} state Pinia state
 			 * @return {object|null}
 			 */
 			searchRegister: (state) => state._searchRegister,
@@ -162,7 +162,7 @@ export function searchPlugin() {
 			/**
 			 * Facet data from the last search fetch, in CnIndexSidebar-compatible format:
 			 * `{ fieldName: { values: [{ value, count }] } }`.
-			 * @param {object} state
+			 * @param {object} state Pinia state
 			 * @return {object}
 			 */
 			searchFacets: (state) => state._searchFacets,
@@ -236,7 +236,20 @@ export function searchPlugin() {
 			 * @return {Promise<Array>} The fetched collection (empty array on error)
 			 */
 			async refetchSearchCollection() {
-				const { register, schema, ...queryParams } = this.searchParams
+				const { register, schema, filters, ...queryParams } = this.searchParams
+
+				// Flatten the filters object into individual query params so the
+				// backend receives them as field-level filters (e.g. ?title=foo)
+				// instead of a single `filters=[object Object]` param.
+				if (filters && typeof filters === 'object') {
+					for (const [field, values] of Object.entries(filters)) {
+						if (Array.isArray(values) && values.length > 0) {
+							queryParams[field] = values
+						} else if (values && !Array.isArray(values)) {
+							queryParams[field] = values
+						}
+					}
+				}
 
 				if (!register || !schema) {
 					console.warn('[searchPlugin] refetchSearchCollection called without register/schema in searchParams')
@@ -263,7 +276,7 @@ export function searchPlugin() {
 				}
 
 				try {
-					const baseUrl = this._options?.baseUrl || '/apps/openregister/api/objects'
+					const baseUrl = this._options?.baseUrl || prefixUrl('/apps/openregister/api/objects')
 					const url = `${baseUrl}/${register}/${schema}` + buildQueryString(queryParams)
 
 					const response = await fetch(url, {