@camstack/addon-provider-dreame 0.2.101 → 0.2.103
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.
- package/dist/addon.js +349 -16
- package/dist/addon.mjs +349 -16
- package/package.json +1 -1
package/dist/addon.js
CHANGED
|
@@ -52672,7 +52672,7 @@ var DreameCameraStream = class extends TypedEmitter {
|
|
|
52672
52672
|
}
|
|
52673
52673
|
};
|
|
52674
52674
|
//#endregion
|
|
52675
|
-
//#region ../types/dist/event-category-
|
|
52675
|
+
//#region ../types/dist/event-category-BVDXG4tB.mjs
|
|
52676
52676
|
var EventCategory = /* @__PURE__ */ function(EventCategory) {
|
|
52677
52677
|
EventCategory["SystemBoot"] = "system.boot";
|
|
52678
52678
|
EventCategory["SystemAddonsReady"] = "system.addons-ready";
|
|
@@ -53289,6 +53289,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
|
|
|
53289
53289
|
* pull-reconcile from the provider's `getStatus` on reconnect. */
|
|
53290
53290
|
EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
|
|
53291
53291
|
EventCategory["BackupCompleted"] = "backup.completed";
|
|
53292
|
+
/**
|
|
53293
|
+
* A whole backup RUN finished — every destination attempted, win or lose.
|
|
53294
|
+
*
|
|
53295
|
+
* `backup.completed` fires once per DESTINATION, which is the right grain for
|
|
53296
|
+
* a progress UI and the wrong one for a notification: an operator with three
|
|
53297
|
+
* destinations would be told three times. And a run where two of three
|
|
53298
|
+
* destinations succeeded is not a clean success — a single "backup
|
|
53299
|
+
* completed" that hid the failed one would be a lie, so the count of each is
|
|
53300
|
+
* carried here and the message says both.
|
|
53301
|
+
*
|
|
53302
|
+
* Emitted by the backup orchestrator only after the destination loop, so a
|
|
53303
|
+
* run that dies during the BUILD phase produces no completion at all.
|
|
53304
|
+
*/
|
|
53305
|
+
EventCategory["BackupRunCompleted"] = "backup.run-completed";
|
|
53292
53306
|
EventCategory["BackupRestored"] = "backup.restored";
|
|
53293
53307
|
EventCategory["NotificationDispatched"] = "notification.dispatched";
|
|
53294
53308
|
EventCategory["NotificationFailed"] = "notification.failed";
|
|
@@ -58019,7 +58033,7 @@ var ZodIssueCode = {
|
|
|
58019
58033
|
var ZodFirstPartyTypeKind;
|
|
58020
58034
|
ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
|
|
58021
58035
|
//#endregion
|
|
58022
|
-
//#region ../types/dist/sleep-
|
|
58036
|
+
//#region ../types/dist/sleep-DEuj7E3j.mjs
|
|
58023
58037
|
/**
|
|
58024
58038
|
* The audio chunk plane's byte format, and the ONE expansion from a coded
|
|
58025
58039
|
* window to float samples (D455).
|
|
@@ -60048,7 +60062,23 @@ var EncodeProfileSchema = object({
|
|
|
60048
60062
|
"zerolatency",
|
|
60049
60063
|
"film",
|
|
60050
60064
|
"animation"
|
|
60051
|
-
]).optional()
|
|
60065
|
+
]).optional(),
|
|
60066
|
+
/**
|
|
60067
|
+
* ONE slice per access unit.
|
|
60068
|
+
*
|
|
60069
|
+
* `-tune zerolatency` turns on x264's sliced threads, and a frame then leaves
|
|
60070
|
+
* the encoder as five NAL slices that share one RTP timestamp and carry one
|
|
60071
|
+
* marker bit. A libwebrtc depacketiser sees five frame-starts and one
|
|
60072
|
+
* frame-end per frame: the first pictures render and the video then freezes
|
|
60073
|
+
* for good while the audio, on its own plane, plays on. Measured on this hub
|
|
60074
|
+
* 2026-09-13 against the Echo, and reduced to one slice by this flag alone.
|
|
60075
|
+
*
|
|
60076
|
+
* A NAMED field and not a raw flag, because {@link EgressEncodeSchema} omits
|
|
60077
|
+
* `outputArgs` on purpose: an opaque array is part of the sharing key, so two
|
|
60078
|
+
* consumers meaning the same thing spelled differently would stop sharing one
|
|
60079
|
+
* child. Absent means "whatever the encoder does" — today's behaviour.
|
|
60080
|
+
*/
|
|
60081
|
+
singleSlicePerFrame: boolean().optional()
|
|
60052
60082
|
}),
|
|
60053
60083
|
audio: union([literal("passthrough"), object({
|
|
60054
60084
|
codec: _enum([
|
|
@@ -60098,7 +60128,7 @@ var BASE_LIVE_EGRESS_PROFILE = {
|
|
|
60098
60128
|
audio: "passthrough"
|
|
60099
60129
|
};
|
|
60100
60130
|
({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
|
|
60101
|
-
({ ...BASE_LIVE_EGRESS_PROFILE });
|
|
60131
|
+
({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
|
|
60102
60132
|
/**
|
|
60103
60133
|
* Deep wiring healthcheck — snapshot of active reachability probes across
|
|
60104
60134
|
* every declared capability + widget of every installed plugin, on every
|
|
@@ -64147,6 +64177,72 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
|
|
|
64147
64177
|
auth: "admin"
|
|
64148
64178
|
}), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
|
|
64149
64179
|
DeviceType.Camera;
|
|
64180
|
+
/**
|
|
64181
|
+
* The signals a device can emit to WAKE its own stream.
|
|
64182
|
+
*
|
|
64183
|
+
* A camera whose stream is built on demand sleeps until something asks for it,
|
|
64184
|
+
* and "something" cannot be a consumer that is merely attached — a Frigate-style
|
|
64185
|
+
* puller holds a session open for ever, and treating that as demand would keep
|
|
64186
|
+
* a battery camera awake for ever, which is the whole thing the battery is for
|
|
64187
|
+
* (D173). So the wake has to come from the CAMERA: an event it noticed by
|
|
64188
|
+
* itself, with no stream running.
|
|
64189
|
+
*
|
|
64190
|
+
* ## The vocabulary is the PROVIDER'S, not ours
|
|
64191
|
+
*
|
|
64192
|
+
* Like `consumables`, this cap declares no vocabulary of its own. A provider
|
|
64193
|
+
* names each signal with a `code` it chooses and a `label` an operator reads.
|
|
64194
|
+
* Reolink offers motion and camera-native detection; another provider may offer
|
|
64195
|
+
* a tamper, a doorbell press, a PIR, or something no camera in this fleet has
|
|
64196
|
+
* yet. A fixed enum here would mean every new signal is a framework release.
|
|
64197
|
+
*
|
|
64198
|
+
* It is deliberately NOT derived from the caps a device already binds. Whether
|
|
64199
|
+
* a camera CAN push firmware motion is expressed by `motionSources` containing
|
|
64200
|
+
* `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
|
|
64201
|
+
* binding — but both answer "what drives the detection pipeline", which is a
|
|
64202
|
+
* different question from "what may wake a sleeping stream". A camera can do
|
|
64203
|
+
* the first and not be trusted with the second, and the operator picks per
|
|
64204
|
+
* camera. Two questions, two authorities.
|
|
64205
|
+
*
|
|
64206
|
+
* ## Availability is not permission
|
|
64207
|
+
*
|
|
64208
|
+
* `listSignals` says what the device CAN emit. Whether a given signal actually
|
|
64209
|
+
* wakes the stream is the operator's per-camera choice, held by the broker
|
|
64210
|
+
* alongside the cooldown — see the stream-broker cap's wake settings. A
|
|
64211
|
+
* provider declaring a signal is not a provider enabling it.
|
|
64212
|
+
*/
|
|
64213
|
+
/** One signal a device can emit. */
|
|
64214
|
+
var StreamSignalSchema = object({
|
|
64215
|
+
/** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
|
|
64216
|
+
code: string().min(1),
|
|
64217
|
+
/** What an operator reads in the picker. The provider's own wording. */
|
|
64218
|
+
label: string().min(1),
|
|
64219
|
+
/**
|
|
64220
|
+
* Whether the provider recommends this signal ON when a camera is first set
|
|
64221
|
+
* up. A provider knows which of its signals are cheap and reliable; an
|
|
64222
|
+
* operator should not have to discover that by trial. Reolink recommends
|
|
64223
|
+
* both of its own.
|
|
64224
|
+
*/
|
|
64225
|
+
recommended: boolean()
|
|
64226
|
+
});
|
|
64227
|
+
var StreamSignalsStatusSchema = object({
|
|
64228
|
+
signals: array(StreamSignalSchema),
|
|
64229
|
+
lastFetchedAt: number()
|
|
64230
|
+
});
|
|
64231
|
+
var streamSignalsCapability = {
|
|
64232
|
+
name: "stream-signals",
|
|
64233
|
+
scope: "device",
|
|
64234
|
+
deviceNative: true,
|
|
64235
|
+
mode: "singleton",
|
|
64236
|
+
deviceTypes: Object.values(DeviceType),
|
|
64237
|
+
runtimeState: StreamSignalsStatusSchema,
|
|
64238
|
+
methods: {
|
|
64239
|
+
/**
|
|
64240
|
+
* What this device can emit. Empty is a valid and common answer — most
|
|
64241
|
+
* cameras have nothing to offer here, and an empty list is what makes the
|
|
64242
|
+
* broker's picker show nothing rather than a false choice.
|
|
64243
|
+
*/
|
|
64244
|
+
listSignals: method(_void(), array(StreamSignalSchema).readonly()) }
|
|
64245
|
+
};
|
|
64150
64246
|
/** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
|
|
64151
64247
|
var StreamFormatSchema = _enum([
|
|
64152
64248
|
"webrtc",
|
|
@@ -64543,6 +64639,22 @@ var EgressTranscodeSchema = object({
|
|
|
64543
64639
|
camStreamId: string().nullable()
|
|
64544
64640
|
});
|
|
64545
64641
|
method(object({
|
|
64642
|
+
deviceId: number().int().nonnegative(),
|
|
64643
|
+
/** The provider's signal code. */
|
|
64644
|
+
code: string().min(1),
|
|
64645
|
+
/** Ms epoch. Absent ⇒ now. */
|
|
64646
|
+
at: number().optional()
|
|
64647
|
+
}), object({
|
|
64648
|
+
/** Whether the broker acted on it, and if not, why. */
|
|
64649
|
+
accepted: boolean(),
|
|
64650
|
+
reason: _enum([
|
|
64651
|
+
"woke",
|
|
64652
|
+
"hold-extended",
|
|
64653
|
+
"not-enabled",
|
|
64654
|
+
"no-consumer",
|
|
64655
|
+
"unknown-code"
|
|
64656
|
+
])
|
|
64657
|
+
}), { kind: "mutation" }), method(object({
|
|
64546
64658
|
deviceId: number().int().nonnegative(),
|
|
64547
64659
|
camStreamId: string().min(1),
|
|
64548
64660
|
kind: CamStreamKindSchema,
|
|
@@ -64797,6 +64909,16 @@ var PickStreamRequirementsSchema = object({
|
|
|
64797
64909
|
acceptCodecs: array(StreamCodecSchema).readonly().optional(),
|
|
64798
64910
|
/** Minimum vertical resolution. Streams shorter than this are dropped. */
|
|
64799
64911
|
minHeight: number().int().positive().optional(),
|
|
64912
|
+
/**
|
|
64913
|
+
* Maximum vertical resolution. Streams TALLER than this are dropped.
|
|
64914
|
+
*
|
|
64915
|
+
* A consumer can have a ceiling as real as its floor: Alexa documents
|
|
64916
|
+
* 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
|
|
64917
|
+
* Without this the ceiling had to be re-implemented by every caller — and
|
|
64918
|
+
* one caller implementing it privately is how a second scoring authority
|
|
64919
|
+
* gets born.
|
|
64920
|
+
*/
|
|
64921
|
+
maxHeight: number().int().positive().optional(),
|
|
64800
64922
|
/** Minimum horizontal resolution. */
|
|
64801
64923
|
minWidth: number().int().positive().optional(),
|
|
64802
64924
|
/**
|
|
@@ -64813,7 +64935,22 @@ var PickStreamRequirementsSchema = object({
|
|
|
64813
64935
|
* transcoded" guard: if the device is already serving the consumer's
|
|
64814
64936
|
* codec end-to-end, there's nothing to optimise.
|
|
64815
64937
|
*/
|
|
64816
|
-
requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
|
|
64938
|
+
requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
|
|
64939
|
+
/**
|
|
64940
|
+
* Whether a stream the consumer CANNOT decode may still be picked, on the
|
|
64941
|
+
* understanding that it will be transcoded.
|
|
64942
|
+
*
|
|
64943
|
+
* Default `false` — today's behaviour, and the right one for a bypass
|
|
64944
|
+
* question ("is there a stream I can forward untouched?"). Set `true` to
|
|
64945
|
+
* ask the larger question: "what is the best stream for me, transcoding if
|
|
64946
|
+
* I must?" A stream that satisfies `acceptCodecs` always outranks one that
|
|
64947
|
+
* does not, so a passthrough is never lost to a transcode; the answer says
|
|
64948
|
+
* which it is in {@link PickedCamStreamSchema.transcodes}.
|
|
64949
|
+
*
|
|
64950
|
+
* This is what lets one picker serve both the bypass and the full source
|
|
64951
|
+
* choice, instead of a consumer scoring privately when the bypass misses.
|
|
64952
|
+
*/
|
|
64953
|
+
allowTranscode: boolean().optional()
|
|
64817
64954
|
}).readonly();
|
|
64818
64955
|
var PickStreamPreferencesSchema = object({
|
|
64819
64956
|
/**
|
|
@@ -64827,12 +64964,32 @@ var PickStreamPreferencesSchema = object({
|
|
|
64827
64964
|
* picks the tallest stream; `'lowest'` picks the shortest (used by
|
|
64828
64965
|
* memory-constrained consumers / Apple Home guest sessions).
|
|
64829
64966
|
*/
|
|
64830
|
-
resolutionPreference: _enum(["highest", "lowest"]).optional()
|
|
64967
|
+
resolutionPreference: _enum(["highest", "lowest"]).optional(),
|
|
64968
|
+
/**
|
|
64969
|
+
* The height the consumer actually wants to DELIVER.
|
|
64970
|
+
*
|
|
64971
|
+
* Not a constraint — an ordering. With it set, the SMALLEST stream at or
|
|
64972
|
+
* above the target wins, and only if nothing reaches it does the tallest
|
|
64973
|
+
* take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
|
|
64974
|
+
* a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
|
|
64975
|
+
* express that: it says "as big as possible", which is a different wish.
|
|
64976
|
+
*
|
|
64977
|
+
* Ignored when absent, so every existing caller keeps its ordering.
|
|
64978
|
+
*/
|
|
64979
|
+
targetHeight: number().int().positive().optional()
|
|
64831
64980
|
}).readonly();
|
|
64832
64981
|
var PickedCamStreamSchema = object({
|
|
64833
64982
|
camStreamId: string(),
|
|
64834
64983
|
codec: string().optional(),
|
|
64835
64984
|
resolution: CamStreamResolutionSchema.optional(),
|
|
64985
|
+
/**
|
|
64986
|
+
* Whether serving this stream requires a decode + re-encode.
|
|
64987
|
+
*
|
|
64988
|
+
* `false` is a stream the consumer can take as it stands. Only ever `true`
|
|
64989
|
+
* when the caller asked for it with `allowTranscode`, so a caller that did
|
|
64990
|
+
* not ask cannot be handed a cost it never agreed to pay.
|
|
64991
|
+
*/
|
|
64992
|
+
transcodes: boolean(),
|
|
64836
64993
|
/** One-line explanation of why this stream won — for logs / debug UI. */
|
|
64837
64994
|
reason: string()
|
|
64838
64995
|
});
|
|
@@ -69366,6 +69523,8 @@ var NcSystemEventKindSchema = _enum([
|
|
|
69366
69523
|
"device-enabled",
|
|
69367
69524
|
"device-battery-low",
|
|
69368
69525
|
"device-battery-normal",
|
|
69526
|
+
"device-consumable-low",
|
|
69527
|
+
"device-consumable-normal",
|
|
69369
69528
|
"stream-online",
|
|
69370
69529
|
"stream-offline",
|
|
69371
69530
|
"node-online",
|
|
@@ -69384,6 +69543,7 @@ var NcSystemEventKindSchema = _enum([
|
|
|
69384
69543
|
"addon-updated",
|
|
69385
69544
|
"server-updated",
|
|
69386
69545
|
"export-completed",
|
|
69546
|
+
"backup-completed",
|
|
69387
69547
|
"camera-online",
|
|
69388
69548
|
"camera-offline",
|
|
69389
69549
|
"camera-disabled",
|
|
@@ -72820,13 +72980,109 @@ var SummariesQueryInput = object({
|
|
|
72820
72980
|
deviceIds: array(number()).min(1),
|
|
72821
72981
|
since: number().optional(),
|
|
72822
72982
|
until: number().optional(),
|
|
72823
|
-
limit: number().int().min(1).max(200).default(50)
|
|
72983
|
+
limit: number().int().min(1).max(200).default(50),
|
|
72984
|
+
/** The same member-wise filter {@link listRecentSummaries} takes — one
|
|
72985
|
+
* meaning of "dog" on every summary surface. */
|
|
72986
|
+
classes: array(string().min(1).max(60)).max(40).optional()
|
|
72824
72987
|
});
|
|
72825
|
-
var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
|
|
72826
72988
|
var SummaryDetailSchema = object({
|
|
72827
72989
|
summary: SummarySchema,
|
|
72828
|
-
/**
|
|
72829
|
-
|
|
72990
|
+
/** Members in absorption order, oldest join first. */
|
|
72991
|
+
members: array(object({
|
|
72992
|
+
trackId: string(),
|
|
72993
|
+
/**
|
|
72994
|
+
* The track's class at the time it JOINED, or `null` when it was unresolved
|
|
72995
|
+
* and the track no longer exists to fill it.
|
|
72996
|
+
*
|
|
72997
|
+
* The join, not the latest opinion: class voting can re-decide a track's
|
|
72998
|
+
* class afterwards, and a group's composition is the history of who came
|
|
72999
|
+
* together. A consumer counts these to badge a thumbnail — "two people and a
|
|
73000
|
+
* dog" — rather than being handed a second, denormalised tally that would
|
|
73001
|
+
* drift from the members it claims to describe.
|
|
73002
|
+
*/
|
|
73003
|
+
className: string().nullable(),
|
|
73004
|
+
/** `primary` is the one member that carries the group's identity. */
|
|
73005
|
+
role: _enum([
|
|
73006
|
+
"primary",
|
|
73007
|
+
"sibling",
|
|
73008
|
+
"child"
|
|
73009
|
+
]).nullable(),
|
|
73010
|
+
joinedAt: number(),
|
|
73011
|
+
/** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
|
|
73012
|
+
* at read time. Absent when nothing resolved, never an empty string. */
|
|
73013
|
+
label: string().optional(),
|
|
73014
|
+
/** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
|
|
73015
|
+
* recognised nobody, and absent for a member whose track has been pruned —
|
|
73016
|
+
* a thumbnail that names the wrong person is worse than one naming nobody. */
|
|
73017
|
+
subLabel: string().optional()
|
|
73018
|
+
})).readonly()
|
|
73019
|
+
});
|
|
73020
|
+
/**
|
|
73021
|
+
* What a LIST of groups carries: the envelope plus what it is MADE OF.
|
|
73022
|
+
*
|
|
73023
|
+
* Coarse on purpose — the operator's rule is "only the rough data on the list,
|
|
73024
|
+
* we extend when we notice we need more". Enough to draw the card ("two people
|
|
73025
|
+
* and a dog") and no more. The MEMBERS, their names and the per-member links
|
|
73026
|
+
* are on {@link getSummary}: shipping every member of every group so a client
|
|
73027
|
+
* can count them turns a page of two hundred groups into a thousand records to
|
|
73028
|
+
* draw two hundred badges.
|
|
73029
|
+
*/
|
|
73030
|
+
var SummaryListItemSchema = object({
|
|
73031
|
+
summary: SummarySchema,
|
|
73032
|
+
/** Class counts, most numerous first; `className: null` is a member whose
|
|
73033
|
+
* class never resolved, counted so the counts add up to `memberCount`. */
|
|
73034
|
+
classes: array(object({
|
|
73035
|
+
className: string().nullable(),
|
|
73036
|
+
count: number().int().positive()
|
|
73037
|
+
})).readonly()
|
|
73038
|
+
});
|
|
73039
|
+
var SummariesPageSchema = object({ summaries: array(SummaryListItemSchema).readonly() });
|
|
73040
|
+
/**
|
|
73041
|
+
* The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
|
|
73042
|
+
*
|
|
73043
|
+
* The reel on the cameras page and the Events gallery both ride a cursor, so a
|
|
73044
|
+
* summaries feed that could only answer "the last N for these cameras"
|
|
73045
|
+
* (`listSummaries`) would make groups available in the timeline and nowhere
|
|
73046
|
+
* else. Two feeds with different ordering contracts would be two ideas of what
|
|
73047
|
+
* "newest" means, on one screen.
|
|
73048
|
+
*/
|
|
73049
|
+
var RecentSummariesQueryInput = object({
|
|
73050
|
+
/** Devices to merge. An empty array yields an empty page. */
|
|
73051
|
+
deviceIds: array(number()),
|
|
73052
|
+
/** Window lower bound on `lastActiveAt` (inclusive). */
|
|
73053
|
+
since: number().optional(),
|
|
73054
|
+
/** Window upper bound on `lastActiveAt` (inclusive). */
|
|
73055
|
+
until: number().optional(),
|
|
73056
|
+
limit: number().int().min(1).max(500).default(100),
|
|
73057
|
+
/** Opaque continuation cursor from a previous page's `nextCursor`. */
|
|
73058
|
+
cursor: string().optional(),
|
|
73059
|
+
/**
|
|
73060
|
+
* Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
|
|
73061
|
+
* deliberately the same name: the events filter tree emits one list of ticked
|
|
73062
|
+
* taxonomy nodes, and a summaries feed that called it something else would
|
|
73063
|
+
* make the operator's one filter component produce two shapes.
|
|
73064
|
+
*
|
|
73065
|
+
* A question about the MEMBERS: a group matches when ANY of them does. "Show
|
|
73066
|
+
* me the arrivals with a dog" has to return the group of four people who had
|
|
73067
|
+
* one with them; a filter on the group's own fields could only ever answer
|
|
73068
|
+
* about its primary.
|
|
73069
|
+
*
|
|
73070
|
+
* Matched against all THREE tiers of a member — the class (`animal`), the
|
|
73071
|
+
* sub-class (`dog`) and the instance (a name, a plate) — because which tier a
|
|
73072
|
+
* ticked node lives on is the taxonomy's business, not the caller's. `dog` is
|
|
73073
|
+
* an event kind in the tree and a tier-1 label on an `animal` track; a filter
|
|
73074
|
+
* that read only the class would answer "animal" and never "dog".
|
|
73075
|
+
*
|
|
73076
|
+
* ABSENT or EMPTY means no filter — absent is not a selection of none.
|
|
73077
|
+
*/
|
|
73078
|
+
classes: array(string().min(1).max(60)).max(40).optional()
|
|
73079
|
+
});
|
|
73080
|
+
var RecentSummariesPageSchema = object({
|
|
73081
|
+
/** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
|
|
73082
|
+
* {@link listSummaries} — one list shape, so a card renders the same
|
|
73083
|
+
* whichever feed drew it. */
|
|
73084
|
+
summaries: array(SummaryListItemSchema).readonly(),
|
|
73085
|
+
nextCursor: string().nullable()
|
|
72830
73086
|
});
|
|
72831
73087
|
var RecentTracksPageSchema = object({
|
|
72832
73088
|
/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
|
|
@@ -73240,7 +73496,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
|
|
|
73240
73496
|
classes: array(string()).optional(),
|
|
73241
73497
|
/** See {@link ExcludeSourcesDoc}. */
|
|
73242
73498
|
excludeSources: array(TrackSourceSchema).optional()
|
|
73243
|
-
}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
|
|
73499
|
+
}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(RecentSummariesQueryInput, RecentSummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
|
|
73244
73500
|
kind: "mutation",
|
|
73245
73501
|
auth: "admin"
|
|
73246
73502
|
}), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
|
|
@@ -76569,10 +76825,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
|
|
|
76569
76825
|
}), boolean()), method(object({
|
|
76570
76826
|
deviceId: number().int().nonnegative(),
|
|
76571
76827
|
sessionId: string()
|
|
76572
|
-
}), object({
|
|
76573
|
-
|
|
76574
|
-
|
|
76575
|
-
|
|
76828
|
+
}), object({
|
|
76829
|
+
pendingRenegotiation: object({
|
|
76830
|
+
target: WebrtcStreamTargetSchema,
|
|
76831
|
+
epoch: number()
|
|
76832
|
+
}).nullable(),
|
|
76833
|
+
/**
|
|
76834
|
+
* Whether the session still EXISTS.
|
|
76835
|
+
*
|
|
76836
|
+
* A consumer that holds a resource for the life of a session needs to
|
|
76837
|
+
* be able to ask, because a session does not always end the way it
|
|
76838
|
+
* began. Measured on this hub 2026-09-13: an Echo that got stuck never
|
|
76839
|
+
* sent `SessionDisconnected`, so the Alexa exporter's
|
|
76840
|
+
* `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
|
|
76841
|
+
* H.264 transcode kept running for NOBODY for more than twenty
|
|
76842
|
+
* minutes. The WebRTC session had logged `WebRTC session closed`
|
|
76843
|
+
* minutes earlier — the broker knew; the holder had no way to ask.
|
|
76844
|
+
*
|
|
76845
|
+
* `false` for a session id the provider has never heard of, which is
|
|
76846
|
+
* the same answer as "it ended": either way nothing is holding it up.
|
|
76847
|
+
*/
|
|
76848
|
+
alive: boolean()
|
|
76849
|
+
}));
|
|
76576
76850
|
object({
|
|
76577
76851
|
/** All accessory children of the parent. */
|
|
76578
76852
|
childDeviceIds: array(number()).readonly(),
|
|
@@ -85166,7 +85440,29 @@ var LoggingSettingsPatchSchema = object({
|
|
|
85166
85440
|
* disarmed the channels it did not mention would make the Levels page and
|
|
85167
85441
|
* the Diagnostics page fight over the same value.
|
|
85168
85442
|
*/
|
|
85169
|
-
channels: array(LogChannelWindowPatchSchema).readonly().optional()
|
|
85443
|
+
channels: array(LogChannelWindowPatchSchema).readonly().optional(),
|
|
85444
|
+
/**
|
|
85445
|
+
* How many days the analytics OPS LOG is kept — the audit trail of what
|
|
85446
|
+
* retention actually deleted.
|
|
85447
|
+
*
|
|
85448
|
+
* It lives HERE, on the logging document, and not on the analytics addon's
|
|
85449
|
+
* settings form, on the operator's instruction: every other log-ish window in
|
|
85450
|
+
* this system is configured through this one document, and a retention audit
|
|
85451
|
+
* configured somewhere else is a second place to look when the question is
|
|
85452
|
+
* "what happened to my data".
|
|
85453
|
+
*
|
|
85454
|
+
* That placement has a cost worth stating: this document ships in the
|
|
85455
|
+
* framework closure, so this knob needs a published `@camstack/server` while
|
|
85456
|
+
* the four windows beside it (D485) reach a node on `camstack deploy`.
|
|
85457
|
+
*
|
|
85458
|
+
* `retention-model.ts` argued this one must NOT follow a device window,
|
|
85459
|
+
* because the audit trail is the history of the SWEEP and not of the camera.
|
|
85460
|
+
* That argument stands and is untouched — what changes is that 30 days stops
|
|
85461
|
+
* being a constant nobody can reach. `0` keeps it forever. The floor is 1 day
|
|
85462
|
+
* rather than 0-as-delete: an audit log truncated to nothing is precisely the
|
|
85463
|
+
* state in which the next 9.5 GiB leak cannot be explained.
|
|
85464
|
+
*/
|
|
85465
|
+
opsLogRetentionDays: number().int().min(0).max(3650).optional()
|
|
85170
85466
|
});
|
|
85171
85467
|
/**
|
|
85172
85468
|
* Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
|
|
@@ -85239,6 +85535,14 @@ var LoggingSettingsStateSchema = object({
|
|
|
85239
85535
|
channels: array(LogChannelDescriptorSchema).readonly(),
|
|
85240
85536
|
/** The channels ARMED right now, each with its deadline. */
|
|
85241
85537
|
activeChannels: array(LogChannelWindowStateSchema).readonly(),
|
|
85538
|
+
/**
|
|
85539
|
+
* The ops-log window in days, as it is in force. `0` = kept forever.
|
|
85540
|
+
*
|
|
85541
|
+
* Reported rather than left to the caller's memory of what it wrote: this is
|
|
85542
|
+
* the value the analytics sweep will actually use, and an operator asking how
|
|
85543
|
+
* long their audit trail lives should not have to infer it from a default.
|
|
85544
|
+
*/
|
|
85545
|
+
opsLogRetentionDays: number().int().min(0),
|
|
85242
85546
|
persisted: boolean()
|
|
85243
85547
|
});
|
|
85244
85548
|
method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), method(_void(), FeatureManifestSchema), method(_void(), array(NetworkAddressSchema).readonly()), method(_void(), unknown().nullable(), { auth: "admin" }), method(record(string(), unknown()), _null(), {
|
|
@@ -86634,6 +86938,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
|
|
|
86634
86938
|
smoke: smokeCapability,
|
|
86635
86939
|
streamCatalog: streamCatalogCapability,
|
|
86636
86940
|
streamParams: streamParamsCapability,
|
|
86941
|
+
streamSignals: streamSignalsCapability,
|
|
86637
86942
|
switch: switchCapability,
|
|
86638
86943
|
tamper: tamperCapability,
|
|
86639
86944
|
temperatureSensor: temperatureSensorCapability,
|
|
@@ -91239,6 +91544,12 @@ Object.freeze({
|
|
|
91239
91544
|
addonId: null,
|
|
91240
91545
|
access: "view"
|
|
91241
91546
|
},
|
|
91547
|
+
"pipelineAnalytics.listRecentSummaries": {
|
|
91548
|
+
capName: "pipeline-analytics",
|
|
91549
|
+
capScope: "device",
|
|
91550
|
+
addonId: null,
|
|
91551
|
+
access: "view"
|
|
91552
|
+
},
|
|
91242
91553
|
"pipelineAnalytics.listRecentTracks": {
|
|
91243
91554
|
capName: "pipeline-analytics",
|
|
91244
91555
|
capScope: "device",
|
|
@@ -93201,6 +93512,12 @@ Object.freeze({
|
|
|
93201
93512
|
addonId: null,
|
|
93202
93513
|
access: "create"
|
|
93203
93514
|
},
|
|
93515
|
+
"streamBroker.reportStreamSignal": {
|
|
93516
|
+
capName: "stream-broker",
|
|
93517
|
+
capScope: "system",
|
|
93518
|
+
addonId: null,
|
|
93519
|
+
access: "create"
|
|
93520
|
+
},
|
|
93204
93521
|
"streamBroker.restartProfile": {
|
|
93205
93522
|
capName: "stream-broker",
|
|
93206
93523
|
capScope: "system",
|
|
@@ -93285,6 +93602,12 @@ Object.freeze({
|
|
|
93285
93602
|
addonId: null,
|
|
93286
93603
|
access: "create"
|
|
93287
93604
|
},
|
|
93605
|
+
"streamSignals.listSignals": {
|
|
93606
|
+
capName: "stream-signals",
|
|
93607
|
+
capScope: "device",
|
|
93608
|
+
addonId: null,
|
|
93609
|
+
access: "view"
|
|
93610
|
+
},
|
|
93288
93611
|
"switch.setState": {
|
|
93289
93612
|
capName: "switch",
|
|
93290
93613
|
capScope: "device",
|
|
@@ -95066,6 +95389,11 @@ Object.freeze({
|
|
|
95066
95389
|
form: "single",
|
|
95067
95390
|
optional: true
|
|
95068
95391
|
}],
|
|
95392
|
+
"pipelineAnalytics.listRecentSummaries": [{
|
|
95393
|
+
name: "deviceIds",
|
|
95394
|
+
form: "array",
|
|
95395
|
+
optional: false
|
|
95396
|
+
}],
|
|
95069
95397
|
"pipelineAnalytics.listRecentTracks": [{
|
|
95070
95398
|
name: "deviceIds",
|
|
95071
95399
|
form: "array",
|
|
@@ -95652,6 +95980,11 @@ Object.freeze({
|
|
|
95652
95980
|
form: "single",
|
|
95653
95981
|
optional: false
|
|
95654
95982
|
}],
|
|
95983
|
+
"streamBroker.reportStreamSignal": [{
|
|
95984
|
+
name: "deviceId",
|
|
95985
|
+
form: "single",
|
|
95986
|
+
optional: false
|
|
95987
|
+
}],
|
|
95655
95988
|
"streamBroker.restartProfile": [{
|
|
95656
95989
|
name: "deviceId",
|
|
95657
95990
|
form: "single",
|
package/dist/addon.mjs
CHANGED
|
@@ -52669,7 +52669,7 @@ var DreameCameraStream = class extends TypedEmitter {
|
|
|
52669
52669
|
}
|
|
52670
52670
|
};
|
|
52671
52671
|
//#endregion
|
|
52672
|
-
//#region ../types/dist/event-category-
|
|
52672
|
+
//#region ../types/dist/event-category-BVDXG4tB.mjs
|
|
52673
52673
|
var EventCategory = /* @__PURE__ */ function(EventCategory) {
|
|
52674
52674
|
EventCategory["SystemBoot"] = "system.boot";
|
|
52675
52675
|
EventCategory["SystemAddonsReady"] = "system.addons-ready";
|
|
@@ -53286,6 +53286,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
|
|
|
53286
53286
|
* pull-reconcile from the provider's `getStatus` on reconnect. */
|
|
53287
53287
|
EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
|
|
53288
53288
|
EventCategory["BackupCompleted"] = "backup.completed";
|
|
53289
|
+
/**
|
|
53290
|
+
* A whole backup RUN finished — every destination attempted, win or lose.
|
|
53291
|
+
*
|
|
53292
|
+
* `backup.completed` fires once per DESTINATION, which is the right grain for
|
|
53293
|
+
* a progress UI and the wrong one for a notification: an operator with three
|
|
53294
|
+
* destinations would be told three times. And a run where two of three
|
|
53295
|
+
* destinations succeeded is not a clean success — a single "backup
|
|
53296
|
+
* completed" that hid the failed one would be a lie, so the count of each is
|
|
53297
|
+
* carried here and the message says both.
|
|
53298
|
+
*
|
|
53299
|
+
* Emitted by the backup orchestrator only after the destination loop, so a
|
|
53300
|
+
* run that dies during the BUILD phase produces no completion at all.
|
|
53301
|
+
*/
|
|
53302
|
+
EventCategory["BackupRunCompleted"] = "backup.run-completed";
|
|
53289
53303
|
EventCategory["BackupRestored"] = "backup.restored";
|
|
53290
53304
|
EventCategory["NotificationDispatched"] = "notification.dispatched";
|
|
53291
53305
|
EventCategory["NotificationFailed"] = "notification.failed";
|
|
@@ -58016,7 +58030,7 @@ var ZodIssueCode = {
|
|
|
58016
58030
|
var ZodFirstPartyTypeKind;
|
|
58017
58031
|
ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
|
|
58018
58032
|
//#endregion
|
|
58019
|
-
//#region ../types/dist/sleep-
|
|
58033
|
+
//#region ../types/dist/sleep-DEuj7E3j.mjs
|
|
58020
58034
|
/**
|
|
58021
58035
|
* The audio chunk plane's byte format, and the ONE expansion from a coded
|
|
58022
58036
|
* window to float samples (D455).
|
|
@@ -60045,7 +60059,23 @@ var EncodeProfileSchema = object({
|
|
|
60045
60059
|
"zerolatency",
|
|
60046
60060
|
"film",
|
|
60047
60061
|
"animation"
|
|
60048
|
-
]).optional()
|
|
60062
|
+
]).optional(),
|
|
60063
|
+
/**
|
|
60064
|
+
* ONE slice per access unit.
|
|
60065
|
+
*
|
|
60066
|
+
* `-tune zerolatency` turns on x264's sliced threads, and a frame then leaves
|
|
60067
|
+
* the encoder as five NAL slices that share one RTP timestamp and carry one
|
|
60068
|
+
* marker bit. A libwebrtc depacketiser sees five frame-starts and one
|
|
60069
|
+
* frame-end per frame: the first pictures render and the video then freezes
|
|
60070
|
+
* for good while the audio, on its own plane, plays on. Measured on this hub
|
|
60071
|
+
* 2026-09-13 against the Echo, and reduced to one slice by this flag alone.
|
|
60072
|
+
*
|
|
60073
|
+
* A NAMED field and not a raw flag, because {@link EgressEncodeSchema} omits
|
|
60074
|
+
* `outputArgs` on purpose: an opaque array is part of the sharing key, so two
|
|
60075
|
+
* consumers meaning the same thing spelled differently would stop sharing one
|
|
60076
|
+
* child. Absent means "whatever the encoder does" — today's behaviour.
|
|
60077
|
+
*/
|
|
60078
|
+
singleSlicePerFrame: boolean().optional()
|
|
60049
60079
|
}),
|
|
60050
60080
|
audio: union([literal("passthrough"), object({
|
|
60051
60081
|
codec: _enum([
|
|
@@ -60095,7 +60125,7 @@ var BASE_LIVE_EGRESS_PROFILE = {
|
|
|
60095
60125
|
audio: "passthrough"
|
|
60096
60126
|
};
|
|
60097
60127
|
({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
|
|
60098
|
-
({ ...BASE_LIVE_EGRESS_PROFILE });
|
|
60128
|
+
({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
|
|
60099
60129
|
/**
|
|
60100
60130
|
* Deep wiring healthcheck — snapshot of active reachability probes across
|
|
60101
60131
|
* every declared capability + widget of every installed plugin, on every
|
|
@@ -64144,6 +64174,72 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
|
|
|
64144
64174
|
auth: "admin"
|
|
64145
64175
|
}), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
|
|
64146
64176
|
DeviceType.Camera;
|
|
64177
|
+
/**
|
|
64178
|
+
* The signals a device can emit to WAKE its own stream.
|
|
64179
|
+
*
|
|
64180
|
+
* A camera whose stream is built on demand sleeps until something asks for it,
|
|
64181
|
+
* and "something" cannot be a consumer that is merely attached — a Frigate-style
|
|
64182
|
+
* puller holds a session open for ever, and treating that as demand would keep
|
|
64183
|
+
* a battery camera awake for ever, which is the whole thing the battery is for
|
|
64184
|
+
* (D173). So the wake has to come from the CAMERA: an event it noticed by
|
|
64185
|
+
* itself, with no stream running.
|
|
64186
|
+
*
|
|
64187
|
+
* ## The vocabulary is the PROVIDER'S, not ours
|
|
64188
|
+
*
|
|
64189
|
+
* Like `consumables`, this cap declares no vocabulary of its own. A provider
|
|
64190
|
+
* names each signal with a `code` it chooses and a `label` an operator reads.
|
|
64191
|
+
* Reolink offers motion and camera-native detection; another provider may offer
|
|
64192
|
+
* a tamper, a doorbell press, a PIR, or something no camera in this fleet has
|
|
64193
|
+
* yet. A fixed enum here would mean every new signal is a framework release.
|
|
64194
|
+
*
|
|
64195
|
+
* It is deliberately NOT derived from the caps a device already binds. Whether
|
|
64196
|
+
* a camera CAN push firmware motion is expressed by `motionSources` containing
|
|
64197
|
+
* `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
|
|
64198
|
+
* binding — but both answer "what drives the detection pipeline", which is a
|
|
64199
|
+
* different question from "what may wake a sleeping stream". A camera can do
|
|
64200
|
+
* the first and not be trusted with the second, and the operator picks per
|
|
64201
|
+
* camera. Two questions, two authorities.
|
|
64202
|
+
*
|
|
64203
|
+
* ## Availability is not permission
|
|
64204
|
+
*
|
|
64205
|
+
* `listSignals` says what the device CAN emit. Whether a given signal actually
|
|
64206
|
+
* wakes the stream is the operator's per-camera choice, held by the broker
|
|
64207
|
+
* alongside the cooldown — see the stream-broker cap's wake settings. A
|
|
64208
|
+
* provider declaring a signal is not a provider enabling it.
|
|
64209
|
+
*/
|
|
64210
|
+
/** One signal a device can emit. */
|
|
64211
|
+
var StreamSignalSchema = object({
|
|
64212
|
+
/** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
|
|
64213
|
+
code: string().min(1),
|
|
64214
|
+
/** What an operator reads in the picker. The provider's own wording. */
|
|
64215
|
+
label: string().min(1),
|
|
64216
|
+
/**
|
|
64217
|
+
* Whether the provider recommends this signal ON when a camera is first set
|
|
64218
|
+
* up. A provider knows which of its signals are cheap and reliable; an
|
|
64219
|
+
* operator should not have to discover that by trial. Reolink recommends
|
|
64220
|
+
* both of its own.
|
|
64221
|
+
*/
|
|
64222
|
+
recommended: boolean()
|
|
64223
|
+
});
|
|
64224
|
+
var StreamSignalsStatusSchema = object({
|
|
64225
|
+
signals: array(StreamSignalSchema),
|
|
64226
|
+
lastFetchedAt: number()
|
|
64227
|
+
});
|
|
64228
|
+
var streamSignalsCapability = {
|
|
64229
|
+
name: "stream-signals",
|
|
64230
|
+
scope: "device",
|
|
64231
|
+
deviceNative: true,
|
|
64232
|
+
mode: "singleton",
|
|
64233
|
+
deviceTypes: Object.values(DeviceType),
|
|
64234
|
+
runtimeState: StreamSignalsStatusSchema,
|
|
64235
|
+
methods: {
|
|
64236
|
+
/**
|
|
64237
|
+
* What this device can emit. Empty is a valid and common answer — most
|
|
64238
|
+
* cameras have nothing to offer here, and an empty list is what makes the
|
|
64239
|
+
* broker's picker show nothing rather than a false choice.
|
|
64240
|
+
*/
|
|
64241
|
+
listSignals: method(_void(), array(StreamSignalSchema).readonly()) }
|
|
64242
|
+
};
|
|
64147
64243
|
/** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
|
|
64148
64244
|
var StreamFormatSchema = _enum([
|
|
64149
64245
|
"webrtc",
|
|
@@ -64540,6 +64636,22 @@ var EgressTranscodeSchema = object({
|
|
|
64540
64636
|
camStreamId: string().nullable()
|
|
64541
64637
|
});
|
|
64542
64638
|
method(object({
|
|
64639
|
+
deviceId: number().int().nonnegative(),
|
|
64640
|
+
/** The provider's signal code. */
|
|
64641
|
+
code: string().min(1),
|
|
64642
|
+
/** Ms epoch. Absent ⇒ now. */
|
|
64643
|
+
at: number().optional()
|
|
64644
|
+
}), object({
|
|
64645
|
+
/** Whether the broker acted on it, and if not, why. */
|
|
64646
|
+
accepted: boolean(),
|
|
64647
|
+
reason: _enum([
|
|
64648
|
+
"woke",
|
|
64649
|
+
"hold-extended",
|
|
64650
|
+
"not-enabled",
|
|
64651
|
+
"no-consumer",
|
|
64652
|
+
"unknown-code"
|
|
64653
|
+
])
|
|
64654
|
+
}), { kind: "mutation" }), method(object({
|
|
64543
64655
|
deviceId: number().int().nonnegative(),
|
|
64544
64656
|
camStreamId: string().min(1),
|
|
64545
64657
|
kind: CamStreamKindSchema,
|
|
@@ -64794,6 +64906,16 @@ var PickStreamRequirementsSchema = object({
|
|
|
64794
64906
|
acceptCodecs: array(StreamCodecSchema).readonly().optional(),
|
|
64795
64907
|
/** Minimum vertical resolution. Streams shorter than this are dropped. */
|
|
64796
64908
|
minHeight: number().int().positive().optional(),
|
|
64909
|
+
/**
|
|
64910
|
+
* Maximum vertical resolution. Streams TALLER than this are dropped.
|
|
64911
|
+
*
|
|
64912
|
+
* A consumer can have a ceiling as real as its floor: Alexa documents
|
|
64913
|
+
* 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
|
|
64914
|
+
* Without this the ceiling had to be re-implemented by every caller — and
|
|
64915
|
+
* one caller implementing it privately is how a second scoring authority
|
|
64916
|
+
* gets born.
|
|
64917
|
+
*/
|
|
64918
|
+
maxHeight: number().int().positive().optional(),
|
|
64797
64919
|
/** Minimum horizontal resolution. */
|
|
64798
64920
|
minWidth: number().int().positive().optional(),
|
|
64799
64921
|
/**
|
|
@@ -64810,7 +64932,22 @@ var PickStreamRequirementsSchema = object({
|
|
|
64810
64932
|
* transcoded" guard: if the device is already serving the consumer's
|
|
64811
64933
|
* codec end-to-end, there's nothing to optimise.
|
|
64812
64934
|
*/
|
|
64813
|
-
requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
|
|
64935
|
+
requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
|
|
64936
|
+
/**
|
|
64937
|
+
* Whether a stream the consumer CANNOT decode may still be picked, on the
|
|
64938
|
+
* understanding that it will be transcoded.
|
|
64939
|
+
*
|
|
64940
|
+
* Default `false` — today's behaviour, and the right one for a bypass
|
|
64941
|
+
* question ("is there a stream I can forward untouched?"). Set `true` to
|
|
64942
|
+
* ask the larger question: "what is the best stream for me, transcoding if
|
|
64943
|
+
* I must?" A stream that satisfies `acceptCodecs` always outranks one that
|
|
64944
|
+
* does not, so a passthrough is never lost to a transcode; the answer says
|
|
64945
|
+
* which it is in {@link PickedCamStreamSchema.transcodes}.
|
|
64946
|
+
*
|
|
64947
|
+
* This is what lets one picker serve both the bypass and the full source
|
|
64948
|
+
* choice, instead of a consumer scoring privately when the bypass misses.
|
|
64949
|
+
*/
|
|
64950
|
+
allowTranscode: boolean().optional()
|
|
64814
64951
|
}).readonly();
|
|
64815
64952
|
var PickStreamPreferencesSchema = object({
|
|
64816
64953
|
/**
|
|
@@ -64824,12 +64961,32 @@ var PickStreamPreferencesSchema = object({
|
|
|
64824
64961
|
* picks the tallest stream; `'lowest'` picks the shortest (used by
|
|
64825
64962
|
* memory-constrained consumers / Apple Home guest sessions).
|
|
64826
64963
|
*/
|
|
64827
|
-
resolutionPreference: _enum(["highest", "lowest"]).optional()
|
|
64964
|
+
resolutionPreference: _enum(["highest", "lowest"]).optional(),
|
|
64965
|
+
/**
|
|
64966
|
+
* The height the consumer actually wants to DELIVER.
|
|
64967
|
+
*
|
|
64968
|
+
* Not a constraint — an ordering. With it set, the SMALLEST stream at or
|
|
64969
|
+
* above the target wins, and only if nothing reaches it does the tallest
|
|
64970
|
+
* take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
|
|
64971
|
+
* a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
|
|
64972
|
+
* express that: it says "as big as possible", which is a different wish.
|
|
64973
|
+
*
|
|
64974
|
+
* Ignored when absent, so every existing caller keeps its ordering.
|
|
64975
|
+
*/
|
|
64976
|
+
targetHeight: number().int().positive().optional()
|
|
64828
64977
|
}).readonly();
|
|
64829
64978
|
var PickedCamStreamSchema = object({
|
|
64830
64979
|
camStreamId: string(),
|
|
64831
64980
|
codec: string().optional(),
|
|
64832
64981
|
resolution: CamStreamResolutionSchema.optional(),
|
|
64982
|
+
/**
|
|
64983
|
+
* Whether serving this stream requires a decode + re-encode.
|
|
64984
|
+
*
|
|
64985
|
+
* `false` is a stream the consumer can take as it stands. Only ever `true`
|
|
64986
|
+
* when the caller asked for it with `allowTranscode`, so a caller that did
|
|
64987
|
+
* not ask cannot be handed a cost it never agreed to pay.
|
|
64988
|
+
*/
|
|
64989
|
+
transcodes: boolean(),
|
|
64833
64990
|
/** One-line explanation of why this stream won — for logs / debug UI. */
|
|
64834
64991
|
reason: string()
|
|
64835
64992
|
});
|
|
@@ -69363,6 +69520,8 @@ var NcSystemEventKindSchema = _enum([
|
|
|
69363
69520
|
"device-enabled",
|
|
69364
69521
|
"device-battery-low",
|
|
69365
69522
|
"device-battery-normal",
|
|
69523
|
+
"device-consumable-low",
|
|
69524
|
+
"device-consumable-normal",
|
|
69366
69525
|
"stream-online",
|
|
69367
69526
|
"stream-offline",
|
|
69368
69527
|
"node-online",
|
|
@@ -69381,6 +69540,7 @@ var NcSystemEventKindSchema = _enum([
|
|
|
69381
69540
|
"addon-updated",
|
|
69382
69541
|
"server-updated",
|
|
69383
69542
|
"export-completed",
|
|
69543
|
+
"backup-completed",
|
|
69384
69544
|
"camera-online",
|
|
69385
69545
|
"camera-offline",
|
|
69386
69546
|
"camera-disabled",
|
|
@@ -72817,13 +72977,109 @@ var SummariesQueryInput = object({
|
|
|
72817
72977
|
deviceIds: array(number()).min(1),
|
|
72818
72978
|
since: number().optional(),
|
|
72819
72979
|
until: number().optional(),
|
|
72820
|
-
limit: number().int().min(1).max(200).default(50)
|
|
72980
|
+
limit: number().int().min(1).max(200).default(50),
|
|
72981
|
+
/** The same member-wise filter {@link listRecentSummaries} takes — one
|
|
72982
|
+
* meaning of "dog" on every summary surface. */
|
|
72983
|
+
classes: array(string().min(1).max(60)).max(40).optional()
|
|
72821
72984
|
});
|
|
72822
|
-
var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
|
|
72823
72985
|
var SummaryDetailSchema = object({
|
|
72824
72986
|
summary: SummarySchema,
|
|
72825
|
-
/**
|
|
72826
|
-
|
|
72987
|
+
/** Members in absorption order, oldest join first. */
|
|
72988
|
+
members: array(object({
|
|
72989
|
+
trackId: string(),
|
|
72990
|
+
/**
|
|
72991
|
+
* The track's class at the time it JOINED, or `null` when it was unresolved
|
|
72992
|
+
* and the track no longer exists to fill it.
|
|
72993
|
+
*
|
|
72994
|
+
* The join, not the latest opinion: class voting can re-decide a track's
|
|
72995
|
+
* class afterwards, and a group's composition is the history of who came
|
|
72996
|
+
* together. A consumer counts these to badge a thumbnail — "two people and a
|
|
72997
|
+
* dog" — rather than being handed a second, denormalised tally that would
|
|
72998
|
+
* drift from the members it claims to describe.
|
|
72999
|
+
*/
|
|
73000
|
+
className: string().nullable(),
|
|
73001
|
+
/** `primary` is the one member that carries the group's identity. */
|
|
73002
|
+
role: _enum([
|
|
73003
|
+
"primary",
|
|
73004
|
+
"sibling",
|
|
73005
|
+
"child"
|
|
73006
|
+
]).nullable(),
|
|
73007
|
+
joinedAt: number(),
|
|
73008
|
+
/** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
|
|
73009
|
+
* at read time. Absent when nothing resolved, never an empty string. */
|
|
73010
|
+
label: string().optional(),
|
|
73011
|
+
/** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
|
|
73012
|
+
* recognised nobody, and absent for a member whose track has been pruned —
|
|
73013
|
+
* a thumbnail that names the wrong person is worse than one naming nobody. */
|
|
73014
|
+
subLabel: string().optional()
|
|
73015
|
+
})).readonly()
|
|
73016
|
+
});
|
|
73017
|
+
/**
|
|
73018
|
+
* What a LIST of groups carries: the envelope plus what it is MADE OF.
|
|
73019
|
+
*
|
|
73020
|
+
* Coarse on purpose — the operator's rule is "only the rough data on the list,
|
|
73021
|
+
* we extend when we notice we need more". Enough to draw the card ("two people
|
|
73022
|
+
* and a dog") and no more. The MEMBERS, their names and the per-member links
|
|
73023
|
+
* are on {@link getSummary}: shipping every member of every group so a client
|
|
73024
|
+
* can count them turns a page of two hundred groups into a thousand records to
|
|
73025
|
+
* draw two hundred badges.
|
|
73026
|
+
*/
|
|
73027
|
+
var SummaryListItemSchema = object({
|
|
73028
|
+
summary: SummarySchema,
|
|
73029
|
+
/** Class counts, most numerous first; `className: null` is a member whose
|
|
73030
|
+
* class never resolved, counted so the counts add up to `memberCount`. */
|
|
73031
|
+
classes: array(object({
|
|
73032
|
+
className: string().nullable(),
|
|
73033
|
+
count: number().int().positive()
|
|
73034
|
+
})).readonly()
|
|
73035
|
+
});
|
|
73036
|
+
var SummariesPageSchema = object({ summaries: array(SummaryListItemSchema).readonly() });
|
|
73037
|
+
/**
|
|
73038
|
+
* The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
|
|
73039
|
+
*
|
|
73040
|
+
* The reel on the cameras page and the Events gallery both ride a cursor, so a
|
|
73041
|
+
* summaries feed that could only answer "the last N for these cameras"
|
|
73042
|
+
* (`listSummaries`) would make groups available in the timeline and nowhere
|
|
73043
|
+
* else. Two feeds with different ordering contracts would be two ideas of what
|
|
73044
|
+
* "newest" means, on one screen.
|
|
73045
|
+
*/
|
|
73046
|
+
var RecentSummariesQueryInput = object({
|
|
73047
|
+
/** Devices to merge. An empty array yields an empty page. */
|
|
73048
|
+
deviceIds: array(number()),
|
|
73049
|
+
/** Window lower bound on `lastActiveAt` (inclusive). */
|
|
73050
|
+
since: number().optional(),
|
|
73051
|
+
/** Window upper bound on `lastActiveAt` (inclusive). */
|
|
73052
|
+
until: number().optional(),
|
|
73053
|
+
limit: number().int().min(1).max(500).default(100),
|
|
73054
|
+
/** Opaque continuation cursor from a previous page's `nextCursor`. */
|
|
73055
|
+
cursor: string().optional(),
|
|
73056
|
+
/**
|
|
73057
|
+
* Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
|
|
73058
|
+
* deliberately the same name: the events filter tree emits one list of ticked
|
|
73059
|
+
* taxonomy nodes, and a summaries feed that called it something else would
|
|
73060
|
+
* make the operator's one filter component produce two shapes.
|
|
73061
|
+
*
|
|
73062
|
+
* A question about the MEMBERS: a group matches when ANY of them does. "Show
|
|
73063
|
+
* me the arrivals with a dog" has to return the group of four people who had
|
|
73064
|
+
* one with them; a filter on the group's own fields could only ever answer
|
|
73065
|
+
* about its primary.
|
|
73066
|
+
*
|
|
73067
|
+
* Matched against all THREE tiers of a member — the class (`animal`), the
|
|
73068
|
+
* sub-class (`dog`) and the instance (a name, a plate) — because which tier a
|
|
73069
|
+
* ticked node lives on is the taxonomy's business, not the caller's. `dog` is
|
|
73070
|
+
* an event kind in the tree and a tier-1 label on an `animal` track; a filter
|
|
73071
|
+
* that read only the class would answer "animal" and never "dog".
|
|
73072
|
+
*
|
|
73073
|
+
* ABSENT or EMPTY means no filter — absent is not a selection of none.
|
|
73074
|
+
*/
|
|
73075
|
+
classes: array(string().min(1).max(60)).max(40).optional()
|
|
73076
|
+
});
|
|
73077
|
+
var RecentSummariesPageSchema = object({
|
|
73078
|
+
/** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
|
|
73079
|
+
* {@link listSummaries} — one list shape, so a card renders the same
|
|
73080
|
+
* whichever feed drew it. */
|
|
73081
|
+
summaries: array(SummaryListItemSchema).readonly(),
|
|
73082
|
+
nextCursor: string().nullable()
|
|
72827
73083
|
});
|
|
72828
73084
|
var RecentTracksPageSchema = object({
|
|
72829
73085
|
/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
|
|
@@ -73237,7 +73493,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
|
|
|
73237
73493
|
classes: array(string()).optional(),
|
|
73238
73494
|
/** See {@link ExcludeSourcesDoc}. */
|
|
73239
73495
|
excludeSources: array(TrackSourceSchema).optional()
|
|
73240
|
-
}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
|
|
73496
|
+
}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(RecentSummariesQueryInput, RecentSummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
|
|
73241
73497
|
kind: "mutation",
|
|
73242
73498
|
auth: "admin"
|
|
73243
73499
|
}), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
|
|
@@ -76566,10 +76822,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
|
|
|
76566
76822
|
}), boolean()), method(object({
|
|
76567
76823
|
deviceId: number().int().nonnegative(),
|
|
76568
76824
|
sessionId: string()
|
|
76569
|
-
}), object({
|
|
76570
|
-
|
|
76571
|
-
|
|
76572
|
-
|
|
76825
|
+
}), object({
|
|
76826
|
+
pendingRenegotiation: object({
|
|
76827
|
+
target: WebrtcStreamTargetSchema,
|
|
76828
|
+
epoch: number()
|
|
76829
|
+
}).nullable(),
|
|
76830
|
+
/**
|
|
76831
|
+
* Whether the session still EXISTS.
|
|
76832
|
+
*
|
|
76833
|
+
* A consumer that holds a resource for the life of a session needs to
|
|
76834
|
+
* be able to ask, because a session does not always end the way it
|
|
76835
|
+
* began. Measured on this hub 2026-09-13: an Echo that got stuck never
|
|
76836
|
+
* sent `SessionDisconnected`, so the Alexa exporter's
|
|
76837
|
+
* `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
|
|
76838
|
+
* H.264 transcode kept running for NOBODY for more than twenty
|
|
76839
|
+
* minutes. The WebRTC session had logged `WebRTC session closed`
|
|
76840
|
+
* minutes earlier — the broker knew; the holder had no way to ask.
|
|
76841
|
+
*
|
|
76842
|
+
* `false` for a session id the provider has never heard of, which is
|
|
76843
|
+
* the same answer as "it ended": either way nothing is holding it up.
|
|
76844
|
+
*/
|
|
76845
|
+
alive: boolean()
|
|
76846
|
+
}));
|
|
76573
76847
|
object({
|
|
76574
76848
|
/** All accessory children of the parent. */
|
|
76575
76849
|
childDeviceIds: array(number()).readonly(),
|
|
@@ -85163,7 +85437,29 @@ var LoggingSettingsPatchSchema = object({
|
|
|
85163
85437
|
* disarmed the channels it did not mention would make the Levels page and
|
|
85164
85438
|
* the Diagnostics page fight over the same value.
|
|
85165
85439
|
*/
|
|
85166
|
-
channels: array(LogChannelWindowPatchSchema).readonly().optional()
|
|
85440
|
+
channels: array(LogChannelWindowPatchSchema).readonly().optional(),
|
|
85441
|
+
/**
|
|
85442
|
+
* How many days the analytics OPS LOG is kept — the audit trail of what
|
|
85443
|
+
* retention actually deleted.
|
|
85444
|
+
*
|
|
85445
|
+
* It lives HERE, on the logging document, and not on the analytics addon's
|
|
85446
|
+
* settings form, on the operator's instruction: every other log-ish window in
|
|
85447
|
+
* this system is configured through this one document, and a retention audit
|
|
85448
|
+
* configured somewhere else is a second place to look when the question is
|
|
85449
|
+
* "what happened to my data".
|
|
85450
|
+
*
|
|
85451
|
+
* That placement has a cost worth stating: this document ships in the
|
|
85452
|
+
* framework closure, so this knob needs a published `@camstack/server` while
|
|
85453
|
+
* the four windows beside it (D485) reach a node on `camstack deploy`.
|
|
85454
|
+
*
|
|
85455
|
+
* `retention-model.ts` argued this one must NOT follow a device window,
|
|
85456
|
+
* because the audit trail is the history of the SWEEP and not of the camera.
|
|
85457
|
+
* That argument stands and is untouched — what changes is that 30 days stops
|
|
85458
|
+
* being a constant nobody can reach. `0` keeps it forever. The floor is 1 day
|
|
85459
|
+
* rather than 0-as-delete: an audit log truncated to nothing is precisely the
|
|
85460
|
+
* state in which the next 9.5 GiB leak cannot be explained.
|
|
85461
|
+
*/
|
|
85462
|
+
opsLogRetentionDays: number().int().min(0).max(3650).optional()
|
|
85167
85463
|
});
|
|
85168
85464
|
/**
|
|
85169
85465
|
* Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
|
|
@@ -85236,6 +85532,14 @@ var LoggingSettingsStateSchema = object({
|
|
|
85236
85532
|
channels: array(LogChannelDescriptorSchema).readonly(),
|
|
85237
85533
|
/** The channels ARMED right now, each with its deadline. */
|
|
85238
85534
|
activeChannels: array(LogChannelWindowStateSchema).readonly(),
|
|
85535
|
+
/**
|
|
85536
|
+
* The ops-log window in days, as it is in force. `0` = kept forever.
|
|
85537
|
+
*
|
|
85538
|
+
* Reported rather than left to the caller's memory of what it wrote: this is
|
|
85539
|
+
* the value the analytics sweep will actually use, and an operator asking how
|
|
85540
|
+
* long their audit trail lives should not have to infer it from a default.
|
|
85541
|
+
*/
|
|
85542
|
+
opsLogRetentionDays: number().int().min(0),
|
|
85239
85543
|
persisted: boolean()
|
|
85240
85544
|
});
|
|
85241
85545
|
method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), method(_void(), FeatureManifestSchema), method(_void(), array(NetworkAddressSchema).readonly()), method(_void(), unknown().nullable(), { auth: "admin" }), method(record(string(), unknown()), _null(), {
|
|
@@ -86631,6 +86935,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
|
|
|
86631
86935
|
smoke: smokeCapability,
|
|
86632
86936
|
streamCatalog: streamCatalogCapability,
|
|
86633
86937
|
streamParams: streamParamsCapability,
|
|
86938
|
+
streamSignals: streamSignalsCapability,
|
|
86634
86939
|
switch: switchCapability,
|
|
86635
86940
|
tamper: tamperCapability,
|
|
86636
86941
|
temperatureSensor: temperatureSensorCapability,
|
|
@@ -91236,6 +91541,12 @@ Object.freeze({
|
|
|
91236
91541
|
addonId: null,
|
|
91237
91542
|
access: "view"
|
|
91238
91543
|
},
|
|
91544
|
+
"pipelineAnalytics.listRecentSummaries": {
|
|
91545
|
+
capName: "pipeline-analytics",
|
|
91546
|
+
capScope: "device",
|
|
91547
|
+
addonId: null,
|
|
91548
|
+
access: "view"
|
|
91549
|
+
},
|
|
91239
91550
|
"pipelineAnalytics.listRecentTracks": {
|
|
91240
91551
|
capName: "pipeline-analytics",
|
|
91241
91552
|
capScope: "device",
|
|
@@ -93198,6 +93509,12 @@ Object.freeze({
|
|
|
93198
93509
|
addonId: null,
|
|
93199
93510
|
access: "create"
|
|
93200
93511
|
},
|
|
93512
|
+
"streamBroker.reportStreamSignal": {
|
|
93513
|
+
capName: "stream-broker",
|
|
93514
|
+
capScope: "system",
|
|
93515
|
+
addonId: null,
|
|
93516
|
+
access: "create"
|
|
93517
|
+
},
|
|
93201
93518
|
"streamBroker.restartProfile": {
|
|
93202
93519
|
capName: "stream-broker",
|
|
93203
93520
|
capScope: "system",
|
|
@@ -93282,6 +93599,12 @@ Object.freeze({
|
|
|
93282
93599
|
addonId: null,
|
|
93283
93600
|
access: "create"
|
|
93284
93601
|
},
|
|
93602
|
+
"streamSignals.listSignals": {
|
|
93603
|
+
capName: "stream-signals",
|
|
93604
|
+
capScope: "device",
|
|
93605
|
+
addonId: null,
|
|
93606
|
+
access: "view"
|
|
93607
|
+
},
|
|
93285
93608
|
"switch.setState": {
|
|
93286
93609
|
capName: "switch",
|
|
93287
93610
|
capScope: "device",
|
|
@@ -95063,6 +95386,11 @@ Object.freeze({
|
|
|
95063
95386
|
form: "single",
|
|
95064
95387
|
optional: true
|
|
95065
95388
|
}],
|
|
95389
|
+
"pipelineAnalytics.listRecentSummaries": [{
|
|
95390
|
+
name: "deviceIds",
|
|
95391
|
+
form: "array",
|
|
95392
|
+
optional: false
|
|
95393
|
+
}],
|
|
95066
95394
|
"pipelineAnalytics.listRecentTracks": [{
|
|
95067
95395
|
name: "deviceIds",
|
|
95068
95396
|
form: "array",
|
|
@@ -95649,6 +95977,11 @@ Object.freeze({
|
|
|
95649
95977
|
form: "single",
|
|
95650
95978
|
optional: false
|
|
95651
95979
|
}],
|
|
95980
|
+
"streamBroker.reportStreamSignal": [{
|
|
95981
|
+
name: "deviceId",
|
|
95982
|
+
form: "single",
|
|
95983
|
+
optional: false
|
|
95984
|
+
}],
|
|
95652
95985
|
"streamBroker.restartProfile": [{
|
|
95653
95986
|
name: "deviceId",
|
|
95654
95987
|
form: "single",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@camstack/addon-provider-dreame",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.103",
|
|
4
4
|
"description": "Dreame robot-vacuum / lawn-mower device-provider addon for CamStack — wraps the @apocaliss92/nodedreame Dreamehome cloud client",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"camstack",
|