@camstack/addon-static-turn 1.2.14 → 1.2.16

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.
@@ -12921,11 +12921,33 @@ var NotificationFormatSchema = _enum([
12921
12921
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
12922
12922
  * renderer's icon set; "acknowledge" survives an adapter that draws it
12923
12923
  * differently.
12924
+ *
12925
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
12926
+ *
12927
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
12928
+ * the whole set onto its own renderer's vocabulary through a
12929
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
12930
+ * fallback, so adding a member here fails every adapter's build until someone
12931
+ * decides its glyph, which is the only place that decision can be made
12932
+ * honestly.
12933
+ *
12934
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
12935
+ * `disarm` straight through; iOS feeds that string to
12936
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
12937
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
12938
+ * mapping, and "the field is documented" is not "the value renders".
12939
+ *
12940
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
12941
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
12942
+ * so an addon that emits a token the running hub does not know does not lose an
12943
+ * icon — its whole `send` fails Zod validation and the notification never
12944
+ * arrives. Never emit a new token from an addon before the train carrying it.
12924
12945
  */
12925
12946
  var NotificationActionIconSchema = _enum([
12926
12947
  "acknowledge",
12927
12948
  "dismiss",
12928
12949
  "silence",
12950
+ "snooze",
12929
12951
  "view",
12930
12952
  "play",
12931
12953
  "open",
@@ -12933,9 +12955,13 @@ var NotificationActionIconSchema = _enum([
12933
12955
  "lock",
12934
12956
  "unlock",
12935
12957
  "arm",
12958
+ "arm-home",
12959
+ "arm-away",
12960
+ "arm-night",
12936
12961
  "disarm",
12937
12962
  "light",
12938
- "alert"
12963
+ "alert",
12964
+ "camera"
12939
12965
  ]);
12940
12966
  /** A single tap-through action button. */
12941
12967
  var NotificationActionSchema = object({
@@ -12951,7 +12977,23 @@ var NotificationActionSchema = object({
12951
12977
  * else — see `notification-center/action-token.ts` for what that does and
12952
12978
  * does not buy.
12953
12979
  */
12954
- destructive: boolean().optional()
12980
+ destructive: boolean().optional(),
12981
+ /**
12982
+ * How the tap should REACH the url.
12983
+ *
12984
+ * `navigate` (absent, and every button authored before this field) opens it:
12985
+ * the phone leaves the notification and shows whatever the callback returns.
12986
+ * That is right for a button whose answer the operator wants to read.
12987
+ *
12988
+ * `background` fires it as a POST and stays put. It exists for the buttons
12989
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
12990
+ * an answer to the notification, and being thrown into a browser tab to
12991
+ * confirm it costs more attention than the notification did. A backend that
12992
+ * cannot do a background call renders it as an ordinary link (the adapters
12993
+ * fall back rather than dropping the button), so this is a preference, never
12994
+ * a requirement.
12995
+ */
12996
+ mode: _enum(["navigate", "background"]).optional()
12955
12997
  });
12956
12998
  /**
12957
12999
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13119,6 +13161,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13119
13161
  targetId: string(),
13120
13162
  enabled: boolean()
13121
13163
  }), _void(), { kind: "mutation" });
13164
+ new Set([
13165
+ {
13166
+ id: "person",
13167
+ name: "Person"
13168
+ },
13169
+ {
13170
+ id: "vehicle",
13171
+ name: "Vehicle"
13172
+ },
13173
+ {
13174
+ id: "animal",
13175
+ name: "Animal"
13176
+ },
13177
+ {
13178
+ id: "package",
13179
+ name: "Package"
13180
+ }
13181
+ ].map((l) => l.id));
13122
13182
  var COCO_TO_MACRO = {
13123
13183
  mapping: {
13124
13184
  person: "person",
@@ -13916,6 +13976,8 @@ var NcSystemEventKindSchema = _enum([
13916
13976
  "alarm-triggered",
13917
13977
  "alarm-armed",
13918
13978
  "alarm-disarmed",
13979
+ "alarm-arming",
13980
+ "alarm-arm-refused",
13919
13981
  "camera-online",
13920
13982
  "camera-offline",
13921
13983
  "camera-disabled",
@@ -13952,6 +14014,9 @@ var NcSystemEventConditionSchema = object({
13952
14014
  nodeIds: array(string().min(1)).min(1).optional(),
13953
14015
  packageNames: array(string().min(1)).min(1).optional()
13954
14016
  });
14017
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14018
+ * outage the operator asked for once and forgot. */
14019
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13955
14020
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13956
14021
  var NcScheduleSchema = object({
13957
14022
  windows: array(object({
@@ -14328,15 +14393,15 @@ var NcConditionsSchema = object({
14328
14393
  * (an `immediate` rule naming an `audio-*` class, one notification per
14329
14394
  * classified sample) stays exactly as it was for rules that already use it.
14330
14395
  *
14331
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14332
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14333
- * (`camstack/src/data/notification-center.ts`, guarded by
14334
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14396
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14397
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14398
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14399
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14335
14400
  * condition fields it does not know when a rule is saved from the phone.
14336
14401
  * Publishing an editor for a condition the app cannot round-trip is how an
14337
- * operator loses a rule's conditions by opening it — so the descriptor, the
14338
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14339
- * does an audio rule become authorable.
14402
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14403
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14404
+ * follows here.
14340
14405
  */
14341
14406
  audio: NcAudioConditionSchema.optional()
14342
14407
  });
@@ -14572,6 +14637,30 @@ var NcRuleInputSchema = object({
14572
14637
  */
14573
14638
  snoozeAllowGlobal: boolean().optional(),
14574
14639
  /**
14640
+ * The snooze durations THIS rule's notification offers as buttons, in
14641
+ * minutes.
14642
+ *
14643
+ * Three states, and all three are distinct — which is exactly why this is
14644
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14645
+ * addon cap path (three production failures in one day), so a schema default
14646
+ * would collapse the first two:
14647
+ *
14648
+ * | value | meaning |
14649
+ * | --- | --- |
14650
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14651
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14652
+ * | a list | these choices, de-duplicated and sorted, at most four |
14653
+ *
14654
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14655
+ * three buttons in total) and a rule that spent it all on snooze choices
14656
+ * would push its own tap-through actions off the notification.
14657
+ *
14658
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14659
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14660
+ * window from anywhere (D133).
14661
+ */
14662
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14663
+ /**
14575
14664
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14576
14665
  *
14577
14666
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14671,6 +14760,7 @@ var NcConditionDescriptorSchema = object({
14671
14760
  "device",
14672
14761
  "package",
14673
14762
  "occupancy",
14763
+ "audio",
14674
14764
  "system"
14675
14765
  ]),
14676
14766
  label: string(),
@@ -14689,6 +14779,7 @@ var NcConditionDescriptorSchema = object({
14689
14779
  "crossingSelect",
14690
14780
  "polygonDraw",
14691
14781
  "occupancy",
14782
+ "audio",
14692
14783
  "deviceState",
14693
14784
  "systemEvent"
14694
14785
  ]),
@@ -14840,7 +14931,20 @@ var NcSnoozeInputSchema = object({
14840
14931
  ruleId: string().optional(),
14841
14932
  /** Required when `scope: 'device'`. */
14842
14933
  deviceId: number().int().optional(),
14843
- durationMinutes: number().int().min(1).max(1440),
14934
+ /**
14935
+ * Narrow the window to these subject classes — "the cat, not the person".
14936
+ *
14937
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14938
+ * what every window authored before this field meant, so no persisted row
14939
+ * changes meaning and no client has to learn anything to keep working.
14940
+ *
14941
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14942
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14943
+ * not at whichever of their four rules happened to produce the notification
14944
+ * they are dismissing.
14945
+ */
14946
+ classes: array(string().min(1)).min(1).optional(),
14947
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14844
14948
  /**
14845
14949
  * Silence this for EVERY recipient, not just the caller. Permission is
14846
14950
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14865,6 +14969,10 @@ var NcSnoozeSchema = object({
14865
14969
  scope: NcSnoozeScopeSchema,
14866
14970
  ruleId: string().optional(),
14867
14971
  deviceId: number().int().optional(),
14972
+ /** Subject classes this window covers. ABSENT = every class — see
14973
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14974
+ * no SQLite column: nothing queries a window by class. */
14975
+ classes: array(string().min(1)).min(1).optional(),
14868
14976
  startedAt: number(),
14869
14977
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14870
14978
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17102,6 +17210,22 @@ var detectionFpsField = {
17102
17210
  default: 10,
17103
17211
  step: 1
17104
17212
  };
17213
+ /**
17214
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
17215
+ *
17216
+ * The recheck is now on by default (a parked car is invisible to occupancy
17217
+ * rules until the stationary registry has been rebuilt by motion, which after a
17218
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
17219
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
17220
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
17221
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
17222
+ *
17223
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
17224
+ * the host validates `attachCamera` against ITS copy of this schema, so a
17225
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
17226
+ * carrying the wider bound is installed everywhere. 300 is the widest value
17227
+ * that ships with an addon deploy.
17228
+ */
17105
17229
  var occupancyRecheckSecField = {
17106
17230
  min: 0,
17107
17231
  max: 300,
@@ -17303,15 +17427,21 @@ var RunnerCameraConfigSchema = object({
17303
17427
  */
17304
17428
  onboardMotionDrivesAnalyzer: boolean().default(true),
17305
17429
  /**
17306
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
17307
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec`
17308
- * this is off by default because the recheck re-subscribes a detection session
17309
- * every N seconds while `watching`, a major source of pull-decoder re-dial
17310
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
17430
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
17431
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
17311
17432
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
17312
17433
  * (and only render) when this is enabled.
17313
- */
17314
- occupancyRecheckEnabled: boolean().default(false),
17434
+ *
17435
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
17436
+ * recheck re-subscribes a detection session every N seconds while `watching`
17437
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
17438
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
17439
+ * object is counted only while the stationary registry holds it, and the
17440
+ * registry rebuilds from motion, so after a restart a parked car was invisible
17441
+ * to every occupancy rule until something moved in front of it. The churn is
17442
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
17443
+ */
17444
+ occupancyRecheckEnabled: boolean().default(true),
17315
17445
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
17316
17446
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
17317
17447
  /**
@@ -30460,6 +30590,7 @@ Object.freeze({
30460
30590
  "network-access": "ingress",
30461
30591
  "smtp-provider": "email"
30462
30592
  });
30593
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30463
30594
  new Set(["devices", "classes"]);
30464
30595
  /**
30465
30596
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -12920,11 +12920,33 @@ var NotificationFormatSchema = _enum([
12920
12920
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
12921
12921
  * renderer's icon set; "acknowledge" survives an adapter that draws it
12922
12922
  * differently.
12923
+ *
12924
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
12925
+ *
12926
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
12927
+ * the whole set onto its own renderer's vocabulary through a
12928
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
12929
+ * fallback, so adding a member here fails every adapter's build until someone
12930
+ * decides its glyph, which is the only place that decision can be made
12931
+ * honestly.
12932
+ *
12933
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
12934
+ * `disarm` straight through; iOS feeds that string to
12935
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
12936
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
12937
+ * mapping, and "the field is documented" is not "the value renders".
12938
+ *
12939
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
12940
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
12941
+ * so an addon that emits a token the running hub does not know does not lose an
12942
+ * icon — its whole `send` fails Zod validation and the notification never
12943
+ * arrives. Never emit a new token from an addon before the train carrying it.
12923
12944
  */
12924
12945
  var NotificationActionIconSchema = _enum([
12925
12946
  "acknowledge",
12926
12947
  "dismiss",
12927
12948
  "silence",
12949
+ "snooze",
12928
12950
  "view",
12929
12951
  "play",
12930
12952
  "open",
@@ -12932,9 +12954,13 @@ var NotificationActionIconSchema = _enum([
12932
12954
  "lock",
12933
12955
  "unlock",
12934
12956
  "arm",
12957
+ "arm-home",
12958
+ "arm-away",
12959
+ "arm-night",
12935
12960
  "disarm",
12936
12961
  "light",
12937
- "alert"
12962
+ "alert",
12963
+ "camera"
12938
12964
  ]);
12939
12965
  /** A single tap-through action button. */
12940
12966
  var NotificationActionSchema = object({
@@ -12950,7 +12976,23 @@ var NotificationActionSchema = object({
12950
12976
  * else — see `notification-center/action-token.ts` for what that does and
12951
12977
  * does not buy.
12952
12978
  */
12953
- destructive: boolean().optional()
12979
+ destructive: boolean().optional(),
12980
+ /**
12981
+ * How the tap should REACH the url.
12982
+ *
12983
+ * `navigate` (absent, and every button authored before this field) opens it:
12984
+ * the phone leaves the notification and shows whatever the callback returns.
12985
+ * That is right for a button whose answer the operator wants to read.
12986
+ *
12987
+ * `background` fires it as a POST and stays put. It exists for the buttons
12988
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
12989
+ * an answer to the notification, and being thrown into a browser tab to
12990
+ * confirm it costs more attention than the notification did. A backend that
12991
+ * cannot do a background call renders it as an ordinary link (the adapters
12992
+ * fall back rather than dropping the button), so this is a preference, never
12993
+ * a requirement.
12994
+ */
12995
+ mode: _enum(["navigate", "background"]).optional()
12954
12996
  });
12955
12997
  /**
12956
12998
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13118,6 +13160,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13118
13160
  targetId: string(),
13119
13161
  enabled: boolean()
13120
13162
  }), _void(), { kind: "mutation" });
13163
+ new Set([
13164
+ {
13165
+ id: "person",
13166
+ name: "Person"
13167
+ },
13168
+ {
13169
+ id: "vehicle",
13170
+ name: "Vehicle"
13171
+ },
13172
+ {
13173
+ id: "animal",
13174
+ name: "Animal"
13175
+ },
13176
+ {
13177
+ id: "package",
13178
+ name: "Package"
13179
+ }
13180
+ ].map((l) => l.id));
13121
13181
  var COCO_TO_MACRO = {
13122
13182
  mapping: {
13123
13183
  person: "person",
@@ -13915,6 +13975,8 @@ var NcSystemEventKindSchema = _enum([
13915
13975
  "alarm-triggered",
13916
13976
  "alarm-armed",
13917
13977
  "alarm-disarmed",
13978
+ "alarm-arming",
13979
+ "alarm-arm-refused",
13918
13980
  "camera-online",
13919
13981
  "camera-offline",
13920
13982
  "camera-disabled",
@@ -13951,6 +14013,9 @@ var NcSystemEventConditionSchema = object({
13951
14013
  nodeIds: array(string().min(1)).min(1).optional(),
13952
14014
  packageNames: array(string().min(1)).min(1).optional()
13953
14015
  });
14016
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14017
+ * outage the operator asked for once and forgot. */
14018
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13954
14019
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13955
14020
  var NcScheduleSchema = object({
13956
14021
  windows: array(object({
@@ -14327,15 +14392,15 @@ var NcConditionsSchema = object({
14327
14392
  * (an `immediate` rule naming an `audio-*` class, one notification per
14328
14393
  * classified sample) stays exactly as it was for rules that already use it.
14329
14394
  *
14330
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14331
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14332
- * (`camstack/src/data/notification-center.ts`, guarded by
14333
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14395
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14396
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14397
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14398
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14334
14399
  * condition fields it does not know when a rule is saved from the phone.
14335
14400
  * Publishing an editor for a condition the app cannot round-trip is how an
14336
- * operator loses a rule's conditions by opening it — so the descriptor, the
14337
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14338
- * does an audio rule become authorable.
14401
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14402
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14403
+ * follows here.
14339
14404
  */
14340
14405
  audio: NcAudioConditionSchema.optional()
14341
14406
  });
@@ -14571,6 +14636,30 @@ var NcRuleInputSchema = object({
14571
14636
  */
14572
14637
  snoozeAllowGlobal: boolean().optional(),
14573
14638
  /**
14639
+ * The snooze durations THIS rule's notification offers as buttons, in
14640
+ * minutes.
14641
+ *
14642
+ * Three states, and all three are distinct — which is exactly why this is
14643
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14644
+ * addon cap path (three production failures in one day), so a schema default
14645
+ * would collapse the first two:
14646
+ *
14647
+ * | value | meaning |
14648
+ * | --- | --- |
14649
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14650
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14651
+ * | a list | these choices, de-duplicated and sorted, at most four |
14652
+ *
14653
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14654
+ * three buttons in total) and a rule that spent it all on snooze choices
14655
+ * would push its own tap-through actions off the notification.
14656
+ *
14657
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14658
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14659
+ * window from anywhere (D133).
14660
+ */
14661
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14662
+ /**
14574
14663
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14575
14664
  *
14576
14665
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14670,6 +14759,7 @@ var NcConditionDescriptorSchema = object({
14670
14759
  "device",
14671
14760
  "package",
14672
14761
  "occupancy",
14762
+ "audio",
14673
14763
  "system"
14674
14764
  ]),
14675
14765
  label: string(),
@@ -14688,6 +14778,7 @@ var NcConditionDescriptorSchema = object({
14688
14778
  "crossingSelect",
14689
14779
  "polygonDraw",
14690
14780
  "occupancy",
14781
+ "audio",
14691
14782
  "deviceState",
14692
14783
  "systemEvent"
14693
14784
  ]),
@@ -14839,7 +14930,20 @@ var NcSnoozeInputSchema = object({
14839
14930
  ruleId: string().optional(),
14840
14931
  /** Required when `scope: 'device'`. */
14841
14932
  deviceId: number().int().optional(),
14842
- durationMinutes: number().int().min(1).max(1440),
14933
+ /**
14934
+ * Narrow the window to these subject classes — "the cat, not the person".
14935
+ *
14936
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14937
+ * what every window authored before this field meant, so no persisted row
14938
+ * changes meaning and no client has to learn anything to keep working.
14939
+ *
14940
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14941
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14942
+ * not at whichever of their four rules happened to produce the notification
14943
+ * they are dismissing.
14944
+ */
14945
+ classes: array(string().min(1)).min(1).optional(),
14946
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14843
14947
  /**
14844
14948
  * Silence this for EVERY recipient, not just the caller. Permission is
14845
14949
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14864,6 +14968,10 @@ var NcSnoozeSchema = object({
14864
14968
  scope: NcSnoozeScopeSchema,
14865
14969
  ruleId: string().optional(),
14866
14970
  deviceId: number().int().optional(),
14971
+ /** Subject classes this window covers. ABSENT = every class — see
14972
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14973
+ * no SQLite column: nothing queries a window by class. */
14974
+ classes: array(string().min(1)).min(1).optional(),
14867
14975
  startedAt: number(),
14868
14976
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14869
14977
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17101,6 +17209,22 @@ var detectionFpsField = {
17101
17209
  default: 10,
17102
17210
  step: 1
17103
17211
  };
17212
+ /**
17213
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
17214
+ *
17215
+ * The recheck is now on by default (a parked car is invisible to occupancy
17216
+ * rules until the stationary registry has been rebuilt by motion, which after a
17217
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
17218
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
17219
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
17220
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
17221
+ *
17222
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
17223
+ * the host validates `attachCamera` against ITS copy of this schema, so a
17224
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
17225
+ * carrying the wider bound is installed everywhere. 300 is the widest value
17226
+ * that ships with an addon deploy.
17227
+ */
17104
17228
  var occupancyRecheckSecField = {
17105
17229
  min: 0,
17106
17230
  max: 300,
@@ -17302,15 +17426,21 @@ var RunnerCameraConfigSchema = object({
17302
17426
  */
17303
17427
  onboardMotionDrivesAnalyzer: boolean().default(true),
17304
17428
  /**
17305
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
17306
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec`
17307
- * this is off by default because the recheck re-subscribes a detection session
17308
- * every N seconds while `watching`, a major source of pull-decoder re-dial
17309
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
17429
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
17430
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
17310
17431
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
17311
17432
  * (and only render) when this is enabled.
17312
- */
17313
- occupancyRecheckEnabled: boolean().default(false),
17433
+ *
17434
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
17435
+ * recheck re-subscribes a detection session every N seconds while `watching`
17436
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
17437
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
17438
+ * object is counted only while the stationary registry holds it, and the
17439
+ * registry rebuilds from motion, so after a restart a parked car was invisible
17440
+ * to every occupancy rule until something moved in front of it. The churn is
17441
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
17442
+ */
17443
+ occupancyRecheckEnabled: boolean().default(true),
17314
17444
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
17315
17445
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
17316
17446
  /**
@@ -30459,6 +30589,7 @@ Object.freeze({
30459
30589
  "network-access": "ingress",
30460
30590
  "smtp-provider": "email"
30461
30591
  });
30592
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30462
30593
  new Set(["devices", "classes"]);
30463
30594
  /**
30464
30595
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-static-turn",
3
- "version": "1.2.14",
3
+ "version": "1.2.16",
4
4
  "description": "Static / self-hosted (coturn) TURN provider for CamStack",
5
5
  "keywords": [
6
6
  "camstack",