@camstack/addon-notifiers 1.2.19 → 1.2.20

package/dist/addon.js

@@ -13141,7 +13141,23 @@ var NotificationActionSchema = object({
 	* else — see `notification-center/action-token.ts` for what that does and
 	* does not buy.
 	*/
-	destructive: boolean().optional()
+	destructive: boolean().optional(),
+	/**
+	* How the tap should REACH the url.
+	*
+	* `navigate` (absent, and every button authored before this field) opens it:
+	* the phone leaves the notification and shows whatever the callback returns.
+	* That is right for a button whose answer the operator wants to read.
+	*
+	* `background` fires it as a POST and stays put. It exists for the buttons
+	* whose whole point is not to interrupt — "silence this for 30 minutes" is
+	* an answer to the notification, and being thrown into a browser tab to
+	* confirm it costs more attention than the notification did. A backend that
+	* cannot do a background call renders it as an ordinary link (the adapters
+	* fall back rather than dropping the button), so this is a preference, never
+	* a requirement.
+	*/
+	mode: _enum(["navigate", "background"]).optional()
 });
 /**
 * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14156,6 +14172,9 @@ var NcSystemEventConditionSchema = object({
 	nodeIds: array(string().min(1)).min(1).optional(),
 	packageNames: array(string().min(1)).min(1).optional()
 });
+/** Hard ceiling on a window (24h). A snooze that could not expire would be an
+*  outage the operator asked for once and forgot. */
+var NC_SNOOZE_MAX_MINUTES = 1440;
 /** Weekly schedule — OR of windows; absence on the rule = always active. */
 var NcScheduleSchema = object({
 	windows: array(object({
@@ -14532,15 +14551,15 @@ var NcConditionsSchema = object({
 	* (an `immediate` rule naming an `audio-*` class, one notification per
 	* classified sample) stays exactly as it was for rules that already use it.
 	*
-	* NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
-	* rather than an oversight: the viewer mirrors the descriptor enums BY HAND
-	* (`camstack/src/data/notification-center.ts`, guarded by
-	* `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
+	* In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
+	* rule rather than an accident: the viewer mirrors the descriptor enums BY
+	* HAND (`camstack/src/data/notification-center.ts`, guarded by
+	* `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
 	* condition fields it does not know when a rule is saved from the phone.
 	* Publishing an editor for a condition the app cannot round-trip is how an
-	* operator loses a rule's conditions by opening it — so the descriptor, the
-	* admin widget and the viewer mirror land together (P2 + P3), and only then
-	* does an audio rule become authorable.
+	* operator loses a rule's conditions by opening it — so the viewer mirror
+	* (P3, shipped) went FIRST, and the descriptor an editor renders from
+	* follows here.
 	*/
 	audio: NcAudioConditionSchema.optional()
 });
@@ -14776,6 +14795,30 @@ var NcRuleInputSchema = object({
 	*/
 	snoozeAllowGlobal: boolean().optional(),
 	/**
+	* The snooze durations THIS rule's notification offers as buttons, in
+	* minutes.
+	*
+	* Three states, and all three are distinct — which is exactly why this is
+	* `.optional()` and never `.default()`. A Zod default does not run on the
+	* addon cap path (three production failures in one day), so a schema default
+	* would collapse the first two:
+	*
+	* | value | meaning |
+	* | --- | --- |
+	* | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
+	* | `[]` | **no snooze buttons on this rule** — the explicit override |
+	* | a list | these choices, de-duplicated and sorted, at most four |
+	*
+	* `.max(4)` because the notifier's own action budget is small (ntfy allows
+	* three buttons in total) and a rule that spent it all on snooze choices
+	* would push its own tap-through actions off the notification.
+	*
+	* An empty list is NOT an alarm exemption: a rule the alarm is about, or
+	* that arms the panel, is exempt automatically and cannot be silenced by a
+	* window from anywhere (D133).
+	*/
+	snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
+	/**
 	* Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
 	*
 	* This is what makes the rule set the alarm's trigger set without the alarm
@@ -14875,6 +14918,7 @@ var NcConditionDescriptorSchema = object({
 		"device",
 		"package",
 		"occupancy",
+		"audio",
 		"system"
 	]),
 	label: string(),
@@ -14893,6 +14937,7 @@ var NcConditionDescriptorSchema = object({
 		"crossingSelect",
 		"polygonDraw",
 		"occupancy",
+		"audio",
 		"deviceState",
 		"systemEvent"
 	]),
@@ -15044,7 +15089,20 @@ var NcSnoozeInputSchema = object({
 	ruleId: string().optional(),
 	/** Required when `scope: 'device'`. */
 	deviceId: number().int().optional(),
-	durationMinutes: number().int().min(1).max(1440),
+	/**
+	* Narrow the window to these subject classes — "the cat, not the person".
+	*
+	* ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
+	* what every window authored before this field meant, so no persisted row
+	* changes meaning and no client has to learn anything to keep working.
+	*
+	* It is what makes the window's real key `(deviceId, classes[])` and lets it
+	* cross rules (D133): the operator points at a camera and a kind of thing,
+	* not at whichever of their four rules happened to produce the notification
+	* they are dismissing.
+	*/
+	classes: array(string().min(1)).min(1).optional(),
+	durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
 	/**
 	* Silence this for EVERY recipient, not just the caller. Permission is
 	* checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15069,6 +15127,10 @@ var NcSnoozeSchema = object({
 	scope: NcSnoozeScopeSchema,
 	ruleId: string().optional(),
 	deviceId: number().int().optional(),
+	/** Subject classes this window covers. ABSENT = every class — see
+	*  {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
+	*  no SQLite column: nothing queries a window by class. */
+	classes: array(string().min(1)).min(1).optional(),
 	startedAt: number(),
 	/** Exclusive: at exactly this instant the snooze is over. Expiry is a
 	*  COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30641,6 +30703,7 @@ Object.freeze({
 	"network-access": "ingress",
 	"smtp-provider": "email"
 });
+new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
 new Set(["devices", "classes"]);
 /** Strip a small, safe subset of Markdown down to plain text. */
 function markdownToText(md) {
@@ -32221,11 +32284,24 @@ function nativePriority$1(prepared) {
 }
 function viewActions(prepared) {
 	const out = [];
-	for (const action of prepared.actions.slice(0, MAX_ACTIONS$1)) if (action.url !== void 0 && action.url.length > 0) out.push({
-		action: "view",
-		label: action.label,
-		url: action.url
-	});
+	for (const action of prepared.actions.slice(0, MAX_ACTIONS$1)) {
+		if (action.url === void 0 || action.url.length === 0) continue;
+		if (action.mode === "background") {
+			out.push({
+				action: "http",
+				label: action.label,
+				url: action.url,
+				method: "POST",
+				clear: true
+			});
+			continue;
+		}
+		out.push({
+			action: "view",
+			label: action.label,
+			url: action.url
+		});
+	}
 	return out;
 }
 /** The single attachment (caps.max = 1), if any. */
@@ -32280,7 +32356,7 @@ function buildUploadRequest(config, prepared, attachment) {
 	if (tags.length > 0) headers["x-tags"] = tags.join(",");
 	if (prepared.clickUrl !== null) headers["x-click"] = prepared.clickUrl;
 	if (attachment.name !== void 0) headers["x-filename"] = attachment.name;
-	if (actions.length > 0) headers["x-actions"] = actions.map((a) => `view, ${a.label}, ${a.url}`).join("; ");
+	if (actions.length > 0) headers["x-actions"] = actions.map((a) => a.action === "http" ? `http, ${a.label}, ${a.url}, method=POST, clear=true` : `view, ${a.label}, ${a.url}`).join("; ");
 	return {
 		url: `${serverUrl}/${topic}`,
 		method: "PUT",
@@ -33539,17 +33615,46 @@ function userIdsFrom(config) {
 	if (typeof raw === "string") return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
 	return [];
 }
+/**
+* How a `BACKGROUND_CALL` names its request: `METHOD::url`.
+*
+* The whole reason the type exists here: a "silence this for 30 minutes"
+* button that opens a browser tab has already cost more attention than the
+* notification it was dismissing. `BACKGROUND_CALL` fires the callback and
+* leaves the phone where it is.
+*/
+var BACKGROUND_CALL_PREFIX = "POST::";
 function actionsFor(prepared) {
 	const out = [];
-	for (const action of prepared.actions.slice(0, MAX_ACTIONS)) if (action.url !== void 0 && action.url.length > 0) out.push({
-		type: "NAVIGATE",
-		title: action.label,
-		value: action.url
-	});
-	else out.push({
-		type: "OPEN_NOTIFICATION",
-		title: action.label
-	});
+	for (const action of prepared.actions.slice(0, MAX_ACTIONS)) {
+		const decoration = {
+			...action.destructive !== void 0 ? { destructive: action.destructive } : {},
+			...action.icon !== void 0 ? { icon: action.icon } : {}
+		};
+		if (action.url === void 0 || action.url.length === 0) {
+			out.push({
+				type: "OPEN_NOTIFICATION",
+				title: action.label,
+				...decoration
+			});
+			continue;
+		}
+		if (action.mode === "background") {
+			out.push({
+				type: "BACKGROUND_CALL",
+				title: action.label,
+				value: `${BACKGROUND_CALL_PREFIX}${action.url}`,
+				...decoration
+			});
+			continue;
+		}
+		out.push({
+			type: "NAVIGATE",
+			title: action.label,
+			value: action.url,
+			...decoration
+		});
+	}
 	return out;
 }
 function attachmentsFor(prepared) {
@@ -33715,6 +33820,15 @@ var zentikAdapter = {
 			],
 			format: ["text"],
 			clickUrl: true,
+			/**
+			* `NotificationActionDto.icon` is a documented field, so the engine hands
+			* the icon over instead of stripping it centrally. What Zentik's client
+			* DRAWS for a given name is not documented — so the intent name travels
+			* verbatim, exactly as the webhook kind forwards it, and a name the app
+			* does not know renders as no icon rather than as a wrong one. This is a
+			* pass-through claim, not a rendering claim.
+			*/
+			actionIcons: true,
 			sound: true,
 			ttl: true,
 			bodyMaxLen: BODY_MAX_LEN

package/dist/addon.mjs

@@ -13114,7 +13114,23 @@ var NotificationActionSchema = object({
 	* else — see `notification-center/action-token.ts` for what that does and
 	* does not buy.
 	*/
-	destructive: boolean().optional()
+	destructive: boolean().optional(),
+	/**
+	* How the tap should REACH the url.
+	*
+	* `navigate` (absent, and every button authored before this field) opens it:
+	* the phone leaves the notification and shows whatever the callback returns.
+	* That is right for a button whose answer the operator wants to read.
+	*
+	* `background` fires it as a POST and stays put. It exists for the buttons
+	* whose whole point is not to interrupt — "silence this for 30 minutes" is
+	* an answer to the notification, and being thrown into a browser tab to
+	* confirm it costs more attention than the notification did. A backend that
+	* cannot do a background call renders it as an ordinary link (the adapters
+	* fall back rather than dropping the button), so this is a preference, never
+	* a requirement.
+	*/
+	mode: _enum(["navigate", "background"]).optional()
 });
 /**
 * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14129,6 +14145,9 @@ var NcSystemEventConditionSchema = object({
 	nodeIds: array(string().min(1)).min(1).optional(),
 	packageNames: array(string().min(1)).min(1).optional()
 });
+/** Hard ceiling on a window (24h). A snooze that could not expire would be an
+*  outage the operator asked for once and forgot. */
+var NC_SNOOZE_MAX_MINUTES = 1440;
 /** Weekly schedule — OR of windows; absence on the rule = always active. */
 var NcScheduleSchema = object({
 	windows: array(object({
@@ -14505,15 +14524,15 @@ var NcConditionsSchema = object({
 	* (an `immediate` rule naming an `audio-*` class, one notification per
 	* classified sample) stays exactly as it was for rules that already use it.
 	*
-	* NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
-	* rather than an oversight: the viewer mirrors the descriptor enums BY HAND
-	* (`camstack/src/data/notification-center.ts`, guarded by
-	* `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
+	* In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
+	* rule rather than an accident: the viewer mirrors the descriptor enums BY
+	* HAND (`camstack/src/data/notification-center.ts`, guarded by
+	* `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
 	* condition fields it does not know when a rule is saved from the phone.
 	* Publishing an editor for a condition the app cannot round-trip is how an
-	* operator loses a rule's conditions by opening it — so the descriptor, the
-	* admin widget and the viewer mirror land together (P2 + P3), and only then
-	* does an audio rule become authorable.
+	* operator loses a rule's conditions by opening it — so the viewer mirror
+	* (P3, shipped) went FIRST, and the descriptor an editor renders from
+	* follows here.
 	*/
 	audio: NcAudioConditionSchema.optional()
 });
@@ -14749,6 +14768,30 @@ var NcRuleInputSchema = object({
 	*/
 	snoozeAllowGlobal: boolean().optional(),
 	/**
+	* The snooze durations THIS rule's notification offers as buttons, in
+	* minutes.
+	*
+	* Three states, and all three are distinct — which is exactly why this is
+	* `.optional()` and never `.default()`. A Zod default does not run on the
+	* addon cap path (three production failures in one day), so a schema default
+	* would collapse the first two:
+	*
+	* | value | meaning |
+	* | --- | --- |
+	* | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
+	* | `[]` | **no snooze buttons on this rule** — the explicit override |
+	* | a list | these choices, de-duplicated and sorted, at most four |
+	*
+	* `.max(4)` because the notifier's own action budget is small (ntfy allows
+	* three buttons in total) and a rule that spent it all on snooze choices
+	* would push its own tap-through actions off the notification.
+	*
+	* An empty list is NOT an alarm exemption: a rule the alarm is about, or
+	* that arms the panel, is exempt automatically and cannot be silenced by a
+	* window from anywhere (D133).
+	*/
+	snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
+	/**
 	* Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
 	*
 	* This is what makes the rule set the alarm's trigger set without the alarm
@@ -14848,6 +14891,7 @@ var NcConditionDescriptorSchema = object({
 		"device",
 		"package",
 		"occupancy",
+		"audio",
 		"system"
 	]),
 	label: string(),
@@ -14866,6 +14910,7 @@ var NcConditionDescriptorSchema = object({
 		"crossingSelect",
 		"polygonDraw",
 		"occupancy",
+		"audio",
 		"deviceState",
 		"systemEvent"
 	]),
@@ -15017,7 +15062,20 @@ var NcSnoozeInputSchema = object({
 	ruleId: string().optional(),
 	/** Required when `scope: 'device'`. */
 	deviceId: number().int().optional(),
-	durationMinutes: number().int().min(1).max(1440),
+	/**
+	* Narrow the window to these subject classes — "the cat, not the person".
+	*
+	* ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
+	* what every window authored before this field meant, so no persisted row
+	* changes meaning and no client has to learn anything to keep working.
+	*
+	* It is what makes the window's real key `(deviceId, classes[])` and lets it
+	* cross rules (D133): the operator points at a camera and a kind of thing,
+	* not at whichever of their four rules happened to produce the notification
+	* they are dismissing.
+	*/
+	classes: array(string().min(1)).min(1).optional(),
+	durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
 	/**
 	* Silence this for EVERY recipient, not just the caller. Permission is
 	* checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15042,6 +15100,10 @@ var NcSnoozeSchema = object({
 	scope: NcSnoozeScopeSchema,
 	ruleId: string().optional(),
 	deviceId: number().int().optional(),
+	/** Subject classes this window covers. ABSENT = every class — see
+	*  {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
+	*  no SQLite column: nothing queries a window by class. */
+	classes: array(string().min(1)).min(1).optional(),
 	startedAt: number(),
 	/** Exclusive: at exactly this instant the snooze is over. Expiry is a
 	*  COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30614,6 +30676,7 @@ Object.freeze({
 	"network-access": "ingress",
 	"smtp-provider": "email"
 });
+new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
 new Set(["devices", "classes"]);
 /** Strip a small, safe subset of Markdown down to plain text. */
 function markdownToText(md) {
@@ -32194,11 +32257,24 @@ function nativePriority$1(prepared) {
 }
 function viewActions(prepared) {
 	const out = [];
-	for (const action of prepared.actions.slice(0, MAX_ACTIONS$1)) if (action.url !== void 0 && action.url.length > 0) out.push({
-		action: "view",
-		label: action.label,
-		url: action.url
-	});
+	for (const action of prepared.actions.slice(0, MAX_ACTIONS$1)) {
+		if (action.url === void 0 || action.url.length === 0) continue;
+		if (action.mode === "background") {
+			out.push({
+				action: "http",
+				label: action.label,
+				url: action.url,
+				method: "POST",
+				clear: true
+			});
+			continue;
+		}
+		out.push({
+			action: "view",
+			label: action.label,
+			url: action.url
+		});
+	}
 	return out;
 }
 /** The single attachment (caps.max = 1), if any. */
@@ -32253,7 +32329,7 @@ function buildUploadRequest(config, prepared, attachment) {
 	if (tags.length > 0) headers["x-tags"] = tags.join(",");
 	if (prepared.clickUrl !== null) headers["x-click"] = prepared.clickUrl;
 	if (attachment.name !== void 0) headers["x-filename"] = attachment.name;
-	if (actions.length > 0) headers["x-actions"] = actions.map((a) => `view, ${a.label}, ${a.url}`).join("; ");
+	if (actions.length > 0) headers["x-actions"] = actions.map((a) => a.action === "http" ? `http, ${a.label}, ${a.url}, method=POST, clear=true` : `view, ${a.label}, ${a.url}`).join("; ");
 	return {
 		url: `${serverUrl}/${topic}`,
 		method: "PUT",
@@ -33512,17 +33588,46 @@ function userIdsFrom(config) {
 	if (typeof raw === "string") return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
 	return [];
 }
+/**
+* How a `BACKGROUND_CALL` names its request: `METHOD::url`.
+*
+* The whole reason the type exists here: a "silence this for 30 minutes"
+* button that opens a browser tab has already cost more attention than the
+* notification it was dismissing. `BACKGROUND_CALL` fires the callback and
+* leaves the phone where it is.
+*/
+var BACKGROUND_CALL_PREFIX = "POST::";
 function actionsFor(prepared) {
 	const out = [];
-	for (const action of prepared.actions.slice(0, MAX_ACTIONS)) if (action.url !== void 0 && action.url.length > 0) out.push({
-		type: "NAVIGATE",
-		title: action.label,
-		value: action.url
-	});
-	else out.push({
-		type: "OPEN_NOTIFICATION",
-		title: action.label
-	});
+	for (const action of prepared.actions.slice(0, MAX_ACTIONS)) {
+		const decoration = {
+			...action.destructive !== void 0 ? { destructive: action.destructive } : {},
+			...action.icon !== void 0 ? { icon: action.icon } : {}
+		};
+		if (action.url === void 0 || action.url.length === 0) {
+			out.push({
+				type: "OPEN_NOTIFICATION",
+				title: action.label,
+				...decoration
+			});
+			continue;
+		}
+		if (action.mode === "background") {
+			out.push({
+				type: "BACKGROUND_CALL",
+				title: action.label,
+				value: `${BACKGROUND_CALL_PREFIX}${action.url}`,
+				...decoration
+			});
+			continue;
+		}
+		out.push({
+			type: "NAVIGATE",
+			title: action.label,
+			value: action.url,
+			...decoration
+		});
+	}
 	return out;
 }
 function attachmentsFor(prepared) {
@@ -33688,6 +33793,15 @@ var zentikAdapter = {
 			],
 			format: ["text"],
 			clickUrl: true,
+			/**
+			* `NotificationActionDto.icon` is a documented field, so the engine hands
+			* the icon over instead of stripping it centrally. What Zentik's client
+			* DRAWS for a given name is not documented — so the intent name travels
+			* verbatim, exactly as the webhook kind forwards it, and a name the app
+			* does not know renders as no icon rather than as a wrong one. This is a
+			* pass-through claim, not a rendering claim.
+			*/
+			actionIcons: true,
 			sound: true,
 			ttl: true,
 			bodyMaxLen: BODY_MAX_LEN

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-notifiers",
-  "version": "1.2.19",
+  "version": "1.2.20",
   "description": "System notifiers addon for CamStack — a `notification-output` collection provider hosting per-kind notifier adapters (ntfy, pushover, gotify, telegram, discord, webhook, zentik).",
   "keywords": [
     "camstack",