@conduction/nextcloud-vue 2.82.0 → 2.83.0

package/dist/esm/utils/fetchAggregate.js

@@ -38,11 +38,34 @@ function flattenAggFilter(target, filter, ctx) {
 				target[`filter[${k}][${op}]`] = ov;
 			}
 		} else if (v !== '' && v !== null && v !== undefined) {
-			target[`filter[${k}]`] = v;
+			target[aggFilterParam(k)] = v;
 		}
 	}
 }
 
+/**
+ * Matches a filter key that spells its operator, `field[op]`.
+ *
+ * @type {RegExp}
+ */
+const OPERATOR_KEY = /^(.+)\[([A-Za-z_]+)\]$/;
+
+/**
+ * The query parameter of one plain filter key. A key that spells its operator
+ * (`scheduledDate[gte]`, the flat form a list page and a lens use) goes out as
+ * `filter[scheduledDate][gte]`, the form the aggregation endpoint reads, and
+ * not as `filter[scheduledDate[gte]]`, a field it does not have, which counted
+ * 0. Any other key goes out as `filter[key]`.
+ *
+ * @spec openspec/changes/screens-stats-block-operator-keys/specs/stats-block/spec.md#requirement-a-stats-block-filter-can-spell-its-operator-in-the-key
+ * @param {string} key The filter key.
+ * @return {string} The query parameter name.
+ */
+function aggFilterParam(key) {
+	const match = OPERATOR_KEY.exec(key);
+	return match ? `filter[${match[1]}][${match[2]}]` : `filter[${key}]`
+}
+
 /**
  * Fetch one aggregated scalar from OpenRegister.
  *
@@ -115,5 +138,5 @@ async function fetchGroupedCounts(source, ctx) {
 		.map((g) => ({ key: String(g.key), count: Number(g.value) || 0 }))
 }
 
-export { fetchAggregateValue, fetchGroupedCounts, flattenAggFilter };
+export { aggFilterParam, fetchAggregateValue, fetchGroupedCounts, flattenAggFilter };
 //# sourceMappingURL=fetchAggregate.js.map

package/dist/esm/utils/fetchAggregate.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetchAggregate.js","sources":["../../../src/utils/fetchAggregate.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Shared helper for the abstract data widgets (CnStatWidget, CnDeltaWidget,\n * CnGaugeWidget, …) — fetches ONE scalar from OpenRegister's ad-hoc aggregation\n * `/value` endpoint given a `{ register, schema, metric, field, filter }`\n * descriptor. Filter values run through `resolveFilterTokens` first, so relative\n * tokens (`@me`, `@monthStart`, `@currentFiscalYear`, …) resolve at fetch time.\n *\n * @module utils/fetchAggregate\n */\n\nimport { resolveFilterTokens } from './resolveFilterTokens.js'\n\n/**\n * Flatten a filter map into operator-aware `filter[key]` / `filter[key][op]`\n * query params (the OpenRegister aggregation filter vocabulary). Resolves\n * relative tokens before writing.\n *\n * @param {object} target The params object to write into.\n * @param {object} filter The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context forwarded to {@link resolveFilterTokens} so a\n *   detail-page aggregate can scope its filter to the current object via\n *   `@objectId` / `@object.<field>`.\n * @return {void}\n */\nexport function flattenAggFilter(target, filter, ctx) {\n\tif (!filter || typeof filter !== 'object') {\n\t\treturn\n\t}\n\tfilter = resolveFilterTokens(filter, ctx)\n\tfor (const [k, v] of Object.entries(filter)) {\n\t\tif (v && typeof v === 'object') {\n\t\t\tfor (const [op, ov] of Object.entries(v)) {\n\t\t\t\ttarget[`filter[${k}][${op}]`] = ov\n\t\t\t}\n\t\t} else if (v !== '' && v !== null && v !== undefined) {\n\t\t\ttarget[`filter[${k}]`] = v\n\t\t}\n\t}\n}\n\n/**\n * Fetch one aggregated scalar from OpenRegister.\n *\n * @param {object} source The aggregate descriptor.\n * @param {string} source.register The register slug.\n * @param {string} source.schema The schema slug.\n * @param {string} [source.metric] count | sum | avg | min | max (default count).\n * @param {string} [source.field] The numeric field (required for non-count metrics).\n * @param {object} [source.filter] The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context (a detail page's object context) so the filter can\n *   scope to the current object via `@objectId` / `@object.<field>`.\n * @return {Promise<number|null>} The aggregated value, or null when unavailable.\n */\nexport async function fetchAggregateValue(source, ctx) {\n\tconst s = source || {}\n\tif (!s.register || !s.schema) {\n\t\treturn null\n\t}\n\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\timport('@nextcloud/axios'),\n\t\timport('@nextcloud/router'),\n\t])\n\tconst url = generateUrl(\n\t\t'/apps/openregister/api/objects/aggregations/{register}/{schema}/value',\n\t\t{ register: s.register, schema: s.schema },\n\t)\n\tconst params = { metric: s.metric || 'count' }\n\tif (s.field) {\n\t\tparams.field = s.field\n\t}\n\tflattenAggFilter(params, s.filter || {}, ctx)\n\tconst res = await axios.get(url, { params })\n\treturn (res && res.data && res.data.value !== undefined) ? res.data.value : null\n}\n\n/**\n * Fetch the object count per distinct value of one field, in ONE request,\n * from OpenRegister's `/grouped` aggregation endpoint.\n *\n * @param {object} source The grouped descriptor.\n * @param {string} source.register The register slug.\n * @param {string} source.schema The schema slug.\n * @param {string} source.groupBy The field to group on.\n * @param {object} [source.filter] The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context for the filter.\n * @return {Promise<Array<{key: string, count: number}>>} One entry per group; [] when the source is incomplete.\n * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-stacked-bar-widget\n */\nexport async function fetchGroupedCounts(source, ctx) {\n\tconst s = source || {}\n\tif (!s.register || !s.schema || !s.groupBy) {\n\t\treturn []\n\t}\n\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\timport('@nextcloud/axios'),\n\t\timport('@nextcloud/router'),\n\t])\n\tconst url = generateUrl(\n\t\t'/apps/openregister/api/objects/aggregations/{register}/{schema}/grouped',\n\t\t{ register: s.register, schema: s.schema },\n\t)\n\tconst params = { groupBy: s.groupBy, metric: 'count' }\n\tflattenAggFilter(params, s.filter || {}, ctx)\n\tconst res = await axios.get(url, { params })\n\tconst groups = (res && res.data && Array.isArray(res.data.groups)) ? res.data.groups : []\n\treturn groups\n\t\t.filter((g) => g && g.key !== null && g.key !== undefined && g.key !== '')\n\t\t.map((g) => ({ key: String(g.key), count: Number(g.value) || 0 }))\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetchAggregate.js","sources":["../../../src/utils/fetchAggregate.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Shared helper for the abstract data widgets (CnStatWidget, CnDeltaWidget,\n * CnGaugeWidget, …) — fetches ONE scalar from OpenRegister's ad-hoc aggregation\n * `/value` endpoint given a `{ register, schema, metric, field, filter }`\n * descriptor. Filter values run through `resolveFilterTokens` first, so relative\n * tokens (`@me`, `@monthStart`, `@currentFiscalYear`, …) resolve at fetch time.\n *\n * @module utils/fetchAggregate\n */\n\nimport { resolveFilterTokens } from './resolveFilterTokens.js'\n\n/**\n * Flatten a filter map into operator-aware `filter[key]` / `filter[key][op]`\n * query params (the OpenRegister aggregation filter vocabulary). Resolves\n * relative tokens before writing.\n *\n * @param {object} target The params object to write into.\n * @param {object} filter The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context forwarded to {@link resolveFilterTokens} so a\n *   detail-page aggregate can scope its filter to the current object via\n *   `@objectId` / `@object.<field>`.\n * @return {void}\n */\nexport function flattenAggFilter(target, filter, ctx) {\n\tif (!filter || typeof filter !== 'object') {\n\t\treturn\n\t}\n\tfilter = resolveFilterTokens(filter, ctx)\n\tfor (const [k, v] of Object.entries(filter)) {\n\t\tif (v && typeof v === 'object') {\n\t\t\tfor (const [op, ov] of Object.entries(v)) {\n\t\t\t\ttarget[`filter[${k}][${op}]`] = ov\n\t\t\t}\n\t\t} else if (v !== '' && v !== null && v !== undefined) {\n\t\t\ttarget[aggFilterParam(k)] = v\n\t\t}\n\t}\n}\n\n/**\n * Matches a filter key that spells its operator, `field[op]`.\n *\n * @type {RegExp}\n */\nconst OPERATOR_KEY = /^(.+)\\[([A-Za-z_]+)\\]$/\n\n/**\n * The query parameter of one plain filter key. A key that spells its operator\n * (`scheduledDate[gte]`, the flat form a list page and a lens use) goes out as\n * `filter[scheduledDate][gte]`, the form the aggregation endpoint reads, and\n * not as `filter[scheduledDate[gte]]`, a field it does not have, which counted\n * 0. Any other key goes out as `filter[key]`.\n *\n * @spec openspec/changes/screens-stats-block-operator-keys/specs/stats-block/spec.md#requirement-a-stats-block-filter-can-spell-its-operator-in-the-key\n * @param {string} key The filter key.\n * @return {string} The query parameter name.\n */\nexport function aggFilterParam(key) {\n\tconst match = OPERATOR_KEY.exec(key)\n\treturn match ? `filter[${match[1]}][${match[2]}]` : `filter[${key}]`\n}\n\n/**\n * Fetch one aggregated scalar from OpenRegister.\n *\n * @param {object} source The aggregate descriptor.\n * @param {string} source.register The register slug.\n * @param {string} source.schema The schema slug.\n * @param {string} [source.metric] count | sum | avg | min | max (default count).\n * @param {string} [source.field] The numeric field (required for non-count metrics).\n * @param {object} [source.filter] The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context (a detail page's object context) so the filter can\n *   scope to the current object via `@objectId` / `@object.<field>`.\n * @return {Promise<number|null>} The aggregated value, or null when unavailable.\n */\nexport async function fetchAggregateValue(source, ctx) {\n\tconst s = source || {}\n\tif (!s.register || !s.schema) {\n\t\treturn null\n\t}\n\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\timport('@nextcloud/axios'),\n\t\timport('@nextcloud/router'),\n\t])\n\tconst url = generateUrl(\n\t\t'/apps/openregister/api/objects/aggregations/{register}/{schema}/value',\n\t\t{ register: s.register, schema: s.schema },\n\t)\n\tconst params = { metric: s.metric || 'count' }\n\tif (s.field) {\n\t\tparams.field = s.field\n\t}\n\tflattenAggFilter(params, s.filter || {}, ctx)\n\tconst res = await axios.get(url, { params })\n\treturn (res && res.data && res.data.value !== undefined) ? res.data.value : null\n}\n\n/**\n * Fetch the object count per distinct value of one field, in ONE request,\n * from OpenRegister's `/grouped` aggregation endpoint.\n *\n * @param {object} source The grouped descriptor.\n * @param {string} source.register The register slug.\n * @param {string} source.schema The schema slug.\n * @param {string} source.groupBy The field to group on.\n * @param {object} [source.filter] The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context for the filter.\n * @return {Promise<Array<{key: string, count: number}>>} One entry per group; [] when the source is incomplete.\n * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-stacked-bar-widget\n */\nexport async function fetchGroupedCounts(source, ctx) {\n\tconst s = source || {}\n\tif (!s.register || !s.schema || !s.groupBy) {\n\t\treturn []\n\t}\n\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\timport('@nextcloud/axios'),\n\t\timport('@nextcloud/router'),\n\t])\n\tconst url = generateUrl(\n\t\t'/apps/openregister/api/objects/aggregations/{register}/{schema}/grouped',\n\t\t{ register: s.register, schema: s.schema },\n\t)\n\tconst params = { groupBy: s.groupBy, metric: 'count' }\n\tflattenAggFilter(params, s.filter || {}, ctx)\n\tconst res = await axios.get(url, { params })\n\tconst groups = (res && res.data && Array.isArray(res.data.groups)) ? res.data.groups : []\n\treturn groups\n\t\t.filter((g) => g && g.key !== null && g.key !== undefined && g.key !== '')\n\t\t.map((g) => ({ key: String(g.key), count: Number(g.value) || 0 }))\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/switchValues.js

@@ -0,0 +1,62 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * A switch's value map: what a switch reads as "on" and what it writes for on
+ * and off. Without a map a switch is a boolean, as before. With `values:
+ * { on, off }` it reads a field stored as `"1"`/`"0"` or `"true"`/`"false"`
+ * (an app config flag) and writes those values back.
+ *
+ * @module utils/switchValues
+ * @spec openspec/changes/screens-switch-value-map/specs/switch-rows/spec.md#requirement-a-switch-can-read-and-write-a-value-map
+ */
+
+/**
+ * The value map of a switch, or null when it has none (a boolean switch).
+ *
+ * @param {unknown} values The declared `values`.
+ * @return {{on: unknown, off: unknown}|null} The map.
+ */
+function switchValueMap(values) {
+	if (!values || typeof values !== 'object' || Array.isArray(values) || values.on === undefined) {
+		return null
+	}
+	return { on: values.on, off: values.off === undefined ? null : values.off }
+}
+
+/**
+ * Whether a stored value reads as "on". Without a map only `true` does; with
+ * one, the `on` value does, compared as text so `1` and `"1"` are the same.
+ *
+ * @param {unknown} stored The stored value.
+ * @param {unknown} values The declared `values`.
+ * @return {boolean} True when the switch shows on.
+ */
+function switchIsOn(stored, values) {
+	const map = switchValueMap(values);
+	if (!map) {
+		return stored === true
+	}
+	if (stored === undefined || stored === null) {
+		return false
+	}
+	return stored === map.on || String(stored) === String(map.on)
+}
+
+/**
+ * The value a switch writes for a state.
+ *
+ * @param {boolean} on The switch state.
+ * @param {unknown} values The declared `values`.
+ * @return {unknown} `true`/`false` without a map, else the map's `on` / `off`.
+ */
+function switchStoredValue(on, values) {
+	const map = switchValueMap(values);
+	if (!map) {
+		return on === true
+	}
+	return on ? map.on : map.off
+}
+
+export { switchIsOn, switchStoredValue, switchValueMap };
+//# sourceMappingURL=switchValues.js.map

package/dist/esm/utils/switchValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchValues.js","sources":["../../../src/utils/switchValues.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * A switch's value map: what a switch reads as \"on\" and what it writes for on\n * and off. Without a map a switch is a boolean, as before. With `values:\n * { on, off }` it reads a field stored as `\"1\"`/`\"0\"` or `\"true\"`/`\"false\"`\n * (an app config flag) and writes those values back.\n *\n * @module utils/switchValues\n * @spec openspec/changes/screens-switch-value-map/specs/switch-rows/spec.md#requirement-a-switch-can-read-and-write-a-value-map\n */\n\n/**\n * The value map of a switch, or null when it has none (a boolean switch).\n *\n * @param {unknown} values The declared `values`.\n * @return {{on: unknown, off: unknown}|null} The map.\n */\nexport function switchValueMap(values) {\n\tif (!values || typeof values !== 'object' || Array.isArray(values) || values.on === undefined) {\n\t\treturn null\n\t}\n\treturn { on: values.on, off: values.off === undefined ? null : values.off }\n}\n\n/**\n * Whether a stored value reads as \"on\". Without a map only `true` does; with\n * one, the `on` value does, compared as text so `1` and `\"1\"` are the same.\n *\n * @param {unknown} stored The stored value.\n * @param {unknown} values The declared `values`.\n * @return {boolean} True when the switch shows on.\n */\nexport function switchIsOn(stored, values) {\n\tconst map = switchValueMap(values)\n\tif (!map) {\n\t\treturn stored === true\n\t}\n\tif (stored === undefined || stored === null) {\n\t\treturn false\n\t}\n\treturn stored === map.on || String(stored) === String(map.on)\n}\n\n/**\n * The value a switch writes for a state.\n *\n * @param {boolean} on The switch state.\n * @param {unknown} values The declared `values`.\n * @return {unknown} `true`/`false` without a map, else the map's `on` / `off`.\n */\nexport function switchStoredValue(on, values) {\n\tconst map = switchValueMap(values)\n\tif (!map) {\n\t\treturn on === true\n\t}\n\treturn on ? map.on : map.off\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,MAAM,EAAE;AACvC,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,EAAE;AAChG,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;AAC5E,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE;AAC3C,CAAC,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,EAAC;AACnC,CAAC,IAAI,CAAC,GAAG,EAAE;AACX,EAAE,OAAO,MAAM,KAAK,IAAI;AACxB,EAAE;AACF,CAAC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE;AAC9C,EAAE,OAAO,KAAK;AACd,EAAE;AACF,CAAC,OAAO,MAAM,KAAK,GAAG,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAC9D,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE;AAC9C,CAAC,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,EAAC;AACnC,CAAC,IAAI,CAAC,GAAG,EAAE;AACX,EAAE,OAAO,EAAE,KAAK,IAAI;AACpB,EAAE;AACF,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG;AAC7B;;;;"}