@camstack/addon-smtp-nodemailer 1.2.100 → 1.2.102

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.
@@ -34,7 +34,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
34
34
  var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
35
35
  var __require = /* @__PURE__ */ createRequire(import.meta.url);
36
36
  //#endregion
37
- //#region ../types/dist/event-category-ZyX6jcse.mjs
37
+ //#region ../types/dist/event-category-BVDXG4tB.mjs
38
38
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
39
39
  EventCategory["SystemBoot"] = "system.boot";
40
40
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -651,6 +651,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
651
651
  * pull-reconcile from the provider's `getStatus` on reconnect. */
652
652
  EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
653
653
  EventCategory["BackupCompleted"] = "backup.completed";
654
+ /**
655
+ * A whole backup RUN finished — every destination attempted, win or lose.
656
+ *
657
+ * `backup.completed` fires once per DESTINATION, which is the right grain for
658
+ * a progress UI and the wrong one for a notification: an operator with three
659
+ * destinations would be told three times. And a run where two of three
660
+ * destinations succeeded is not a clean success — a single "backup
661
+ * completed" that hid the failed one would be a lie, so the count of each is
662
+ * carried here and the message says both.
663
+ *
664
+ * Emitted by the backup orchestrator only after the destination loop, so a
665
+ * run that dies during the BUILD phase produces no completion at all.
666
+ */
667
+ EventCategory["BackupRunCompleted"] = "backup.run-completed";
654
668
  EventCategory["BackupRestored"] = "backup.restored";
655
669
  EventCategory["NotificationDispatched"] = "notification.dispatched";
656
670
  EventCategory["NotificationFailed"] = "notification.failed";
@@ -5381,7 +5395,7 @@ var ZodIssueCode = {
5381
5395
  var ZodFirstPartyTypeKind;
5382
5396
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5383
5397
  //#endregion
5384
- //#region ../types/dist/sleep-DBKu2-U5.mjs
5398
+ //#region ../types/dist/sleep-BDR76Ykr.mjs
5385
5399
  /**
5386
5400
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5387
5401
  * window to float samples (D455).
@@ -11509,6 +11523,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11509
11523
  auth: "admin"
11510
11524
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11511
11525
  DeviceType.Camera;
11526
+ /**
11527
+ * The signals a device can emit to WAKE its own stream.
11528
+ *
11529
+ * A camera whose stream is built on demand sleeps until something asks for it,
11530
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
11531
+ * puller holds a session open for ever, and treating that as demand would keep
11532
+ * a battery camera awake for ever, which is the whole thing the battery is for
11533
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
11534
+ * itself, with no stream running.
11535
+ *
11536
+ * ## The vocabulary is the PROVIDER'S, not ours
11537
+ *
11538
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
11539
+ * names each signal with a `code` it chooses and a `label` an operator reads.
11540
+ * Reolink offers motion and camera-native detection; another provider may offer
11541
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
11542
+ * yet. A fixed enum here would mean every new signal is a framework release.
11543
+ *
11544
+ * It is deliberately NOT derived from the caps a device already binds. Whether
11545
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
11546
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
11547
+ * binding — but both answer "what drives the detection pipeline", which is a
11548
+ * different question from "what may wake a sleeping stream". A camera can do
11549
+ * the first and not be trusted with the second, and the operator picks per
11550
+ * camera. Two questions, two authorities.
11551
+ *
11552
+ * ## Availability is not permission
11553
+ *
11554
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
11555
+ * wakes the stream is the operator's per-camera choice, held by the broker
11556
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
11557
+ * provider declaring a signal is not a provider enabling it.
11558
+ */
11559
+ /** One signal a device can emit. */
11560
+ var StreamSignalSchema = object({
11561
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
11562
+ code: string().min(1),
11563
+ /** What an operator reads in the picker. The provider's own wording. */
11564
+ label: string().min(1),
11565
+ /**
11566
+ * Whether the provider recommends this signal ON when a camera is first set
11567
+ * up. A provider knows which of its signals are cheap and reliable; an
11568
+ * operator should not have to discover that by trial. Reolink recommends
11569
+ * both of its own.
11570
+ */
11571
+ recommended: boolean()
11572
+ });
11573
+ object({
11574
+ signals: array(StreamSignalSchema),
11575
+ lastFetchedAt: number()
11576
+ });
11577
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
11512
11578
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11513
11579
  var StreamFormatSchema = _enum([
11514
11580
  "webrtc",
@@ -11905,6 +11971,22 @@ var EgressTranscodeSchema = object({
11905
11971
  camStreamId: string().nullable()
11906
11972
  });
11907
11973
  method(object({
11974
+ deviceId: number().int().nonnegative(),
11975
+ /** The provider's signal code. */
11976
+ code: string().min(1),
11977
+ /** Ms epoch. Absent ⇒ now. */
11978
+ at: number().optional()
11979
+ }), object({
11980
+ /** Whether the broker acted on it, and if not, why. */
11981
+ accepted: boolean(),
11982
+ reason: _enum([
11983
+ "woke",
11984
+ "hold-extended",
11985
+ "not-enabled",
11986
+ "no-consumer",
11987
+ "unknown-code"
11988
+ ])
11989
+ }), { kind: "mutation" }), method(object({
11908
11990
  deviceId: number().int().nonnegative(),
11909
11991
  camStreamId: string().min(1),
11910
11992
  kind: CamStreamKindSchema,
@@ -12159,6 +12241,16 @@ var PickStreamRequirementsSchema = object({
12159
12241
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12160
12242
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12161
12243
  minHeight: number().int().positive().optional(),
12244
+ /**
12245
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12246
+ *
12247
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12248
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12249
+ * Without this the ceiling had to be re-implemented by every caller — and
12250
+ * one caller implementing it privately is how a second scoring authority
12251
+ * gets born.
12252
+ */
12253
+ maxHeight: number().int().positive().optional(),
12162
12254
  /** Minimum horizontal resolution. */
12163
12255
  minWidth: number().int().positive().optional(),
12164
12256
  /**
@@ -12175,7 +12267,22 @@ var PickStreamRequirementsSchema = object({
12175
12267
  * transcoded" guard: if the device is already serving the consumer's
12176
12268
  * codec end-to-end, there's nothing to optimise.
12177
12269
  */
12178
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12270
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12271
+ /**
12272
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12273
+ * understanding that it will be transcoded.
12274
+ *
12275
+ * Default `false` — today's behaviour, and the right one for a bypass
12276
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12277
+ * ask the larger question: "what is the best stream for me, transcoding if
12278
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12279
+ * does not, so a passthrough is never lost to a transcode; the answer says
12280
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12281
+ *
12282
+ * This is what lets one picker serve both the bypass and the full source
12283
+ * choice, instead of a consumer scoring privately when the bypass misses.
12284
+ */
12285
+ allowTranscode: boolean().optional()
12179
12286
  }).readonly();
12180
12287
  var PickStreamPreferencesSchema = object({
12181
12288
  /**
@@ -12189,12 +12296,32 @@ var PickStreamPreferencesSchema = object({
12189
12296
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12190
12297
  * memory-constrained consumers / Apple Home guest sessions).
12191
12298
  */
12192
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12299
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12300
+ /**
12301
+ * The height the consumer actually wants to DELIVER.
12302
+ *
12303
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12304
+ * above the target wins, and only if nothing reaches it does the tallest
12305
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12306
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12307
+ * express that: it says "as big as possible", which is a different wish.
12308
+ *
12309
+ * Ignored when absent, so every existing caller keeps its ordering.
12310
+ */
12311
+ targetHeight: number().int().positive().optional()
12193
12312
  }).readonly();
12194
12313
  var PickedCamStreamSchema = object({
12195
12314
  camStreamId: string(),
12196
12315
  codec: string().optional(),
12197
12316
  resolution: CamStreamResolutionSchema.optional(),
12317
+ /**
12318
+ * Whether serving this stream requires a decode + re-encode.
12319
+ *
12320
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12321
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12322
+ * not ask cannot be handed a cost it never agreed to pay.
12323
+ */
12324
+ transcodes: boolean(),
12198
12325
  /** One-line explanation of why this stream won — for logs / debug UI. */
12199
12326
  reason: string()
12200
12327
  });
@@ -16383,6 +16510,8 @@ var NcSystemEventKindSchema = _enum([
16383
16510
  "device-enabled",
16384
16511
  "device-battery-low",
16385
16512
  "device-battery-normal",
16513
+ "device-consumable-low",
16514
+ "device-consumable-normal",
16386
16515
  "stream-online",
16387
16516
  "stream-offline",
16388
16517
  "node-online",
@@ -16401,6 +16530,7 @@ var NcSystemEventKindSchema = _enum([
16401
16530
  "addon-updated",
16402
16531
  "server-updated",
16403
16532
  "export-completed",
16533
+ "backup-completed",
16404
16534
  "camera-online",
16405
16535
  "camera-offline",
16406
16536
  "camera-disabled",
@@ -17723,6 +17853,48 @@ var NcAlarmConfigSchema = object({
17723
17853
  settings: NcAlarmSettingsSchema,
17724
17854
  coverage: array(NcAlarmModeCoverageSchema)
17725
17855
  });
17856
+ /**
17857
+ * ONE rule's demand on ONE camera's clip ring.
17858
+ *
17859
+ * A rule, not a camera: the broker takes the MAX over the asks that reach a
17860
+ * camera, so the answer stays a faithful description of the rules and the
17861
+ * bounding (the byte budget, the broker's own ceiling) stays where the cost
17862
+ * lives. A camera that appears in no ask is being told **nothing** — which is
17863
+ * a different thing from never having been told, and only the envelope
17864
+ * (`rulesLoaded`) can tell those apart.
17865
+ */
17866
+ var NcClipRetentionAskSchema = object({
17867
+ /**
17868
+ * The camera this ask is about. **Absent = every camera**, which is what a
17869
+ * rule with no `conditions.devices` means: it can fire anywhere, so it is
17870
+ * asking everywhere.
17871
+ */
17872
+ deviceId: number().int().nonnegative().optional(),
17873
+ /** Seconds of history the rule needs held for it. Never zero — a rule that
17874
+ * needs nothing produces no ask at all. */
17875
+ seconds: number().min(0).max(60),
17876
+ /** The profile the rule cuts from, when it named one. Absent = the cheapest
17877
+ * assigned, which is what the cut defaults to. */
17878
+ profile: CamProfileSchema.optional(),
17879
+ /** Who is asking — so a retention the operator did not expect names a rule. */
17880
+ ruleId: string(),
17881
+ ruleName: string(),
17882
+ /** Why this many seconds: the rule's own window, or the occupancy ceiling. */
17883
+ reason: _enum(["window", "occupancy"])
17884
+ });
17885
+ /**
17886
+ * The whole answer, with the one bit that keeps absence from reading as zero.
17887
+ *
17888
+ * `rulesLoaded` is false until the rule ledger has completed a load at least
17889
+ * once. A centre that is up but has not read its rules yet answers with an
17890
+ * empty ask list that means nothing at all — applying it would drop every
17891
+ * camera's ring to zero for the first events after a restart, which is the
17892
+ * footage this mechanism exists to keep.
17893
+ */
17894
+ var NcClipRetentionPlanSchema = object({
17895
+ rulesLoaded: boolean(),
17896
+ asks: array(NcClipRetentionAskSchema).readonly()
17897
+ });
17726
17898
  method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), method(object({ ruleId: string() }), object({ rule: NcRuleSchema.nullable() }), { auth: "admin" }), method(object({ rule: NcRuleInputSchema }), object({ rule: NcRuleSchema }), {
17727
17899
  kind: "mutation",
17728
17900
  auth: "admin",
@@ -17743,7 +17915,7 @@ method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), m
17743
17915
  }), object({ success: literal(true) }), {
17744
17916
  kind: "mutation",
17745
17917
  auth: "admin"
17746
- }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
17918
+ }), method(object({}), NcClipRetentionPlanSchema, { auth: "admin" }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
17747
17919
  deviceId: number().int(),
17748
17920
  muted: boolean()
17749
17921
  }), object({ success: literal(true) }), {
@@ -20277,6 +20449,33 @@ var RunReplayFrameProcessorResultSchema = object({ tracks: array(object({
20277
20449
  * solid is this track", cheaper than re-deriving it from a trajectory. */
20278
20450
  framesMatched: number().int()
20279
20451
  })).readonly() });
20452
+ /**
20453
+ * The long-term series a camera produces. A closed union so a typo cannot
20454
+ * invent one, and the ONE declaration of it — the addon's `AnalyticsLtsSeries`
20455
+ * is an alias of this, not a second list.
20456
+ */
20457
+ var AnalyticsLtsSeriesSchema = _enum([
20458
+ "motion",
20459
+ "audio-dbfs",
20460
+ "battery",
20461
+ "occupancy"
20462
+ ]);
20463
+ /**
20464
+ * One closed 5-minute bucket of a long-term series.
20465
+ *
20466
+ * `samples` is how many readings the bucket folded — it is the ACTIVITY for a
20467
+ * series like `motion`, and the confidence for one like `occupancy`. A bucket
20468
+ * that exists at all was measured; a bucket that is absent was not, which is a
20469
+ * different claim from zero and the reason this is a sparse series.
20470
+ */
20471
+ var LtsBucketSchema = object({
20472
+ scope: string(),
20473
+ bucketStart: number().int(),
20474
+ samples: number().int().nonnegative(),
20475
+ sum: number(),
20476
+ min: number(),
20477
+ max: number()
20478
+ });
20280
20479
  DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).readonly()), method(object({
20281
20480
  deviceId: number(),
20282
20481
  trackId: string()
@@ -20323,6 +20522,14 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20323
20522
  kinds: array(string()).optional(),
20324
20523
  limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
20325
20524
  }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(KeyEventBatchQueryInput, array(KeyEventsForDeviceSchema).readonly()), method(object({
20525
+ deviceId: number(),
20526
+ series: AnalyticsLtsSeriesSchema,
20527
+ /** Omit for EVERY scope of this series in the range. */
20528
+ scope: string().optional(),
20529
+ from: number(),
20530
+ to: number(),
20531
+ limit: number().int().positive().optional()
20532
+ }), array(LtsBucketSchema).readonly()), method(object({
20326
20533
  deviceId: number(),
20327
20534
  since: number(),
20328
20535
  until: number(),
@@ -20941,6 +21148,14 @@ var MotionSourceEnum = _enum([
20941
21148
  */
20942
21149
  var MotionSourcesSchema = array(MotionSourceEnum);
20943
21150
  /**
21151
+ * Which root detectors a camera runs. Deliberately the SAME vocabulary
21152
+ * post-analysis already tags every detection with (`DetectionSource`) rather
21153
+ * than a second spelling of the same two ideas — the value an operator picks
21154
+ * here is the value that comes back on the track, the overlay and the debug
21155
+ * row.
21156
+ */
21157
+ var DetectionSourcesSchema = array(DetectionSourceSchema);
21158
+ /**
20944
21159
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
20945
21160
  * so cap-side consumers (the orchestrator forward, the runner addon's
20946
21161
  * cap implementation, tests) can reuse the type instead of redeclaring
@@ -21091,6 +21306,35 @@ var RunnerCameraConfigSchema = object({
21091
21306
  * events; the orchestrator forwards to `reportMotion`.
21092
21307
  */
21093
21308
  motionSources: MotionSourcesSchema.default(["analyzer"]),
21309
+ /**
21310
+ * WHICH root detector runs for this camera. The detection counterpart of
21311
+ * {@link motionSources}, same shape and same discipline: a per-camera list
21312
+ * of sources the system understands, vendor-agnostic, owned here.
21313
+ *
21314
+ * - `pipeline` — this runner's own root step on decoded pixels (`steps`).
21315
+ * - `onboard` — the CAMERA's own detector, admitted only when it is named
21316
+ * here. Its boxes reach post-analysis on the same
21317
+ * `PipelineInferenceResult` payload as the pipeline's, so an onboard-born
21318
+ * track gets the same tracker, the same overlay and the same detail
21319
+ * subtree (face / plate / embedding).
21320
+ *
21321
+ * `['onboard']` alone is the REPLACEMENT: this runner's root step does not
21322
+ * run, and that is where a camera with a usable onboard detector buys back
21323
+ * its share of the accelerator. It saves the root inference, not the decode
21324
+ * — the detail subtree still needs pixels to cut crops from.
21325
+ *
21326
+ * A camera whose onboard detections carry no geometry cannot serve as a root
21327
+ * step at all (there is nothing to track), and the cap that knows this says
21328
+ * so on `native-object-detection.getOptions().geometry`. On Reolink that is
21329
+ * every battery camera: the boxes ride a sub-stream a battery camera never
21330
+ * attaches, so such a camera stays on `['pipeline']` and its onboard AI is
21331
+ * worth exactly what it already is — a wake signal with a class.
21332
+ *
21333
+ * Defaults to `['pipeline']`, which is byte-for-byte today's behaviour: a
21334
+ * vendor never turns a detector on for the operator, and neither does a
21335
+ * default.
21336
+ */
21337
+ detectionSources: DetectionSourcesSchema.default(["pipeline"]),
21094
21338
  pipelineEnabled: boolean().default(true),
21095
21339
  /** Ordered tree of video steps. Absent → runner skips video detection. */
21096
21340
  steps: array(PipelineStepInputSchema).readonly().optional(),
@@ -21272,7 +21516,47 @@ var RunnerLocalMetricsSchema = object({
21272
21516
  queueDepth: number(),
21273
21517
  frameLazy: FrameLazyMetricsSchema.optional()
21274
21518
  });
21519
+ /**
21520
+ * Pipeline Runner capability — runtime detection workhorse.
21521
+ *
21522
+ * One instance per node. Receives camera assignments from
21523
+ * `addon-pipeline-orchestrator`, subscribes to the local stream-broker for
21524
+ * decoded frames, drains motion + detection queues, calls the local
21525
+ * `motion-detection` and `pipeline-executor` capabilities, and emits typed
21526
+ * `pipeline.inference-result` and `detection.motion-analysis` events on
21527
+ * the bus.
21528
+ *
21529
+ * Distinct from `pipeline-orchestrator` (the hub-side load balancer) — the
21530
+ * runner has zero knowledge of other agents, no global state, and never
21531
+ * makes assignment decisions itself.
21532
+ */
21533
+ /**
21534
+ * Why a runner declined to look at a camera out of band. Named rather than a
21535
+ * bare `false`: a camera asleep on battery (D173), one attached elsewhere, one
21536
+ * already mid-session and one already bursting are four different facts, and a
21537
+ * caller told only "no" cannot tell a protection from a bug.
21538
+ */
21539
+ var OccupancyBurstRefusalSchema = _enum([
21540
+ "not-attached",
21541
+ "battery-asleep",
21542
+ "not-watching",
21543
+ "already-bursting"
21544
+ ]);
21275
21545
  method(RunnerCameraConfigSchema, object({ success: literal(true) }), { kind: "mutation" }), method(object({ deviceId: number() }), object({ success: literal(true) }), { kind: "mutation" }), method(ReportMotionInputSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), RunnerLocalLoadSchema), method(_void(), RunnerLocalMetricsSchema), method(object({ deviceId: number() }), CameraMetricsSchema.nullable()), method(_void(), array(CameraMetricsWithDeviceIdSchema).readonly()), method(_void(), array(number()).readonly()), method(object({
21546
+ deviceId: number(),
21547
+ /** How many frames to collect. The caller sizes this against what its
21548
+ * own confirmation needs; the runner clamps it to the field's range. */
21549
+ frames: number().int().positive().optional(),
21550
+ /** Why, for the log. A burst nobody can attribute is a cost nobody can
21551
+ * defend — the periodic one at least has a timer to point at. */
21552
+ reason: string()
21553
+ }), object({
21554
+ started: boolean(),
21555
+ refusedBecause: OccupancyBurstRefusalSchema.optional()
21556
+ }), {
21557
+ auth: "admin",
21558
+ kind: "mutation"
21559
+ }), method(object({
21276
21560
  handle: FrameHandleSchema,
21277
21561
  bbox: NativeCropBboxSchema,
21278
21562
  maxWidth: number().int().positive().optional(),
@@ -23655,10 +23939,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23655
23939
  }), boolean()), method(object({
23656
23940
  deviceId: number().int().nonnegative(),
23657
23941
  sessionId: string()
23658
- }), object({ pendingRenegotiation: object({
23659
- target: WebrtcStreamTargetSchema,
23660
- epoch: number()
23661
- }).nullable() }));
23942
+ }), object({
23943
+ pendingRenegotiation: object({
23944
+ target: WebrtcStreamTargetSchema,
23945
+ epoch: number()
23946
+ }).nullable(),
23947
+ /**
23948
+ * Whether the session still EXISTS.
23949
+ *
23950
+ * A consumer that holds a resource for the life of a session needs to
23951
+ * be able to ask, because a session does not always end the way it
23952
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
23953
+ * sent `SessionDisconnected`, so the Alexa exporter's
23954
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
23955
+ * H.264 transcode kept running for NOBODY for more than twenty
23956
+ * minutes. The WebRTC session had logged `WebRTC session closed`
23957
+ * minutes earlier — the broker knew; the holder had no way to ask.
23958
+ *
23959
+ * `false` for a session id the provider has never heard of, which is
23960
+ * the same answer as "it ended": either way nothing is holding it up.
23961
+ */
23962
+ alive: boolean()
23963
+ }));
23662
23964
  object({
23663
23965
  /** All accessory children of the parent. */
23664
23966
  childDeviceIds: array(number()).readonly(),
@@ -26736,7 +27038,7 @@ var NativeDetectionSchema = object({
26736
27038
  /** Firmware-provided confidence [0..1]. Reolink pushes don't carry it → undefined. */
26737
27039
  confidence: number().min(0).max(1).optional()
26738
27040
  });
26739
- object({
27041
+ var NativeObjectDetectionStatusSchema = object({
26740
27042
  /**
26741
27043
  * Last observed instance per class. Missing entries mean the class
26742
27044
  * is supported but nothing has been seen since the provider started.
@@ -26753,14 +27055,56 @@ object({
26753
27055
  supportedClasses: array(NativeObjectClassEnum).readonly(),
26754
27056
  /**
26755
27057
  * Whether forwarding of onboard AI detections is enabled for this device.
26756
- * Default FALSE (opt-in, cold-start) — onboard AI pushes are noisy/sparse and
26757
- * churn the tracker, so forwarding stays off until the operator enables it.
27058
+ *
27059
+ * Cold-start OFF on every camera. A vendor does not decide which detector a
27060
+ * camera runs — that is the operator's choice, and it is made where every
27061
+ * other detection choice is made. `geometry` on
27062
+ * {@link NativeObjectDetectionOptionsSchema} is how the form says what the
27063
+ * choice would buy this particular camera.
26758
27064
  */
26759
27065
  enabled: boolean()
26760
- }).extend({
27066
+ });
27067
+ /**
27068
+ * WHEN a camera's onboard detections carry geometry.
27069
+ *
27070
+ * - `boxed` — always. The provider holds a standing channel for the boxes, so
27071
+ * a detection is a trackable subject whenever the camera sees one.
27072
+ * - `while-streaming` — only while some stream of this camera is already open.
27073
+ * The boxes ride the video's own side-channel rather than a feed of their
27074
+ * own, so they cost nothing and they exist only when something is pulling.
27075
+ * On Reolink this is every BATTERY camera: a persistent second feed is real
27076
+ * radio drain, but a camera that is awake is awake precisely because
27077
+ * something is in front of it, and its stream is already being pulled.
27078
+ * - `flag-only` — never. The firmware ships the class and nothing else; the
27079
+ * pipeline needs geometry to make a subject, so such a push reaches the
27080
+ * tracker as motion and no further.
27081
+ *
27082
+ * Reported and not inferred, because the operator's question in front of the
27083
+ * picker is "what do I get", and these are three different answers (D14: the
27084
+ * derived form is only as honest as `getOptions`).
27085
+ */
27086
+ var NativeObjectGeometryEnum = _enum([
27087
+ "boxed",
27088
+ "while-streaming",
27089
+ "flag-only"
27090
+ ]);
27091
+ var NativeObjectDetectionOptionsSchema = object({
27092
+ /** Classes this firmware can detect — the same list the status reports. */
27093
+ supportedClasses: array(NativeObjectClassEnum).readonly(),
27094
+ /** What a detection from this camera carries. */
27095
+ geometry: NativeObjectGeometryEnum
27096
+ });
27097
+ var NativeObjectDetectionSettingsPatchSchema = object({ enabled: boolean().optional() });
27098
+ NativeObjectDetectionStatusSchema.extend({
26761
27099
  /** Required by createRuntimeStateBridge — epoch ms of last refresh. */
26762
27100
  lastFetchedAt: number() });
26763
- DeviceType.Camera, method(object({
27101
+ DeviceType.Camera, method(object({ deviceId: number() }), NativeObjectDetectionOptionsSchema), method(object({
27102
+ deviceId: number(),
27103
+ settings: NativeObjectDetectionSettingsPatchSchema
27104
+ }), _void(), {
27105
+ kind: "mutation",
27106
+ auth: "admin"
27107
+ }), method(object({
26764
27108
  deviceId: number(),
26765
27109
  enabled: boolean()
26766
27110
  }), _void(), {
@@ -30559,7 +30903,28 @@ var PerScopeBreakdownSchema = object({
30559
30903
  /** Total tracked objects in this scope (frame / zone / unzoned). */
30560
30904
  totalObjects: number().int().nonnegative(),
30561
30905
  /** Per-class count. Keys are macro class names (e.g. `person`, `car`). */
30562
- byClass: record(string(), number().int().nonnegative())
30906
+ byClass: record(string(), number().int().nonnegative()),
30907
+ /**
30908
+ * Of `totalObjects`, how many are STANDING — objects the census holds,
30909
+ * present but not going anywhere (a parked car, a bin, a statue).
30910
+ *
30911
+ * The operator's question about a scene has two halves and they answer
30912
+ * different things: "what is parked here" is stable for hours and must not
30913
+ * flap, while "who is walking through" is the thing an alert is about. One
30914
+ * number could only serve one of them, and `totalObjects` served the first
30915
+ * badly — a passer-by moved it and every occupancy rule saw a change.
30916
+ *
30917
+ * `standing + transient === totalObjects`, always. The total keeps its old
30918
+ * meaning exactly, so no rule written against it changes behaviour.
30919
+ *
30920
+ * ABSENT means UNKNOWN, never zero (D393): a snapshot from a node older than
30921
+ * this field cannot say, and a reader that folds absence in as 0 reports "no
30922
+ * parked objects here" about a camera whose lot is full.
30923
+ */
30924
+ standingObjects: number().int().nonnegative().optional(),
30925
+ /** Of `totalObjects`, how many are passing through. See `standingObjects` —
30926
+ * same absence rule. */
30927
+ transientObjects: number().int().nonnegative().optional()
30563
30928
  });
30564
30929
  var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
30565
30930
  zoneId: string(),
@@ -33498,12 +33863,24 @@ Object.freeze({
33498
33863
  addonId: null,
33499
33864
  access: "create"
33500
33865
  },
33866
+ "nativeObjectDetection.getOptions": {
33867
+ capName: "native-object-detection",
33868
+ capScope: "device",
33869
+ addonId: null,
33870
+ access: "view"
33871
+ },
33501
33872
  "nativeObjectDetection.setEnabled": {
33502
33873
  capName: "native-object-detection",
33503
33874
  capScope: "device",
33504
33875
  addonId: null,
33505
33876
  access: "create"
33506
33877
  },
33878
+ "nativeObjectDetection.setSettings": {
33879
+ capName: "native-object-detection",
33880
+ capScope: "device",
33881
+ addonId: null,
33882
+ access: "create"
33883
+ },
33507
33884
  "navigation.getFeatures": {
33508
33885
  capName: "navigation",
33509
33886
  capScope: "device",
@@ -33768,6 +34145,12 @@ Object.freeze({
33768
34145
  addonId: null,
33769
34146
  access: "view"
33770
34147
  },
34148
+ "notificationRules.getClipRetentionAsks": {
34149
+ capName: "notification-rules",
34150
+ capScope: "system",
34151
+ addonId: null,
34152
+ access: "view"
34153
+ },
33771
34154
  "notificationRules.getConditionCatalog": {
33772
34155
  capName: "notification-rules",
33773
34156
  capScope: "system",
@@ -34278,6 +34661,12 @@ Object.freeze({
34278
34661
  addonId: null,
34279
34662
  access: "create"
34280
34663
  },
34664
+ "pipelineAnalytics.readLongTermSeries": {
34665
+ capName: "pipeline-analytics",
34666
+ capScope: "device",
34667
+ addonId: null,
34668
+ access: "view"
34669
+ },
34281
34670
  "pipelineAnalytics.rebuildObjectEmbeddings": {
34282
34671
  capName: "pipeline-analytics",
34283
34672
  capScope: "device",
@@ -34950,6 +35339,12 @@ Object.freeze({
34950
35339
  addonId: null,
34951
35340
  access: "create"
34952
35341
  },
35342
+ "pipelineRunner.requestOccupancyBurst": {
35343
+ capName: "pipeline-runner",
35344
+ capScope: "system",
35345
+ addonId: null,
35346
+ access: "create"
35347
+ },
34953
35348
  "pipelineRunner.runDetailSubtree": {
34954
35349
  capName: "pipeline-runner",
34955
35350
  capScope: "system",
@@ -36162,6 +36557,12 @@ Object.freeze({
36162
36557
  addonId: null,
36163
36558
  access: "create"
36164
36559
  },
36560
+ "streamBroker.reportStreamSignal": {
36561
+ capName: "stream-broker",
36562
+ capScope: "system",
36563
+ addonId: null,
36564
+ access: "create"
36565
+ },
36165
36566
  "streamBroker.restartProfile": {
36166
36567
  capName: "stream-broker",
36167
36568
  capScope: "system",
@@ -36246,6 +36647,12 @@ Object.freeze({
36246
36647
  addonId: null,
36247
36648
  access: "create"
36248
36649
  },
36650
+ "streamSignals.listSignals": {
36651
+ capName: "stream-signals",
36652
+ capScope: "device",
36653
+ addonId: null,
36654
+ access: "view"
36655
+ },
36249
36656
  "switch.setState": {
36250
36657
  capName: "switch",
36251
36658
  capScope: "device",
@@ -37718,11 +38125,21 @@ Object.freeze({
37718
38125
  form: "single",
37719
38126
  optional: false
37720
38127
  }],
38128
+ "nativeObjectDetection.getOptions": [{
38129
+ name: "deviceId",
38130
+ form: "single",
38131
+ optional: false
38132
+ }],
37721
38133
  "nativeObjectDetection.setEnabled": [{
37722
38134
  name: "deviceId",
37723
38135
  form: "single",
37724
38136
  optional: false
37725
38137
  }],
38138
+ "nativeObjectDetection.setSettings": [{
38139
+ name: "deviceId",
38140
+ form: "single",
38141
+ optional: false
38142
+ }],
37726
38143
  "navigation.getFeatures": [{
37727
38144
  name: "deviceId",
37728
38145
  form: "single",
@@ -38072,6 +38489,11 @@ Object.freeze({
38072
38489
  form: "single",
38073
38490
  optional: false
38074
38491
  }],
38492
+ "pipelineAnalytics.readLongTermSeries": [{
38493
+ name: "deviceId",
38494
+ form: "single",
38495
+ optional: false
38496
+ }],
38075
38497
  "pipelineAnalytics.rebuildObjectEmbeddings": [{
38076
38498
  name: "deviceId",
38077
38499
  form: "single",
@@ -38262,6 +38684,11 @@ Object.freeze({
38262
38684
  form: "single",
38263
38685
  optional: false
38264
38686
  }],
38687
+ "pipelineRunner.requestOccupancyBurst": [{
38688
+ name: "deviceId",
38689
+ form: "single",
38690
+ optional: false
38691
+ }],
38265
38692
  "pipelineRunner.runDetailSubtree": [{
38266
38693
  name: "deviceId",
38267
38694
  form: "single",
@@ -38618,6 +39045,11 @@ Object.freeze({
38618
39045
  form: "single",
38619
39046
  optional: false
38620
39047
  }],
39048
+ "streamBroker.reportStreamSignal": [{
39049
+ name: "deviceId",
39050
+ form: "single",
39051
+ optional: false
39052
+ }],
38621
39053
  "streamBroker.restartProfile": [{
38622
39054
  name: "deviceId",
38623
39055
  form: "single",