@camstack/addon-smtp-nodemailer 1.2.14 → 1.2.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -12988,7 +12988,23 @@ var NotificationActionSchema = object({
12988
12988
  * else — see `notification-center/action-token.ts` for what that does and
12989
12989
  * does not buy.
12990
12990
  */
12991
- destructive: boolean().optional()
12991
+ destructive: boolean().optional(),
12992
+ /**
12993
+ * How the tap should REACH the url.
12994
+ *
12995
+ * `navigate` (absent, and every button authored before this field) opens it:
12996
+ * the phone leaves the notification and shows whatever the callback returns.
12997
+ * That is right for a button whose answer the operator wants to read.
12998
+ *
12999
+ * `background` fires it as a POST and stays put. It exists for the buttons
13000
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13001
+ * an answer to the notification, and being thrown into a browser tab to
13002
+ * confirm it costs more attention than the notification did. A backend that
13003
+ * cannot do a background call renders it as an ordinary link (the adapters
13004
+ * fall back rather than dropping the button), so this is a preference, never
13005
+ * a requirement.
13006
+ */
13007
+ mode: _enum(["navigate", "background"]).optional()
12992
13008
  });
12993
13009
  /**
12994
13010
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13989,6 +14005,9 @@ var NcSystemEventConditionSchema = object({
13989
14005
  nodeIds: array(string().min(1)).min(1).optional(),
13990
14006
  packageNames: array(string().min(1)).min(1).optional()
13991
14007
  });
14008
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14009
+ * outage the operator asked for once and forgot. */
14010
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13992
14011
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13993
14012
  var NcScheduleSchema = object({
13994
14013
  windows: array(object({
@@ -14365,15 +14384,15 @@ var NcConditionsSchema = object({
14365
14384
  * (an `immediate` rule naming an `audio-*` class, one notification per
14366
14385
  * classified sample) stays exactly as it was for rules that already use it.
14367
14386
  *
14368
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14369
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14370
- * (`camstack/src/data/notification-center.ts`, guarded by
14371
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14387
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14388
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14389
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14390
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14372
14391
  * condition fields it does not know when a rule is saved from the phone.
14373
14392
  * Publishing an editor for a condition the app cannot round-trip is how an
14374
- * operator loses a rule's conditions by opening it — so the descriptor, the
14375
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14376
- * does an audio rule become authorable.
14393
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14394
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14395
+ * follows here.
14377
14396
  */
14378
14397
  audio: NcAudioConditionSchema.optional()
14379
14398
  });
@@ -14609,6 +14628,30 @@ var NcRuleInputSchema = object({
14609
14628
  */
14610
14629
  snoozeAllowGlobal: boolean().optional(),
14611
14630
  /**
14631
+ * The snooze durations THIS rule's notification offers as buttons, in
14632
+ * minutes.
14633
+ *
14634
+ * Three states, and all three are distinct — which is exactly why this is
14635
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14636
+ * addon cap path (three production failures in one day), so a schema default
14637
+ * would collapse the first two:
14638
+ *
14639
+ * | value | meaning |
14640
+ * | --- | --- |
14641
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14642
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14643
+ * | a list | these choices, de-duplicated and sorted, at most four |
14644
+ *
14645
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14646
+ * three buttons in total) and a rule that spent it all on snooze choices
14647
+ * would push its own tap-through actions off the notification.
14648
+ *
14649
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14650
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14651
+ * window from anywhere (D133).
14652
+ */
14653
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14654
+ /**
14612
14655
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14613
14656
  *
14614
14657
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14708,6 +14751,7 @@ var NcConditionDescriptorSchema = object({
14708
14751
  "device",
14709
14752
  "package",
14710
14753
  "occupancy",
14754
+ "audio",
14711
14755
  "system"
14712
14756
  ]),
14713
14757
  label: string(),
@@ -14726,6 +14770,7 @@ var NcConditionDescriptorSchema = object({
14726
14770
  "crossingSelect",
14727
14771
  "polygonDraw",
14728
14772
  "occupancy",
14773
+ "audio",
14729
14774
  "deviceState",
14730
14775
  "systemEvent"
14731
14776
  ]),
@@ -14877,7 +14922,20 @@ var NcSnoozeInputSchema = object({
14877
14922
  ruleId: string().optional(),
14878
14923
  /** Required when `scope: 'device'`. */
14879
14924
  deviceId: number().int().optional(),
14880
- durationMinutes: number().int().min(1).max(1440),
14925
+ /**
14926
+ * Narrow the window to these subject classes — "the cat, not the person".
14927
+ *
14928
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14929
+ * what every window authored before this field meant, so no persisted row
14930
+ * changes meaning and no client has to learn anything to keep working.
14931
+ *
14932
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14933
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14934
+ * not at whichever of their four rules happened to produce the notification
14935
+ * they are dismissing.
14936
+ */
14937
+ classes: array(string().min(1)).min(1).optional(),
14938
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14881
14939
  /**
14882
14940
  * Silence this for EVERY recipient, not just the caller. Permission is
14883
14941
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14902,6 +14960,10 @@ var NcSnoozeSchema = object({
14902
14960
  scope: NcSnoozeScopeSchema,
14903
14961
  ruleId: string().optional(),
14904
14962
  deviceId: number().int().optional(),
14963
+ /** Subject classes this window covers. ABSENT = every class — see
14964
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14965
+ * no SQLite column: nothing queries a window by class. */
14966
+ classes: array(string().min(1)).min(1).optional(),
14905
14967
  startedAt: number(),
14906
14968
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14907
14969
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30487,6 +30549,7 @@ Object.freeze({
30487
30549
  "network-access": "ingress",
30488
30550
  "smtp-provider": "email"
30489
30551
  });
30552
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30490
30553
  new Set(["devices", "classes"]);
30491
30554
  /**
30492
30555
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -12986,7 +12986,23 @@ var NotificationActionSchema = object({
12986
12986
  * else — see `notification-center/action-token.ts` for what that does and
12987
12987
  * does not buy.
12988
12988
  */
12989
- destructive: boolean().optional()
12989
+ destructive: boolean().optional(),
12990
+ /**
12991
+ * How the tap should REACH the url.
12992
+ *
12993
+ * `navigate` (absent, and every button authored before this field) opens it:
12994
+ * the phone leaves the notification and shows whatever the callback returns.
12995
+ * That is right for a button whose answer the operator wants to read.
12996
+ *
12997
+ * `background` fires it as a POST and stays put. It exists for the buttons
12998
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
12999
+ * an answer to the notification, and being thrown into a browser tab to
13000
+ * confirm it costs more attention than the notification did. A backend that
13001
+ * cannot do a background call renders it as an ordinary link (the adapters
13002
+ * fall back rather than dropping the button), so this is a preference, never
13003
+ * a requirement.
13004
+ */
13005
+ mode: _enum(["navigate", "background"]).optional()
12990
13006
  });
12991
13007
  /**
12992
13008
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13987,6 +14003,9 @@ var NcSystemEventConditionSchema = object({
13987
14003
  nodeIds: array(string().min(1)).min(1).optional(),
13988
14004
  packageNames: array(string().min(1)).min(1).optional()
13989
14005
  });
14006
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14007
+ * outage the operator asked for once and forgot. */
14008
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13990
14009
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13991
14010
  var NcScheduleSchema = object({
13992
14011
  windows: array(object({
@@ -14363,15 +14382,15 @@ var NcConditionsSchema = object({
14363
14382
  * (an `immediate` rule naming an `audio-*` class, one notification per
14364
14383
  * classified sample) stays exactly as it was for rules that already use it.
14365
14384
  *
14366
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14367
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14368
- * (`camstack/src/data/notification-center.ts`, guarded by
14369
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14385
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14386
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14387
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14388
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14370
14389
  * condition fields it does not know when a rule is saved from the phone.
14371
14390
  * Publishing an editor for a condition the app cannot round-trip is how an
14372
- * operator loses a rule's conditions by opening it — so the descriptor, the
14373
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14374
- * does an audio rule become authorable.
14391
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14392
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14393
+ * follows here.
14375
14394
  */
14376
14395
  audio: NcAudioConditionSchema.optional()
14377
14396
  });
@@ -14607,6 +14626,30 @@ var NcRuleInputSchema = object({
14607
14626
  */
14608
14627
  snoozeAllowGlobal: boolean().optional(),
14609
14628
  /**
14629
+ * The snooze durations THIS rule's notification offers as buttons, in
14630
+ * minutes.
14631
+ *
14632
+ * Three states, and all three are distinct — which is exactly why this is
14633
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14634
+ * addon cap path (three production failures in one day), so a schema default
14635
+ * would collapse the first two:
14636
+ *
14637
+ * | value | meaning |
14638
+ * | --- | --- |
14639
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14640
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14641
+ * | a list | these choices, de-duplicated and sorted, at most four |
14642
+ *
14643
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14644
+ * three buttons in total) and a rule that spent it all on snooze choices
14645
+ * would push its own tap-through actions off the notification.
14646
+ *
14647
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14648
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14649
+ * window from anywhere (D133).
14650
+ */
14651
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14652
+ /**
14610
14653
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14611
14654
  *
14612
14655
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14706,6 +14749,7 @@ var NcConditionDescriptorSchema = object({
14706
14749
  "device",
14707
14750
  "package",
14708
14751
  "occupancy",
14752
+ "audio",
14709
14753
  "system"
14710
14754
  ]),
14711
14755
  label: string(),
@@ -14724,6 +14768,7 @@ var NcConditionDescriptorSchema = object({
14724
14768
  "crossingSelect",
14725
14769
  "polygonDraw",
14726
14770
  "occupancy",
14771
+ "audio",
14727
14772
  "deviceState",
14728
14773
  "systemEvent"
14729
14774
  ]),
@@ -14875,7 +14920,20 @@ var NcSnoozeInputSchema = object({
14875
14920
  ruleId: string().optional(),
14876
14921
  /** Required when `scope: 'device'`. */
14877
14922
  deviceId: number().int().optional(),
14878
- durationMinutes: number().int().min(1).max(1440),
14923
+ /**
14924
+ * Narrow the window to these subject classes — "the cat, not the person".
14925
+ *
14926
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14927
+ * what every window authored before this field meant, so no persisted row
14928
+ * changes meaning and no client has to learn anything to keep working.
14929
+ *
14930
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14931
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14932
+ * not at whichever of their four rules happened to produce the notification
14933
+ * they are dismissing.
14934
+ */
14935
+ classes: array(string().min(1)).min(1).optional(),
14936
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14879
14937
  /**
14880
14938
  * Silence this for EVERY recipient, not just the caller. Permission is
14881
14939
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14900,6 +14958,10 @@ var NcSnoozeSchema = object({
14900
14958
  scope: NcSnoozeScopeSchema,
14901
14959
  ruleId: string().optional(),
14902
14960
  deviceId: number().int().optional(),
14961
+ /** Subject classes this window covers. ABSENT = every class — see
14962
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14963
+ * no SQLite column: nothing queries a window by class. */
14964
+ classes: array(string().min(1)).min(1).optional(),
14903
14965
  startedAt: number(),
14904
14966
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14905
14967
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30485,6 +30547,7 @@ Object.freeze({
30485
30547
  "network-access": "ingress",
30486
30548
  "smtp-provider": "email"
30487
30549
  });
30550
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30488
30551
  new Set(["devices", "classes"]);
30489
30552
  /**
30490
30553
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-smtp-nodemailer",
3
- "version": "1.2.14",
3
+ "version": "1.2.15",
4
4
  "description": "SMTP email provider addon for CamStack — wraps `nodemailer` and registers a `smtp-provider` cap collection entry. Used by magic-link login + notifier addons.",
5
5
  "keywords": [
6
6
  "camstack",