@camstack/addon-export-alexa 1.2.19 → 1.2.21

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.
@@ -13232,11 +13232,33 @@ var NotificationFormatSchema = _enum([
13232
13232
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
13233
13233
  * renderer's icon set; "acknowledge" survives an adapter that draws it
13234
13234
  * differently.
13235
+ *
13236
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
13237
+ *
13238
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
13239
+ * the whole set onto its own renderer's vocabulary through a
13240
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
13241
+ * fallback, so adding a member here fails every adapter's build until someone
13242
+ * decides its glyph, which is the only place that decision can be made
13243
+ * honestly.
13244
+ *
13245
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
13246
+ * `disarm` straight through; iOS feeds that string to
13247
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
13248
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
13249
+ * mapping, and "the field is documented" is not "the value renders".
13250
+ *
13251
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
13252
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
13253
+ * so an addon that emits a token the running hub does not know does not lose an
13254
+ * icon — its whole `send` fails Zod validation and the notification never
13255
+ * arrives. Never emit a new token from an addon before the train carrying it.
13235
13256
  */
13236
13257
  var NotificationActionIconSchema = _enum([
13237
13258
  "acknowledge",
13238
13259
  "dismiss",
13239
13260
  "silence",
13261
+ "snooze",
13240
13262
  "view",
13241
13263
  "play",
13242
13264
  "open",
@@ -13244,9 +13266,13 @@ var NotificationActionIconSchema = _enum([
13244
13266
  "lock",
13245
13267
  "unlock",
13246
13268
  "arm",
13269
+ "arm-home",
13270
+ "arm-away",
13271
+ "arm-night",
13247
13272
  "disarm",
13248
13273
  "light",
13249
- "alert"
13274
+ "alert",
13275
+ "camera"
13250
13276
  ]);
13251
13277
  /** A single tap-through action button. */
13252
13278
  var NotificationActionSchema = object({
@@ -13262,7 +13288,23 @@ var NotificationActionSchema = object({
13262
13288
  * else — see `notification-center/action-token.ts` for what that does and
13263
13289
  * does not buy.
13264
13290
  */
13265
- destructive: boolean().optional()
13291
+ destructive: boolean().optional(),
13292
+ /**
13293
+ * How the tap should REACH the url.
13294
+ *
13295
+ * `navigate` (absent, and every button authored before this field) opens it:
13296
+ * the phone leaves the notification and shows whatever the callback returns.
13297
+ * That is right for a button whose answer the operator wants to read.
13298
+ *
13299
+ * `background` fires it as a POST and stays put. It exists for the buttons
13300
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13301
+ * an answer to the notification, and being thrown into a browser tab to
13302
+ * confirm it costs more attention than the notification did. A backend that
13303
+ * cannot do a background call renders it as an ordinary link (the adapters
13304
+ * fall back rather than dropping the button), so this is a preference, never
13305
+ * a requirement.
13306
+ */
13307
+ mode: _enum(["navigate", "background"]).optional()
13266
13308
  });
13267
13309
  /**
13268
13310
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13430,6 +13472,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13430
13472
  targetId: string(),
13431
13473
  enabled: boolean()
13432
13474
  }), _void(), { kind: "mutation" });
13475
+ new Set([
13476
+ {
13477
+ id: "person",
13478
+ name: "Person"
13479
+ },
13480
+ {
13481
+ id: "vehicle",
13482
+ name: "Vehicle"
13483
+ },
13484
+ {
13485
+ id: "animal",
13486
+ name: "Animal"
13487
+ },
13488
+ {
13489
+ id: "package",
13490
+ name: "Package"
13491
+ }
13492
+ ].map((l) => l.id));
13433
13493
  var COCO_TO_MACRO = {
13434
13494
  mapping: {
13435
13495
  person: "person",
@@ -14227,6 +14287,8 @@ var NcSystemEventKindSchema = _enum([
14227
14287
  "alarm-triggered",
14228
14288
  "alarm-armed",
14229
14289
  "alarm-disarmed",
14290
+ "alarm-arming",
14291
+ "alarm-arm-refused",
14230
14292
  "camera-online",
14231
14293
  "camera-offline",
14232
14294
  "camera-disabled",
@@ -14263,6 +14325,9 @@ var NcSystemEventConditionSchema = object({
14263
14325
  nodeIds: array(string().min(1)).min(1).optional(),
14264
14326
  packageNames: array(string().min(1)).min(1).optional()
14265
14327
  });
14328
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14329
+ * outage the operator asked for once and forgot. */
14330
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14266
14331
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14267
14332
  var NcScheduleSchema = object({
14268
14333
  windows: array(object({
@@ -14639,15 +14704,15 @@ var NcConditionsSchema = object({
14639
14704
  * (an `immediate` rule naming an `audio-*` class, one notification per
14640
14705
  * classified sample) stays exactly as it was for rules that already use it.
14641
14706
  *
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
14707
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14708
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14709
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14710
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14646
14711
  * condition fields it does not know when a rule is saved from the phone.
14647
14712
  * 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.
14713
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14714
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14715
+ * follows here.
14651
14716
  */
14652
14717
  audio: NcAudioConditionSchema.optional()
14653
14718
  });
@@ -14883,6 +14948,30 @@ var NcRuleInputSchema = object({
14883
14948
  */
14884
14949
  snoozeAllowGlobal: boolean().optional(),
14885
14950
  /**
14951
+ * The snooze durations THIS rule's notification offers as buttons, in
14952
+ * minutes.
14953
+ *
14954
+ * Three states, and all three are distinct — which is exactly why this is
14955
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14956
+ * addon cap path (three production failures in one day), so a schema default
14957
+ * would collapse the first two:
14958
+ *
14959
+ * | value | meaning |
14960
+ * | --- | --- |
14961
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14962
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14963
+ * | a list | these choices, de-duplicated and sorted, at most four |
14964
+ *
14965
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14966
+ * three buttons in total) and a rule that spent it all on snooze choices
14967
+ * would push its own tap-through actions off the notification.
14968
+ *
14969
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14970
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14971
+ * window from anywhere (D133).
14972
+ */
14973
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14974
+ /**
14886
14975
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14887
14976
  *
14888
14977
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14982,6 +15071,7 @@ var NcConditionDescriptorSchema = object({
14982
15071
  "device",
14983
15072
  "package",
14984
15073
  "occupancy",
15074
+ "audio",
14985
15075
  "system"
14986
15076
  ]),
14987
15077
  label: string(),
@@ -15000,6 +15090,7 @@ var NcConditionDescriptorSchema = object({
15000
15090
  "crossingSelect",
15001
15091
  "polygonDraw",
15002
15092
  "occupancy",
15093
+ "audio",
15003
15094
  "deviceState",
15004
15095
  "systemEvent"
15005
15096
  ]),
@@ -15151,7 +15242,20 @@ var NcSnoozeInputSchema = object({
15151
15242
  ruleId: string().optional(),
15152
15243
  /** Required when `scope: 'device'`. */
15153
15244
  deviceId: number().int().optional(),
15154
- durationMinutes: number().int().min(1).max(1440),
15245
+ /**
15246
+ * Narrow the window to these subject classes — "the cat, not the person".
15247
+ *
15248
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15249
+ * what every window authored before this field meant, so no persisted row
15250
+ * changes meaning and no client has to learn anything to keep working.
15251
+ *
15252
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15253
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15254
+ * not at whichever of their four rules happened to produce the notification
15255
+ * they are dismissing.
15256
+ */
15257
+ classes: array(string().min(1)).min(1).optional(),
15258
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15155
15259
  /**
15156
15260
  * Silence this for EVERY recipient, not just the caller. Permission is
15157
15261
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15176,6 +15280,10 @@ var NcSnoozeSchema = object({
15176
15280
  scope: NcSnoozeScopeSchema,
15177
15281
  ruleId: string().optional(),
15178
15282
  deviceId: number().int().optional(),
15283
+ /** Subject classes this window covers. ABSENT = every class — see
15284
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15285
+ * no SQLite column: nothing queries a window by class. */
15286
+ classes: array(string().min(1)).min(1).optional(),
15179
15287
  startedAt: number(),
15180
15288
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15181
15289
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17419,6 +17527,22 @@ var detectionFpsField = {
17419
17527
  default: 10,
17420
17528
  step: 1
17421
17529
  };
17530
+ /**
17531
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
17532
+ *
17533
+ * The recheck is now on by default (a parked car is invisible to occupancy
17534
+ * rules until the stationary registry has been rebuilt by motion, which after a
17535
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
17536
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
17537
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
17538
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
17539
+ *
17540
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
17541
+ * the host validates `attachCamera` against ITS copy of this schema, so a
17542
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
17543
+ * carrying the wider bound is installed everywhere. 300 is the widest value
17544
+ * that ships with an addon deploy.
17545
+ */
17422
17546
  var occupancyRecheckSecField = {
17423
17547
  min: 0,
17424
17548
  max: 300,
@@ -17620,15 +17744,21 @@ var RunnerCameraConfigSchema = object({
17620
17744
  */
17621
17745
  onboardMotionDrivesAnalyzer: boolean().default(true),
17622
17746
  /**
17623
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
17624
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec` —
17625
- * this is off by default because the recheck re-subscribes a detection session
17626
- * every N seconds while `watching`, a major source of pull-decoder re-dial
17627
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
17747
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
17748
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
17628
17749
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
17629
17750
  * (and only render) when this is enabled.
17630
- */
17631
- occupancyRecheckEnabled: boolean().default(false),
17751
+ *
17752
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
17753
+ * recheck re-subscribes a detection session every N seconds while `watching`
17754
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
17755
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
17756
+ * object is counted only while the stationary registry holds it, and the
17757
+ * registry rebuilds from motion, so after a restart a parked car was invisible
17758
+ * to every occupancy rule until something moved in front of it. The churn is
17759
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
17760
+ */
17761
+ occupancyRecheckEnabled: boolean().default(true),
17632
17762
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
17633
17763
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
17634
17764
  /**
@@ -30754,6 +30884,7 @@ Object.freeze({
30754
30884
  "network-access": "ingress",
30755
30885
  "smtp-provider": "email"
30756
30886
  });
30887
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30757
30888
  new Set(["devices", "classes"]);
30758
30889
  /**
30759
30890
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -13205,11 +13205,33 @@ var NotificationFormatSchema = _enum([
13205
13205
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
13206
13206
  * renderer's icon set; "acknowledge" survives an adapter that draws it
13207
13207
  * differently.
13208
+ *
13209
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
13210
+ *
13211
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
13212
+ * the whole set onto its own renderer's vocabulary through a
13213
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
13214
+ * fallback, so adding a member here fails every adapter's build until someone
13215
+ * decides its glyph, which is the only place that decision can be made
13216
+ * honestly.
13217
+ *
13218
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
13219
+ * `disarm` straight through; iOS feeds that string to
13220
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
13221
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
13222
+ * mapping, and "the field is documented" is not "the value renders".
13223
+ *
13224
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
13225
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
13226
+ * so an addon that emits a token the running hub does not know does not lose an
13227
+ * icon — its whole `send` fails Zod validation and the notification never
13228
+ * arrives. Never emit a new token from an addon before the train carrying it.
13208
13229
  */
13209
13230
  var NotificationActionIconSchema = _enum([
13210
13231
  "acknowledge",
13211
13232
  "dismiss",
13212
13233
  "silence",
13234
+ "snooze",
13213
13235
  "view",
13214
13236
  "play",
13215
13237
  "open",
@@ -13217,9 +13239,13 @@ var NotificationActionIconSchema = _enum([
13217
13239
  "lock",
13218
13240
  "unlock",
13219
13241
  "arm",
13242
+ "arm-home",
13243
+ "arm-away",
13244
+ "arm-night",
13220
13245
  "disarm",
13221
13246
  "light",
13222
- "alert"
13247
+ "alert",
13248
+ "camera"
13223
13249
  ]);
13224
13250
  /** A single tap-through action button. */
13225
13251
  var NotificationActionSchema = object({
@@ -13235,7 +13261,23 @@ var NotificationActionSchema = object({
13235
13261
  * else — see `notification-center/action-token.ts` for what that does and
13236
13262
  * does not buy.
13237
13263
  */
13238
- destructive: boolean().optional()
13264
+ destructive: boolean().optional(),
13265
+ /**
13266
+ * How the tap should REACH the url.
13267
+ *
13268
+ * `navigate` (absent, and every button authored before this field) opens it:
13269
+ * the phone leaves the notification and shows whatever the callback returns.
13270
+ * That is right for a button whose answer the operator wants to read.
13271
+ *
13272
+ * `background` fires it as a POST and stays put. It exists for the buttons
13273
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13274
+ * an answer to the notification, and being thrown into a browser tab to
13275
+ * confirm it costs more attention than the notification did. A backend that
13276
+ * cannot do a background call renders it as an ordinary link (the adapters
13277
+ * fall back rather than dropping the button), so this is a preference, never
13278
+ * a requirement.
13279
+ */
13280
+ mode: _enum(["navigate", "background"]).optional()
13239
13281
  });
13240
13282
  /**
13241
13283
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13403,6 +13445,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13403
13445
  targetId: string(),
13404
13446
  enabled: boolean()
13405
13447
  }), _void(), { kind: "mutation" });
13448
+ new Set([
13449
+ {
13450
+ id: "person",
13451
+ name: "Person"
13452
+ },
13453
+ {
13454
+ id: "vehicle",
13455
+ name: "Vehicle"
13456
+ },
13457
+ {
13458
+ id: "animal",
13459
+ name: "Animal"
13460
+ },
13461
+ {
13462
+ id: "package",
13463
+ name: "Package"
13464
+ }
13465
+ ].map((l) => l.id));
13406
13466
  var COCO_TO_MACRO = {
13407
13467
  mapping: {
13408
13468
  person: "person",
@@ -14200,6 +14260,8 @@ var NcSystemEventKindSchema = _enum([
14200
14260
  "alarm-triggered",
14201
14261
  "alarm-armed",
14202
14262
  "alarm-disarmed",
14263
+ "alarm-arming",
14264
+ "alarm-arm-refused",
14203
14265
  "camera-online",
14204
14266
  "camera-offline",
14205
14267
  "camera-disabled",
@@ -14236,6 +14298,9 @@ var NcSystemEventConditionSchema = object({
14236
14298
  nodeIds: array(string().min(1)).min(1).optional(),
14237
14299
  packageNames: array(string().min(1)).min(1).optional()
14238
14300
  });
14301
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14302
+ * outage the operator asked for once and forgot. */
14303
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14239
14304
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14240
14305
  var NcScheduleSchema = object({
14241
14306
  windows: array(object({
@@ -14612,15 +14677,15 @@ var NcConditionsSchema = object({
14612
14677
  * (an `immediate` rule naming an `audio-*` class, one notification per
14613
14678
  * classified sample) stays exactly as it was for rules that already use it.
14614
14679
  *
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
14680
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14681
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14682
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14683
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14619
14684
  * condition fields it does not know when a rule is saved from the phone.
14620
14685
  * 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.
14686
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14687
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14688
+ * follows here.
14624
14689
  */
14625
14690
  audio: NcAudioConditionSchema.optional()
14626
14691
  });
@@ -14856,6 +14921,30 @@ var NcRuleInputSchema = object({
14856
14921
  */
14857
14922
  snoozeAllowGlobal: boolean().optional(),
14858
14923
  /**
14924
+ * The snooze durations THIS rule's notification offers as buttons, in
14925
+ * minutes.
14926
+ *
14927
+ * Three states, and all three are distinct — which is exactly why this is
14928
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14929
+ * addon cap path (three production failures in one day), so a schema default
14930
+ * would collapse the first two:
14931
+ *
14932
+ * | value | meaning |
14933
+ * | --- | --- |
14934
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14935
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14936
+ * | a list | these choices, de-duplicated and sorted, at most four |
14937
+ *
14938
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14939
+ * three buttons in total) and a rule that spent it all on snooze choices
14940
+ * would push its own tap-through actions off the notification.
14941
+ *
14942
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14943
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14944
+ * window from anywhere (D133).
14945
+ */
14946
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14947
+ /**
14859
14948
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14860
14949
  *
14861
14950
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14955,6 +15044,7 @@ var NcConditionDescriptorSchema = object({
14955
15044
  "device",
14956
15045
  "package",
14957
15046
  "occupancy",
15047
+ "audio",
14958
15048
  "system"
14959
15049
  ]),
14960
15050
  label: string(),
@@ -14973,6 +15063,7 @@ var NcConditionDescriptorSchema = object({
14973
15063
  "crossingSelect",
14974
15064
  "polygonDraw",
14975
15065
  "occupancy",
15066
+ "audio",
14976
15067
  "deviceState",
14977
15068
  "systemEvent"
14978
15069
  ]),
@@ -15124,7 +15215,20 @@ var NcSnoozeInputSchema = object({
15124
15215
  ruleId: string().optional(),
15125
15216
  /** Required when `scope: 'device'`. */
15126
15217
  deviceId: number().int().optional(),
15127
- durationMinutes: number().int().min(1).max(1440),
15218
+ /**
15219
+ * Narrow the window to these subject classes — "the cat, not the person".
15220
+ *
15221
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15222
+ * what every window authored before this field meant, so no persisted row
15223
+ * changes meaning and no client has to learn anything to keep working.
15224
+ *
15225
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15226
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15227
+ * not at whichever of their four rules happened to produce the notification
15228
+ * they are dismissing.
15229
+ */
15230
+ classes: array(string().min(1)).min(1).optional(),
15231
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15128
15232
  /**
15129
15233
  * Silence this for EVERY recipient, not just the caller. Permission is
15130
15234
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15149,6 +15253,10 @@ var NcSnoozeSchema = object({
15149
15253
  scope: NcSnoozeScopeSchema,
15150
15254
  ruleId: string().optional(),
15151
15255
  deviceId: number().int().optional(),
15256
+ /** Subject classes this window covers. ABSENT = every class — see
15257
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15258
+ * no SQLite column: nothing queries a window by class. */
15259
+ classes: array(string().min(1)).min(1).optional(),
15152
15260
  startedAt: number(),
15153
15261
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15154
15262
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17392,6 +17500,22 @@ var detectionFpsField = {
17392
17500
  default: 10,
17393
17501
  step: 1
17394
17502
  };
17503
+ /**
17504
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
17505
+ *
17506
+ * The recheck is now on by default (a parked car is invisible to occupancy
17507
+ * rules until the stationary registry has been rebuilt by motion, which after a
17508
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
17509
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
17510
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
17511
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
17512
+ *
17513
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
17514
+ * the host validates `attachCamera` against ITS copy of this schema, so a
17515
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
17516
+ * carrying the wider bound is installed everywhere. 300 is the widest value
17517
+ * that ships with an addon deploy.
17518
+ */
17395
17519
  var occupancyRecheckSecField = {
17396
17520
  min: 0,
17397
17521
  max: 300,
@@ -17593,15 +17717,21 @@ var RunnerCameraConfigSchema = object({
17593
17717
  */
17594
17718
  onboardMotionDrivesAnalyzer: boolean().default(true),
17595
17719
  /**
17596
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
17597
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec` —
17598
- * this is off by default because the recheck re-subscribes a detection session
17599
- * every N seconds while `watching`, a major source of pull-decoder re-dial
17600
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
17720
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
17721
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
17601
17722
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
17602
17723
  * (and only render) when this is enabled.
17603
- */
17604
- occupancyRecheckEnabled: boolean().default(false),
17724
+ *
17725
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
17726
+ * recheck re-subscribes a detection session every N seconds while `watching`
17727
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
17728
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
17729
+ * object is counted only while the stationary registry holds it, and the
17730
+ * registry rebuilds from motion, so after a restart a parked car was invisible
17731
+ * to every occupancy rule until something moved in front of it. The churn is
17732
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
17733
+ */
17734
+ occupancyRecheckEnabled: boolean().default(true),
17605
17735
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
17606
17736
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
17607
17737
  /**
@@ -30727,6 +30857,7 @@ Object.freeze({
30727
30857
  "network-access": "ingress",
30728
30858
  "smtp-provider": "email"
30729
30859
  });
30860
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30730
30861
  new Set(["devices", "classes"]);
30731
30862
  /**
30732
30863
  * 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.21",
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",