Utilities

Helper functions exported by @conduction/nextcloud-vue. Each function has its own reference page.

HTTP

Function	Purpose
buildHeaders	Build Nextcloud OCS request headers (CSRF token + flags)
buildQueryString	Serialise a params object into a URL query string

Errors

All three error helpers return the same ApiError shape so consumers can surface them uniformly regardless of source.

Function	Use when
parseResponseError	response.ok === false — an HTTP response was received
networkError	fetch threw a TypeError — no response (offline/DNS/CORS)
genericError	Any other caught exception

Schema

Helpers that derive UI structure from an OpenRegister / JSON Schema.

Function	Purpose
columnsFromSchema	Generate CnDataTable column definitions
filtersFromSchema	Generate filter definitions from facetable properties
fieldsFromSchema	Generate form field descriptors (widget, validation, required)
formatValue	Format a raw value for display using a property descriptor

Manifest

Helpers that back the JSON-manifest renderer. Most consumers never call these directly — they are wired up automatically inside useAppManifest — but they are exported for advanced loaders and CLI manifest checkers.

Function	Purpose
validateManifest	Validate an app manifest against the JSON Schema (build-time and runtime)
resolveManifestSentinels	Substitute @resolve:<key> strings under pages[].config with their IAppConfig values
clearResolveCache	Reset the per-page IAppConfig resolution cache (test-only)

Widget visibility

Used by the dashboard composable and any custom widget loader that wants the same user/group visibility rules.

Function	Purpose
filterWidgetsByVisibility	Async filter of widget definitions for the current user
isWidgetVisible	Sync predicate for a single widget
getCurrentUserId	Read OC.currentUser
getCurrentUserGroups	Fetch (and cache) the current user's groups
resetVisibilityCache	Clear the cached groups

Composables

Vue 3 composables live under utilities/composables/.