@camstack/addon-export-alexa 1.2.19 → 1.2.20

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.
@@ -13262,7 +13262,23 @@ var NotificationActionSchema = object({
13262
13262
  * else — see `notification-center/action-token.ts` for what that does and
13263
13263
  * does not buy.
13264
13264
  */
13265
- destructive: boolean().optional()
13265
+ destructive: boolean().optional(),
13266
+ /**
13267
+ * How the tap should REACH the url.
13268
+ *
13269
+ * `navigate` (absent, and every button authored before this field) opens it:
13270
+ * the phone leaves the notification and shows whatever the callback returns.
13271
+ * That is right for a button whose answer the operator wants to read.
13272
+ *
13273
+ * `background` fires it as a POST and stays put. It exists for the buttons
13274
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13275
+ * an answer to the notification, and being thrown into a browser tab to
13276
+ * confirm it costs more attention than the notification did. A backend that
13277
+ * cannot do a background call renders it as an ordinary link (the adapters
13278
+ * fall back rather than dropping the button), so this is a preference, never
13279
+ * a requirement.
13280
+ */
13281
+ mode: _enum(["navigate", "background"]).optional()
13266
13282
  });
13267
13283
  /**
13268
13284
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14263,6 +14279,9 @@ var NcSystemEventConditionSchema = object({
14263
14279
  nodeIds: array(string().min(1)).min(1).optional(),
14264
14280
  packageNames: array(string().min(1)).min(1).optional()
14265
14281
  });
14282
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14283
+ * outage the operator asked for once and forgot. */
14284
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14266
14285
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14267
14286
  var NcScheduleSchema = object({
14268
14287
  windows: array(object({
@@ -14639,15 +14658,15 @@ var NcConditionsSchema = object({
14639
14658
  * (an `immediate` rule naming an `audio-*` class, one notification per
14640
14659
  * classified sample) stays exactly as it was for rules that already use it.
14641
14660
  *
14642
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14643
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14644
- * (`camstack/src/data/notification-center.ts`, guarded by
14645
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14661
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14662
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14663
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14664
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14646
14665
  * condition fields it does not know when a rule is saved from the phone.
14647
14666
  * Publishing an editor for a condition the app cannot round-trip is how an
14648
- * operator loses a rule's conditions by opening it — so the descriptor, the
14649
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14650
- * does an audio rule become authorable.
14667
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14668
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14669
+ * follows here.
14651
14670
  */
14652
14671
  audio: NcAudioConditionSchema.optional()
14653
14672
  });
@@ -14883,6 +14902,30 @@ var NcRuleInputSchema = object({
14883
14902
  */
14884
14903
  snoozeAllowGlobal: boolean().optional(),
14885
14904
  /**
14905
+ * The snooze durations THIS rule's notification offers as buttons, in
14906
+ * minutes.
14907
+ *
14908
+ * Three states, and all three are distinct — which is exactly why this is
14909
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14910
+ * addon cap path (three production failures in one day), so a schema default
14911
+ * would collapse the first two:
14912
+ *
14913
+ * | value | meaning |
14914
+ * | --- | --- |
14915
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14916
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14917
+ * | a list | these choices, de-duplicated and sorted, at most four |
14918
+ *
14919
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14920
+ * three buttons in total) and a rule that spent it all on snooze choices
14921
+ * would push its own tap-through actions off the notification.
14922
+ *
14923
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14924
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14925
+ * window from anywhere (D133).
14926
+ */
14927
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14928
+ /**
14886
14929
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14887
14930
  *
14888
14931
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14982,6 +15025,7 @@ var NcConditionDescriptorSchema = object({
14982
15025
  "device",
14983
15026
  "package",
14984
15027
  "occupancy",
15028
+ "audio",
14985
15029
  "system"
14986
15030
  ]),
14987
15031
  label: string(),
@@ -15000,6 +15044,7 @@ var NcConditionDescriptorSchema = object({
15000
15044
  "crossingSelect",
15001
15045
  "polygonDraw",
15002
15046
  "occupancy",
15047
+ "audio",
15003
15048
  "deviceState",
15004
15049
  "systemEvent"
15005
15050
  ]),
@@ -15151,7 +15196,20 @@ var NcSnoozeInputSchema = object({
15151
15196
  ruleId: string().optional(),
15152
15197
  /** Required when `scope: 'device'`. */
15153
15198
  deviceId: number().int().optional(),
15154
- durationMinutes: number().int().min(1).max(1440),
15199
+ /**
15200
+ * Narrow the window to these subject classes — "the cat, not the person".
15201
+ *
15202
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15203
+ * what every window authored before this field meant, so no persisted row
15204
+ * changes meaning and no client has to learn anything to keep working.
15205
+ *
15206
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15207
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15208
+ * not at whichever of their four rules happened to produce the notification
15209
+ * they are dismissing.
15210
+ */
15211
+ classes: array(string().min(1)).min(1).optional(),
15212
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15155
15213
  /**
15156
15214
  * Silence this for EVERY recipient, not just the caller. Permission is
15157
15215
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15176,6 +15234,10 @@ var NcSnoozeSchema = object({
15176
15234
  scope: NcSnoozeScopeSchema,
15177
15235
  ruleId: string().optional(),
15178
15236
  deviceId: number().int().optional(),
15237
+ /** Subject classes this window covers. ABSENT = every class — see
15238
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15239
+ * no SQLite column: nothing queries a window by class. */
15240
+ classes: array(string().min(1)).min(1).optional(),
15179
15241
  startedAt: number(),
15180
15242
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15181
15243
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30754,6 +30816,7 @@ Object.freeze({
30754
30816
  "network-access": "ingress",
30755
30817
  "smtp-provider": "email"
30756
30818
  });
30819
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30757
30820
  new Set(["devices", "classes"]);
30758
30821
  /**
30759
30822
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -13235,7 +13235,23 @@ var NotificationActionSchema = object({
13235
13235
  * else — see `notification-center/action-token.ts` for what that does and
13236
13236
  * does not buy.
13237
13237
  */
13238
- destructive: boolean().optional()
13238
+ destructive: boolean().optional(),
13239
+ /**
13240
+ * How the tap should REACH the url.
13241
+ *
13242
+ * `navigate` (absent, and every button authored before this field) opens it:
13243
+ * the phone leaves the notification and shows whatever the callback returns.
13244
+ * That is right for a button whose answer the operator wants to read.
13245
+ *
13246
+ * `background` fires it as a POST and stays put. It exists for the buttons
13247
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13248
+ * an answer to the notification, and being thrown into a browser tab to
13249
+ * confirm it costs more attention than the notification did. A backend that
13250
+ * cannot do a background call renders it as an ordinary link (the adapters
13251
+ * fall back rather than dropping the button), so this is a preference, never
13252
+ * a requirement.
13253
+ */
13254
+ mode: _enum(["navigate", "background"]).optional()
13239
13255
  });
13240
13256
  /**
13241
13257
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -14236,6 +14252,9 @@ var NcSystemEventConditionSchema = object({
14236
14252
  nodeIds: array(string().min(1)).min(1).optional(),
14237
14253
  packageNames: array(string().min(1)).min(1).optional()
14238
14254
  });
14255
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14256
+ * outage the operator asked for once and forgot. */
14257
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14239
14258
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14240
14259
  var NcScheduleSchema = object({
14241
14260
  windows: array(object({
@@ -14612,15 +14631,15 @@ var NcConditionsSchema = object({
14612
14631
  * (an `immediate` rule naming an `audio-*` class, one notification per
14613
14632
  * classified sample) stays exactly as it was for rules that already use it.
14614
14633
  *
14615
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14616
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14617
- * (`camstack/src/data/notification-center.ts`, guarded by
14618
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14634
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14635
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14636
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14637
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14619
14638
  * condition fields it does not know when a rule is saved from the phone.
14620
14639
  * Publishing an editor for a condition the app cannot round-trip is how an
14621
- * operator loses a rule's conditions by opening it — so the descriptor, the
14622
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14623
- * does an audio rule become authorable.
14640
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14641
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14642
+ * follows here.
14624
14643
  */
14625
14644
  audio: NcAudioConditionSchema.optional()
14626
14645
  });
@@ -14856,6 +14875,30 @@ var NcRuleInputSchema = object({
14856
14875
  */
14857
14876
  snoozeAllowGlobal: boolean().optional(),
14858
14877
  /**
14878
+ * The snooze durations THIS rule's notification offers as buttons, in
14879
+ * minutes.
14880
+ *
14881
+ * Three states, and all three are distinct — which is exactly why this is
14882
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14883
+ * addon cap path (three production failures in one day), so a schema default
14884
+ * would collapse the first two:
14885
+ *
14886
+ * | value | meaning |
14887
+ * | --- | --- |
14888
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14889
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14890
+ * | a list | these choices, de-duplicated and sorted, at most four |
14891
+ *
14892
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14893
+ * three buttons in total) and a rule that spent it all on snooze choices
14894
+ * would push its own tap-through actions off the notification.
14895
+ *
14896
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14897
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14898
+ * window from anywhere (D133).
14899
+ */
14900
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14901
+ /**
14859
14902
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14860
14903
  *
14861
14904
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14955,6 +14998,7 @@ var NcConditionDescriptorSchema = object({
14955
14998
  "device",
14956
14999
  "package",
14957
15000
  "occupancy",
15001
+ "audio",
14958
15002
  "system"
14959
15003
  ]),
14960
15004
  label: string(),
@@ -14973,6 +15017,7 @@ var NcConditionDescriptorSchema = object({
14973
15017
  "crossingSelect",
14974
15018
  "polygonDraw",
14975
15019
  "occupancy",
15020
+ "audio",
14976
15021
  "deviceState",
14977
15022
  "systemEvent"
14978
15023
  ]),
@@ -15124,7 +15169,20 @@ var NcSnoozeInputSchema = object({
15124
15169
  ruleId: string().optional(),
15125
15170
  /** Required when `scope: 'device'`. */
15126
15171
  deviceId: number().int().optional(),
15127
- durationMinutes: number().int().min(1).max(1440),
15172
+ /**
15173
+ * Narrow the window to these subject classes — "the cat, not the person".
15174
+ *
15175
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15176
+ * what every window authored before this field meant, so no persisted row
15177
+ * changes meaning and no client has to learn anything to keep working.
15178
+ *
15179
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15180
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15181
+ * not at whichever of their four rules happened to produce the notification
15182
+ * they are dismissing.
15183
+ */
15184
+ classes: array(string().min(1)).min(1).optional(),
15185
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15128
15186
  /**
15129
15187
  * Silence this for EVERY recipient, not just the caller. Permission is
15130
15188
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15149,6 +15207,10 @@ var NcSnoozeSchema = object({
15149
15207
  scope: NcSnoozeScopeSchema,
15150
15208
  ruleId: string().optional(),
15151
15209
  deviceId: number().int().optional(),
15210
+ /** Subject classes this window covers. ABSENT = every class — see
15211
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15212
+ * no SQLite column: nothing queries a window by class. */
15213
+ classes: array(string().min(1)).min(1).optional(),
15152
15214
  startedAt: number(),
15153
15215
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15154
15216
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30727,6 +30789,7 @@ Object.freeze({
30727
30789
  "network-access": "ingress",
30728
30790
  "smtp-provider": "email"
30729
30791
  });
30792
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30730
30793
  new Set(["devices", "classes"]);
30731
30794
  /**
30732
30795
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-alexa",
3
- "version": "1.2.19",
3
+ "version": "1.2.20",
4
4
  "description": "Alexa Smart Home Skill export — hub-side OAuth provider + directive handler. The companion AWS Lambda forwards Alexa directives to this addon's /addon/export-alexa/directive endpoint.",
5
5
  "keywords": [
6
6
  "camstack",