@camstack/addon-export-hap 1.2.25 → 1.2.27

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.
@@ -13738,11 +13738,33 @@ var NotificationFormatSchema = _enum([
13738
13738
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
13739
13739
  * renderer's icon set; "acknowledge" survives an adapter that draws it
13740
13740
  * differently.
13741
+ *
13742
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
13743
+ *
13744
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
13745
+ * the whole set onto its own renderer's vocabulary through a
13746
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
13747
+ * fallback, so adding a member here fails every adapter's build until someone
13748
+ * decides its glyph, which is the only place that decision can be made
13749
+ * honestly.
13750
+ *
13751
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
13752
+ * `disarm` straight through; iOS feeds that string to
13753
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
13754
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
13755
+ * mapping, and "the field is documented" is not "the value renders".
13756
+ *
13757
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
13758
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
13759
+ * so an addon that emits a token the running hub does not know does not lose an
13760
+ * icon — its whole `send` fails Zod validation and the notification never
13761
+ * arrives. Never emit a new token from an addon before the train carrying it.
13741
13762
  */
13742
13763
  var NotificationActionIconSchema = _enum([
13743
13764
  "acknowledge",
13744
13765
  "dismiss",
13745
13766
  "silence",
13767
+ "snooze",
13746
13768
  "view",
13747
13769
  "play",
13748
13770
  "open",
@@ -13750,9 +13772,13 @@ var NotificationActionIconSchema = _enum([
13750
13772
  "lock",
13751
13773
  "unlock",
13752
13774
  "arm",
13775
+ "arm-home",
13776
+ "arm-away",
13777
+ "arm-night",
13753
13778
  "disarm",
13754
13779
  "light",
13755
- "alert"
13780
+ "alert",
13781
+ "camera"
13756
13782
  ]);
13757
13783
  /** A single tap-through action button. */
13758
13784
  var NotificationActionSchema = object({
@@ -13768,7 +13794,23 @@ var NotificationActionSchema = object({
13768
13794
  * else — see `notification-center/action-token.ts` for what that does and
13769
13795
  * does not buy.
13770
13796
  */
13771
- destructive: boolean().optional()
13797
+ destructive: boolean().optional(),
13798
+ /**
13799
+ * How the tap should REACH the url.
13800
+ *
13801
+ * `navigate` (absent, and every button authored before this field) opens it:
13802
+ * the phone leaves the notification and shows whatever the callback returns.
13803
+ * That is right for a button whose answer the operator wants to read.
13804
+ *
13805
+ * `background` fires it as a POST and stays put. It exists for the buttons
13806
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13807
+ * an answer to the notification, and being thrown into a browser tab to
13808
+ * confirm it costs more attention than the notification did. A backend that
13809
+ * cannot do a background call renders it as an ordinary link (the adapters
13810
+ * fall back rather than dropping the button), so this is a preference, never
13811
+ * a requirement.
13812
+ */
13813
+ mode: _enum(["navigate", "background"]).optional()
13772
13814
  });
13773
13815
  /**
13774
13816
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13936,6 +13978,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13936
13978
  targetId: string(),
13937
13979
  enabled: boolean()
13938
13980
  }), _void(), { kind: "mutation" });
13981
+ new Set([
13982
+ {
13983
+ id: "person",
13984
+ name: "Person"
13985
+ },
13986
+ {
13987
+ id: "vehicle",
13988
+ name: "Vehicle"
13989
+ },
13990
+ {
13991
+ id: "animal",
13992
+ name: "Animal"
13993
+ },
13994
+ {
13995
+ id: "package",
13996
+ name: "Package"
13997
+ }
13998
+ ].map((l) => l.id));
13939
13999
  var COCO_TO_MACRO = {
13940
14000
  mapping: {
13941
14001
  person: "person",
@@ -14733,6 +14793,8 @@ var NcSystemEventKindSchema = _enum([
14733
14793
  "alarm-triggered",
14734
14794
  "alarm-armed",
14735
14795
  "alarm-disarmed",
14796
+ "alarm-arming",
14797
+ "alarm-arm-refused",
14736
14798
  "camera-online",
14737
14799
  "camera-offline",
14738
14800
  "camera-disabled",
@@ -14769,6 +14831,9 @@ var NcSystemEventConditionSchema = object({
14769
14831
  nodeIds: array(string().min(1)).min(1).optional(),
14770
14832
  packageNames: array(string().min(1)).min(1).optional()
14771
14833
  });
14834
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14835
+ * outage the operator asked for once and forgot. */
14836
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14772
14837
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14773
14838
  var NcScheduleSchema = object({
14774
14839
  windows: array(object({
@@ -15145,15 +15210,15 @@ var NcConditionsSchema = object({
15145
15210
  * (an `immediate` rule naming an `audio-*` class, one notification per
15146
15211
  * classified sample) stays exactly as it was for rules that already use it.
15147
15212
  *
15148
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
15149
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
15150
- * (`camstack/src/data/notification-center.ts`, guarded by
15151
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
15213
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
15214
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
15215
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
15216
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
15152
15217
  * condition fields it does not know when a rule is saved from the phone.
15153
15218
  * Publishing an editor for a condition the app cannot round-trip is how an
15154
- * operator loses a rule's conditions by opening it — so the descriptor, the
15155
- * admin widget and the viewer mirror land together (P2 + P3), and only then
15156
- * does an audio rule become authorable.
15219
+ * operator loses a rule's conditions by opening it — so the viewer mirror
15220
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
15221
+ * follows here.
15157
15222
  */
15158
15223
  audio: NcAudioConditionSchema.optional()
15159
15224
  });
@@ -15389,6 +15454,30 @@ var NcRuleInputSchema = object({
15389
15454
  */
15390
15455
  snoozeAllowGlobal: boolean().optional(),
15391
15456
  /**
15457
+ * The snooze durations THIS rule's notification offers as buttons, in
15458
+ * minutes.
15459
+ *
15460
+ * Three states, and all three are distinct — which is exactly why this is
15461
+ * `.optional()` and never `.default()`. A Zod default does not run on the
15462
+ * addon cap path (three production failures in one day), so a schema default
15463
+ * would collapse the first two:
15464
+ *
15465
+ * | value | meaning |
15466
+ * | --- | --- |
15467
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
15468
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
15469
+ * | a list | these choices, de-duplicated and sorted, at most four |
15470
+ *
15471
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15472
+ * three buttons in total) and a rule that spent it all on snooze choices
15473
+ * would push its own tap-through actions off the notification.
15474
+ *
15475
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15476
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15477
+ * window from anywhere (D133).
15478
+ */
15479
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15480
+ /**
15392
15481
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
15393
15482
  *
15394
15483
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15488,6 +15577,7 @@ var NcConditionDescriptorSchema = object({
15488
15577
  "device",
15489
15578
  "package",
15490
15579
  "occupancy",
15580
+ "audio",
15491
15581
  "system"
15492
15582
  ]),
15493
15583
  label: string(),
@@ -15506,6 +15596,7 @@ var NcConditionDescriptorSchema = object({
15506
15596
  "crossingSelect",
15507
15597
  "polygonDraw",
15508
15598
  "occupancy",
15599
+ "audio",
15509
15600
  "deviceState",
15510
15601
  "systemEvent"
15511
15602
  ]),
@@ -15657,7 +15748,20 @@ var NcSnoozeInputSchema = object({
15657
15748
  ruleId: string().optional(),
15658
15749
  /** Required when `scope: 'device'`. */
15659
15750
  deviceId: number().int().optional(),
15660
- durationMinutes: number().int().min(1).max(1440),
15751
+ /**
15752
+ * Narrow the window to these subject classes — "the cat, not the person".
15753
+ *
15754
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15755
+ * what every window authored before this field meant, so no persisted row
15756
+ * changes meaning and no client has to learn anything to keep working.
15757
+ *
15758
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15759
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15760
+ * not at whichever of their four rules happened to produce the notification
15761
+ * they are dismissing.
15762
+ */
15763
+ classes: array(string().min(1)).min(1).optional(),
15764
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15661
15765
  /**
15662
15766
  * Silence this for EVERY recipient, not just the caller. Permission is
15663
15767
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15682,6 +15786,10 @@ var NcSnoozeSchema = object({
15682
15786
  scope: NcSnoozeScopeSchema,
15683
15787
  ruleId: string().optional(),
15684
15788
  deviceId: number().int().optional(),
15789
+ /** Subject classes this window covers. ABSENT = every class — see
15790
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15791
+ * no SQLite column: nothing queries a window by class. */
15792
+ classes: array(string().min(1)).min(1).optional(),
15685
15793
  startedAt: number(),
15686
15794
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15687
15795
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17919,6 +18027,22 @@ var detectionFpsField = {
17919
18027
  default: 10,
17920
18028
  step: 1
17921
18029
  };
18030
+ /**
18031
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
18032
+ *
18033
+ * The recheck is now on by default (a parked car is invisible to occupancy
18034
+ * rules until the stationary registry has been rebuilt by motion, which after a
18035
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
18036
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
18037
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
18038
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
18039
+ *
18040
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
18041
+ * the host validates `attachCamera` against ITS copy of this schema, so a
18042
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
18043
+ * carrying the wider bound is installed everywhere. 300 is the widest value
18044
+ * that ships with an addon deploy.
18045
+ */
17922
18046
  var occupancyRecheckSecField = {
17923
18047
  min: 0,
17924
18048
  max: 300,
@@ -18120,15 +18244,21 @@ var RunnerCameraConfigSchema = object({
18120
18244
  */
18121
18245
  onboardMotionDrivesAnalyzer: boolean().default(true),
18122
18246
  /**
18123
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
18124
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec`
18125
- * this is off by default because the recheck re-subscribes a detection session
18126
- * every N seconds while `watching`, a major source of pull-decoder re-dial
18127
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
18247
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
18248
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
18128
18249
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
18129
18250
  * (and only render) when this is enabled.
18130
- */
18131
- occupancyRecheckEnabled: boolean().default(false),
18251
+ *
18252
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
18253
+ * recheck re-subscribes a detection session every N seconds while `watching`
18254
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
18255
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
18256
+ * object is counted only while the stationary registry holds it, and the
18257
+ * registry rebuilds from motion, so after a restart a parked car was invisible
18258
+ * to every occupancy rule until something moved in front of it. The churn is
18259
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
18260
+ */
18261
+ occupancyRecheckEnabled: boolean().default(true),
18132
18262
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
18133
18263
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
18134
18264
  /**
@@ -31254,6 +31384,7 @@ Object.freeze({
31254
31384
  "network-access": "ingress",
31255
31385
  "smtp-provider": "email"
31256
31386
  });
31387
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
31257
31388
  new Set(["devices", "classes"]);
31258
31389
  /**
31259
31390
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -13726,11 +13726,33 @@ var NotificationFormatSchema = _enum([
13726
13726
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
13727
13727
  * renderer's icon set; "acknowledge" survives an adapter that draws it
13728
13728
  * differently.
13729
+ *
13730
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
13731
+ *
13732
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
13733
+ * the whole set onto its own renderer's vocabulary through a
13734
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
13735
+ * fallback, so adding a member here fails every adapter's build until someone
13736
+ * decides its glyph, which is the only place that decision can be made
13737
+ * honestly.
13738
+ *
13739
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
13740
+ * `disarm` straight through; iOS feeds that string to
13741
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
13742
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
13743
+ * mapping, and "the field is documented" is not "the value renders".
13744
+ *
13745
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
13746
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
13747
+ * so an addon that emits a token the running hub does not know does not lose an
13748
+ * icon — its whole `send` fails Zod validation and the notification never
13749
+ * arrives. Never emit a new token from an addon before the train carrying it.
13729
13750
  */
13730
13751
  var NotificationActionIconSchema = _enum([
13731
13752
  "acknowledge",
13732
13753
  "dismiss",
13733
13754
  "silence",
13755
+ "snooze",
13734
13756
  "view",
13735
13757
  "play",
13736
13758
  "open",
@@ -13738,9 +13760,13 @@ var NotificationActionIconSchema = _enum([
13738
13760
  "lock",
13739
13761
  "unlock",
13740
13762
  "arm",
13763
+ "arm-home",
13764
+ "arm-away",
13765
+ "arm-night",
13741
13766
  "disarm",
13742
13767
  "light",
13743
- "alert"
13768
+ "alert",
13769
+ "camera"
13744
13770
  ]);
13745
13771
  /** A single tap-through action button. */
13746
13772
  var NotificationActionSchema = object({
@@ -13756,7 +13782,23 @@ var NotificationActionSchema = object({
13756
13782
  * else — see `notification-center/action-token.ts` for what that does and
13757
13783
  * does not buy.
13758
13784
  */
13759
- destructive: boolean().optional()
13785
+ destructive: boolean().optional(),
13786
+ /**
13787
+ * How the tap should REACH the url.
13788
+ *
13789
+ * `navigate` (absent, and every button authored before this field) opens it:
13790
+ * the phone leaves the notification and shows whatever the callback returns.
13791
+ * That is right for a button whose answer the operator wants to read.
13792
+ *
13793
+ * `background` fires it as a POST and stays put. It exists for the buttons
13794
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
13795
+ * an answer to the notification, and being thrown into a browser tab to
13796
+ * confirm it costs more attention than the notification did. A backend that
13797
+ * cannot do a background call renders it as an ordinary link (the adapters
13798
+ * fall back rather than dropping the button), so this is a preference, never
13799
+ * a requirement.
13800
+ */
13801
+ mode: _enum(["navigate", "background"]).optional()
13760
13802
  });
13761
13803
  /**
13762
13804
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13924,6 +13966,24 @@ method(object({}), array(TargetKindSchema)), method(object({}), array(TargetSche
13924
13966
  targetId: string(),
13925
13967
  enabled: boolean()
13926
13968
  }), _void(), { kind: "mutation" });
13969
+ new Set([
13970
+ {
13971
+ id: "person",
13972
+ name: "Person"
13973
+ },
13974
+ {
13975
+ id: "vehicle",
13976
+ name: "Vehicle"
13977
+ },
13978
+ {
13979
+ id: "animal",
13980
+ name: "Animal"
13981
+ },
13982
+ {
13983
+ id: "package",
13984
+ name: "Package"
13985
+ }
13986
+ ].map((l) => l.id));
13927
13987
  var COCO_TO_MACRO = {
13928
13988
  mapping: {
13929
13989
  person: "person",
@@ -14721,6 +14781,8 @@ var NcSystemEventKindSchema = _enum([
14721
14781
  "alarm-triggered",
14722
14782
  "alarm-armed",
14723
14783
  "alarm-disarmed",
14784
+ "alarm-arming",
14785
+ "alarm-arm-refused",
14724
14786
  "camera-online",
14725
14787
  "camera-offline",
14726
14788
  "camera-disabled",
@@ -14757,6 +14819,9 @@ var NcSystemEventConditionSchema = object({
14757
14819
  nodeIds: array(string().min(1)).min(1).optional(),
14758
14820
  packageNames: array(string().min(1)).min(1).optional()
14759
14821
  });
14822
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
14823
+ * outage the operator asked for once and forgot. */
14824
+ var NC_SNOOZE_MAX_MINUTES = 1440;
14760
14825
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
14761
14826
  var NcScheduleSchema = object({
14762
14827
  windows: array(object({
@@ -15133,15 +15198,15 @@ var NcConditionsSchema = object({
15133
15198
  * (an `immediate` rule naming an `audio-*` class, one notification per
15134
15199
  * classified sample) stays exactly as it was for rules that already use it.
15135
15200
  *
15136
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
15137
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
15138
- * (`camstack/src/data/notification-center.ts`, guarded by
15139
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
15201
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
15202
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
15203
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
15204
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
15140
15205
  * condition fields it does not know when a rule is saved from the phone.
15141
15206
  * Publishing an editor for a condition the app cannot round-trip is how an
15142
- * operator loses a rule's conditions by opening it — so the descriptor, the
15143
- * admin widget and the viewer mirror land together (P2 + P3), and only then
15144
- * does an audio rule become authorable.
15207
+ * operator loses a rule's conditions by opening it — so the viewer mirror
15208
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
15209
+ * follows here.
15145
15210
  */
15146
15211
  audio: NcAudioConditionSchema.optional()
15147
15212
  });
@@ -15377,6 +15442,30 @@ var NcRuleInputSchema = object({
15377
15442
  */
15378
15443
  snoozeAllowGlobal: boolean().optional(),
15379
15444
  /**
15445
+ * The snooze durations THIS rule's notification offers as buttons, in
15446
+ * minutes.
15447
+ *
15448
+ * Three states, and all three are distinct — which is exactly why this is
15449
+ * `.optional()` and never `.default()`. A Zod default does not run on the
15450
+ * addon cap path (three production failures in one day), so a schema default
15451
+ * would collapse the first two:
15452
+ *
15453
+ * | value | meaning |
15454
+ * | --- | --- |
15455
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
15456
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
15457
+ * | a list | these choices, de-duplicated and sorted, at most four |
15458
+ *
15459
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
15460
+ * three buttons in total) and a rule that spent it all on snooze choices
15461
+ * would push its own tap-through actions off the notification.
15462
+ *
15463
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
15464
+ * that arms the panel, is exempt automatically and cannot be silenced by a
15465
+ * window from anywhere (D133).
15466
+ */
15467
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
15468
+ /**
15380
15469
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
15381
15470
  *
15382
15471
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -15476,6 +15565,7 @@ var NcConditionDescriptorSchema = object({
15476
15565
  "device",
15477
15566
  "package",
15478
15567
  "occupancy",
15568
+ "audio",
15479
15569
  "system"
15480
15570
  ]),
15481
15571
  label: string(),
@@ -15494,6 +15584,7 @@ var NcConditionDescriptorSchema = object({
15494
15584
  "crossingSelect",
15495
15585
  "polygonDraw",
15496
15586
  "occupancy",
15587
+ "audio",
15497
15588
  "deviceState",
15498
15589
  "systemEvent"
15499
15590
  ]),
@@ -15645,7 +15736,20 @@ var NcSnoozeInputSchema = object({
15645
15736
  ruleId: string().optional(),
15646
15737
  /** Required when `scope: 'device'`. */
15647
15738
  deviceId: number().int().optional(),
15648
- durationMinutes: number().int().min(1).max(1440),
15739
+ /**
15740
+ * Narrow the window to these subject classes — "the cat, not the person".
15741
+ *
15742
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
15743
+ * what every window authored before this field meant, so no persisted row
15744
+ * changes meaning and no client has to learn anything to keep working.
15745
+ *
15746
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
15747
+ * cross rules (D133): the operator points at a camera and a kind of thing,
15748
+ * not at whichever of their four rules happened to produce the notification
15749
+ * they are dismissing.
15750
+ */
15751
+ classes: array(string().min(1)).min(1).optional(),
15752
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
15649
15753
  /**
15650
15754
  * Silence this for EVERY recipient, not just the caller. Permission is
15651
15755
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -15670,6 +15774,10 @@ var NcSnoozeSchema = object({
15670
15774
  scope: NcSnoozeScopeSchema,
15671
15775
  ruleId: string().optional(),
15672
15776
  deviceId: number().int().optional(),
15777
+ /** Subject classes this window covers. ABSENT = every class — see
15778
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
15779
+ * no SQLite column: nothing queries a window by class. */
15780
+ classes: array(string().min(1)).min(1).optional(),
15673
15781
  startedAt: number(),
15674
15782
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
15675
15783
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -17907,6 +18015,22 @@ var detectionFpsField = {
17907
18015
  default: 10,
17908
18016
  step: 1
17909
18017
  };
18018
+ /**
18019
+ * The occupancy re-check interval. DEFAULT 300 s (2026-08-13 — was 30 s).
18020
+ *
18021
+ * The recheck is now on by default (a parked car is invisible to occupancy
18022
+ * rules until the stationary registry has been rebuilt by motion, which after a
18023
+ * restart may be never on a quiet camera). Each cycle re-subscribes a detection
18024
+ * session — an RTSP re-dial — so the switch is only affordable at a WIDE
18025
+ * interval: 300 s is ~12 re-dials an hour per camera, against 120 at the old
18026
+ * 30 s. A parked car is therefore counted within 5 minutes of a restart.
18027
+ *
18028
+ * Why not wider: `max` is 300 and raising it is TRAIN-BOUND, not addon-bound —
18029
+ * the host validates `attachCamera` against ITS copy of this schema, so a
18030
+ * runner asked for 600 would be rejected by the hub until a `@camstack/server`
18031
+ * carrying the wider bound is installed everywhere. 300 is the widest value
18032
+ * that ships with an addon deploy.
18033
+ */
17910
18034
  var occupancyRecheckSecField = {
17911
18035
  min: 0,
17912
18036
  max: 300,
@@ -18108,15 +18232,21 @@ var RunnerCameraConfigSchema = object({
18108
18232
  */
18109
18233
  onboardMotionDrivesAnalyzer: boolean().default(true),
18110
18234
  /**
18111
- * Master toggle for the occupancy re-check. When `false` (DEFAULT) the runner
18112
- * never arms the periodic recheck timer, regardless of `occupancyRecheckSec`
18113
- * this is off by default because the recheck re-subscribes a detection session
18114
- * every N seconds while `watching`, a major source of pull-decoder re-dial
18115
- * churn (each cycle creates+tears a session → RTSP re-dial → latency). The
18235
+ * Master toggle for the occupancy re-check. When `false` the runner never arms
18236
+ * the periodic recheck timer, regardless of `occupancyRecheckSec`; the
18116
18237
  * `occupancyRecheckSec` / `occupancyRecheckFrames` sliders only take effect
18117
18238
  * (and only render) when this is enabled.
18118
- */
18119
- occupancyRecheckEnabled: boolean().default(false),
18239
+ *
18240
+ * DEFAULT `true` since 2026-08-13 (was `false`). It was off because the
18241
+ * recheck re-subscribes a detection session every N seconds while `watching`
18242
+ * — each cycle creates+tears a session ⇒ an RTSP re-dial ⇒ latency, a major
18243
+ * pull-decoder churn source. What that bought was a blind spot: a STATIONARY
18244
+ * object is counted only while the stationary registry holds it, and the
18245
+ * registry rebuilds from motion, so after a restart a parked car was invisible
18246
+ * to every occupancy rule until something moved in front of it. The churn is
18247
+ * now paid on the interval instead — see `occupancyRecheckSecField`.
18248
+ */
18249
+ occupancyRecheckEnabled: boolean().default(true),
18120
18250
  occupancyRecheckSec: number().min(occupancyRecheckSecField.min).max(occupancyRecheckSecField.max).default(occupancyRecheckSecField.default),
18121
18251
  occupancyRecheckFrames: number().min(occupancyRecheckFramesField.min).max(occupancyRecheckFramesField.max).default(occupancyRecheckFramesField.default),
18122
18252
  /**
@@ -31242,6 +31372,7 @@ Object.freeze({
31242
31372
  "network-access": "ingress",
31243
31373
  "smtp-provider": "email"
31244
31374
  });
31375
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
31245
31376
  new Set(["devices", "classes"]);
31246
31377
  /**
31247
31378
  * 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-hap",
3
- "version": "1.2.25",
3
+ "version": "1.2.27",
4
4
  "description": "HomeKit (HAP) bridge exporter for CamStack devices. Publishes a bridged accessory per exposed device — MotionSensor in this MVP; Camera/Doorbell/Switch/Light follow.",
5
5
  "keywords": [
6
6
  "camstack",