@camstack/addon-remote-storage 1.2.99 → 1.2.101

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/s3.addon.js CHANGED
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-C99NWjGN.js");
5
+ const require_shared = require("./shared-SgmN8tGm.js");
6
6
  let node_stream = require("node:stream");
7
7
  let _aws_sdk_client_s3 = require("@aws-sdk/client-s3");
8
8
  let _aws_sdk_lib_storage = require("@aws-sdk/lib-storage");
package/dist/s3.addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { c as BaseAddon, i as rearmIdleAbort, n as getOptionalBasePath, o as scheduleIdleAbort, s as storageProviderCapability, t as createSessionId } from "./shared-wpNbUebc.mjs";
1
+ import { c as BaseAddon, i as rearmIdleAbort, n as getOptionalBasePath, o as scheduleIdleAbort, s as storageProviderCapability, t as createSessionId } from "./shared-C0LzFm0z.mjs";
2
2
  import { PassThrough } from "node:stream";
3
3
  import { DeleteObjectCommand, GetObjectCommand, HeadBucketCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
4
4
  import { Upload } from "@aws-sdk/lib-storage";
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-C99NWjGN.js");
5
+ const require_shared = require("./shared-SgmN8tGm.js");
6
6
  let ssh2 = require("ssh2");
7
7
  let node_path = require("node:path");
8
8
  node_path = require_shared.__toESM(node_path);
@@ -1,4 +1,4 @@
1
- import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-wpNbUebc.mjs";
1
+ import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-C0LzFm0z.mjs";
2
2
  import { Client } from "ssh2";
3
3
  import * as path from "node:path";
4
4
  //#region src/providers/sftp/sftp-config-schema.ts
@@ -1,6 +1,6 @@
1
1
  import { randomUUID } from "node:crypto";
2
2
  import * as path from "node:path";
3
- //#region ../types/dist/event-category-ZyX6jcse.mjs
3
+ //#region ../types/dist/event-category-BVDXG4tB.mjs
4
4
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
5
5
  EventCategory["SystemBoot"] = "system.boot";
6
6
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -617,6 +617,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
617
617
  * pull-reconcile from the provider's `getStatus` on reconnect. */
618
618
  EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
619
619
  EventCategory["BackupCompleted"] = "backup.completed";
620
+ /**
621
+ * A whole backup RUN finished — every destination attempted, win or lose.
622
+ *
623
+ * `backup.completed` fires once per DESTINATION, which is the right grain for
624
+ * a progress UI and the wrong one for a notification: an operator with three
625
+ * destinations would be told three times. And a run where two of three
626
+ * destinations succeeded is not a clean success — a single "backup
627
+ * completed" that hid the failed one would be a lie, so the count of each is
628
+ * carried here and the message says both.
629
+ *
630
+ * Emitted by the backup orchestrator only after the destination loop, so a
631
+ * run that dies during the BUILD phase produces no completion at all.
632
+ */
633
+ EventCategory["BackupRunCompleted"] = "backup.run-completed";
620
634
  EventCategory["BackupRestored"] = "backup.restored";
621
635
  EventCategory["NotificationDispatched"] = "notification.dispatched";
622
636
  EventCategory["NotificationFailed"] = "notification.failed";
@@ -5347,7 +5361,7 @@ var ZodIssueCode = {
5347
5361
  var ZodFirstPartyTypeKind;
5348
5362
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5349
5363
  //#endregion
5350
- //#region ../types/dist/sleep-CnLyvg3w.mjs
5364
+ //#region ../types/dist/sleep-DEuj7E3j.mjs
5351
5365
  /**
5352
5366
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5353
5367
  * window to float samples (D455).
@@ -7360,7 +7374,23 @@ var EncodeProfileSchema = object({
7360
7374
  "zerolatency",
7361
7375
  "film",
7362
7376
  "animation"
7363
- ]).optional()
7377
+ ]).optional(),
7378
+ /**
7379
+ * ONE slice per access unit.
7380
+ *
7381
+ * `-tune zerolatency` turns on x264's sliced threads, and a frame then leaves
7382
+ * the encoder as five NAL slices that share one RTP timestamp and carry one
7383
+ * marker bit. A libwebrtc depacketiser sees five frame-starts and one
7384
+ * frame-end per frame: the first pictures render and the video then freezes
7385
+ * for good while the audio, on its own plane, plays on. Measured on this hub
7386
+ * 2026-09-13 against the Echo, and reduced to one slice by this flag alone.
7387
+ *
7388
+ * A NAMED field and not a raw flag, because {@link EgressEncodeSchema} omits
7389
+ * `outputArgs` on purpose: an opaque array is part of the sharing key, so two
7390
+ * consumers meaning the same thing spelled differently would stop sharing one
7391
+ * child. Absent means "whatever the encoder does" — today's behaviour.
7392
+ */
7393
+ singleSlicePerFrame: boolean().optional()
7364
7394
  }),
7365
7395
  audio: union([literal("passthrough"), object({
7366
7396
  codec: _enum([
@@ -7410,7 +7440,7 @@ var BASE_LIVE_EGRESS_PROFILE = {
7410
7440
  audio: "passthrough"
7411
7441
  };
7412
7442
  ({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
7413
- ({ ...BASE_LIVE_EGRESS_PROFILE });
7443
+ ({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
7414
7444
  /**
7415
7445
  * Deep wiring healthcheck — snapshot of active reachability probes across
7416
7446
  * every declared capability + widget of every installed plugin, on every
@@ -11459,6 +11489,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11459
11489
  auth: "admin"
11460
11490
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11461
11491
  DeviceType.Camera;
11492
+ /**
11493
+ * The signals a device can emit to WAKE its own stream.
11494
+ *
11495
+ * A camera whose stream is built on demand sleeps until something asks for it,
11496
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
11497
+ * puller holds a session open for ever, and treating that as demand would keep
11498
+ * a battery camera awake for ever, which is the whole thing the battery is for
11499
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
11500
+ * itself, with no stream running.
11501
+ *
11502
+ * ## The vocabulary is the PROVIDER'S, not ours
11503
+ *
11504
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
11505
+ * names each signal with a `code` it chooses and a `label` an operator reads.
11506
+ * Reolink offers motion and camera-native detection; another provider may offer
11507
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
11508
+ * yet. A fixed enum here would mean every new signal is a framework release.
11509
+ *
11510
+ * It is deliberately NOT derived from the caps a device already binds. Whether
11511
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
11512
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
11513
+ * binding — but both answer "what drives the detection pipeline", which is a
11514
+ * different question from "what may wake a sleeping stream". A camera can do
11515
+ * the first and not be trusted with the second, and the operator picks per
11516
+ * camera. Two questions, two authorities.
11517
+ *
11518
+ * ## Availability is not permission
11519
+ *
11520
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
11521
+ * wakes the stream is the operator's per-camera choice, held by the broker
11522
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
11523
+ * provider declaring a signal is not a provider enabling it.
11524
+ */
11525
+ /** One signal a device can emit. */
11526
+ var StreamSignalSchema = object({
11527
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
11528
+ code: string().min(1),
11529
+ /** What an operator reads in the picker. The provider's own wording. */
11530
+ label: string().min(1),
11531
+ /**
11532
+ * Whether the provider recommends this signal ON when a camera is first set
11533
+ * up. A provider knows which of its signals are cheap and reliable; an
11534
+ * operator should not have to discover that by trial. Reolink recommends
11535
+ * both of its own.
11536
+ */
11537
+ recommended: boolean()
11538
+ });
11539
+ object({
11540
+ signals: array(StreamSignalSchema),
11541
+ lastFetchedAt: number()
11542
+ });
11543
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
11462
11544
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11463
11545
  var StreamFormatSchema = _enum([
11464
11546
  "webrtc",
@@ -11855,6 +11937,22 @@ var EgressTranscodeSchema = object({
11855
11937
  camStreamId: string().nullable()
11856
11938
  });
11857
11939
  method(object({
11940
+ deviceId: number().int().nonnegative(),
11941
+ /** The provider's signal code. */
11942
+ code: string().min(1),
11943
+ /** Ms epoch. Absent ⇒ now. */
11944
+ at: number().optional()
11945
+ }), object({
11946
+ /** Whether the broker acted on it, and if not, why. */
11947
+ accepted: boolean(),
11948
+ reason: _enum([
11949
+ "woke",
11950
+ "hold-extended",
11951
+ "not-enabled",
11952
+ "no-consumer",
11953
+ "unknown-code"
11954
+ ])
11955
+ }), { kind: "mutation" }), method(object({
11858
11956
  deviceId: number().int().nonnegative(),
11859
11957
  camStreamId: string().min(1),
11860
11958
  kind: CamStreamKindSchema,
@@ -12109,6 +12207,16 @@ var PickStreamRequirementsSchema = object({
12109
12207
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12110
12208
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12111
12209
  minHeight: number().int().positive().optional(),
12210
+ /**
12211
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12212
+ *
12213
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12214
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12215
+ * Without this the ceiling had to be re-implemented by every caller — and
12216
+ * one caller implementing it privately is how a second scoring authority
12217
+ * gets born.
12218
+ */
12219
+ maxHeight: number().int().positive().optional(),
12112
12220
  /** Minimum horizontal resolution. */
12113
12221
  minWidth: number().int().positive().optional(),
12114
12222
  /**
@@ -12125,7 +12233,22 @@ var PickStreamRequirementsSchema = object({
12125
12233
  * transcoded" guard: if the device is already serving the consumer's
12126
12234
  * codec end-to-end, there's nothing to optimise.
12127
12235
  */
12128
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12236
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12237
+ /**
12238
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12239
+ * understanding that it will be transcoded.
12240
+ *
12241
+ * Default `false` — today's behaviour, and the right one for a bypass
12242
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12243
+ * ask the larger question: "what is the best stream for me, transcoding if
12244
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12245
+ * does not, so a passthrough is never lost to a transcode; the answer says
12246
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12247
+ *
12248
+ * This is what lets one picker serve both the bypass and the full source
12249
+ * choice, instead of a consumer scoring privately when the bypass misses.
12250
+ */
12251
+ allowTranscode: boolean().optional()
12129
12252
  }).readonly();
12130
12253
  var PickStreamPreferencesSchema = object({
12131
12254
  /**
@@ -12139,12 +12262,32 @@ var PickStreamPreferencesSchema = object({
12139
12262
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12140
12263
  * memory-constrained consumers / Apple Home guest sessions).
12141
12264
  */
12142
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12265
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12266
+ /**
12267
+ * The height the consumer actually wants to DELIVER.
12268
+ *
12269
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12270
+ * above the target wins, and only if nothing reaches it does the tallest
12271
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12272
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12273
+ * express that: it says "as big as possible", which is a different wish.
12274
+ *
12275
+ * Ignored when absent, so every existing caller keeps its ordering.
12276
+ */
12277
+ targetHeight: number().int().positive().optional()
12143
12278
  }).readonly();
12144
12279
  var PickedCamStreamSchema = object({
12145
12280
  camStreamId: string(),
12146
12281
  codec: string().optional(),
12147
12282
  resolution: CamStreamResolutionSchema.optional(),
12283
+ /**
12284
+ * Whether serving this stream requires a decode + re-encode.
12285
+ *
12286
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12287
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12288
+ * not ask cannot be handed a cost it never agreed to pay.
12289
+ */
12290
+ transcodes: boolean(),
12148
12291
  /** One-line explanation of why this stream won — for logs / debug UI. */
12149
12292
  reason: string()
12150
12293
  });
@@ -16333,6 +16476,8 @@ var NcSystemEventKindSchema = _enum([
16333
16476
  "device-enabled",
16334
16477
  "device-battery-low",
16335
16478
  "device-battery-normal",
16479
+ "device-consumable-low",
16480
+ "device-consumable-normal",
16336
16481
  "stream-online",
16337
16482
  "stream-offline",
16338
16483
  "node-online",
@@ -16351,6 +16496,7 @@ var NcSystemEventKindSchema = _enum([
16351
16496
  "addon-updated",
16352
16497
  "server-updated",
16353
16498
  "export-completed",
16499
+ "backup-completed",
16354
16500
  "camera-online",
16355
16501
  "camera-offline",
16356
16502
  "camera-disabled",
@@ -19747,13 +19893,109 @@ var SummariesQueryInput = object({
19747
19893
  deviceIds: array(number()).min(1),
19748
19894
  since: number().optional(),
19749
19895
  until: number().optional(),
19750
- limit: number().int().min(1).max(200).default(50)
19896
+ limit: number().int().min(1).max(200).default(50),
19897
+ /** The same member-wise filter {@link listRecentSummaries} takes — one
19898
+ * meaning of "dog" on every summary surface. */
19899
+ classes: array(string().min(1).max(60)).max(40).optional()
19751
19900
  });
19752
- var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
19753
19901
  var SummaryDetailSchema = object({
19754
19902
  summary: SummarySchema,
19755
- /** Member track ids, in absorption order. */
19756
- trackIds: array(string()).readonly()
19903
+ /** Members in absorption order, oldest join first. */
19904
+ members: array(object({
19905
+ trackId: string(),
19906
+ /**
19907
+ * The track's class at the time it JOINED, or `null` when it was unresolved
19908
+ * and the track no longer exists to fill it.
19909
+ *
19910
+ * The join, not the latest opinion: class voting can re-decide a track's
19911
+ * class afterwards, and a group's composition is the history of who came
19912
+ * together. A consumer counts these to badge a thumbnail — "two people and a
19913
+ * dog" — rather than being handed a second, denormalised tally that would
19914
+ * drift from the members it claims to describe.
19915
+ */
19916
+ className: string().nullable(),
19917
+ /** `primary` is the one member that carries the group's identity. */
19918
+ role: _enum([
19919
+ "primary",
19920
+ "sibling",
19921
+ "child"
19922
+ ]).nullable(),
19923
+ joinedAt: number(),
19924
+ /** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
19925
+ * at read time. Absent when nothing resolved, never an empty string. */
19926
+ label: string().optional(),
19927
+ /** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
19928
+ * recognised nobody, and absent for a member whose track has been pruned —
19929
+ * a thumbnail that names the wrong person is worse than one naming nobody. */
19930
+ subLabel: string().optional()
19931
+ })).readonly()
19932
+ });
19933
+ /**
19934
+ * What a LIST of groups carries: the envelope plus what it is MADE OF.
19935
+ *
19936
+ * Coarse on purpose — the operator's rule is "only the rough data on the list,
19937
+ * we extend when we notice we need more". Enough to draw the card ("two people
19938
+ * and a dog") and no more. The MEMBERS, their names and the per-member links
19939
+ * are on {@link getSummary}: shipping every member of every group so a client
19940
+ * can count them turns a page of two hundred groups into a thousand records to
19941
+ * draw two hundred badges.
19942
+ */
19943
+ var SummaryListItemSchema = object({
19944
+ summary: SummarySchema,
19945
+ /** Class counts, most numerous first; `className: null` is a member whose
19946
+ * class never resolved, counted so the counts add up to `memberCount`. */
19947
+ classes: array(object({
19948
+ className: string().nullable(),
19949
+ count: number().int().positive()
19950
+ })).readonly()
19951
+ });
19952
+ var SummariesPageSchema = object({ summaries: array(SummaryListItemSchema).readonly() });
19953
+ /**
19954
+ * The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
19955
+ *
19956
+ * The reel on the cameras page and the Events gallery both ride a cursor, so a
19957
+ * summaries feed that could only answer "the last N for these cameras"
19958
+ * (`listSummaries`) would make groups available in the timeline and nowhere
19959
+ * else. Two feeds with different ordering contracts would be two ideas of what
19960
+ * "newest" means, on one screen.
19961
+ */
19962
+ var RecentSummariesQueryInput = object({
19963
+ /** Devices to merge. An empty array yields an empty page. */
19964
+ deviceIds: array(number()),
19965
+ /** Window lower bound on `lastActiveAt` (inclusive). */
19966
+ since: number().optional(),
19967
+ /** Window upper bound on `lastActiveAt` (inclusive). */
19968
+ until: number().optional(),
19969
+ limit: number().int().min(1).max(500).default(100),
19970
+ /** Opaque continuation cursor from a previous page's `nextCursor`. */
19971
+ cursor: string().optional(),
19972
+ /**
19973
+ * Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
19974
+ * deliberately the same name: the events filter tree emits one list of ticked
19975
+ * taxonomy nodes, and a summaries feed that called it something else would
19976
+ * make the operator's one filter component produce two shapes.
19977
+ *
19978
+ * A question about the MEMBERS: a group matches when ANY of them does. "Show
19979
+ * me the arrivals with a dog" has to return the group of four people who had
19980
+ * one with them; a filter on the group's own fields could only ever answer
19981
+ * about its primary.
19982
+ *
19983
+ * Matched against all THREE tiers of a member — the class (`animal`), the
19984
+ * sub-class (`dog`) and the instance (a name, a plate) — because which tier a
19985
+ * ticked node lives on is the taxonomy's business, not the caller's. `dog` is
19986
+ * an event kind in the tree and a tier-1 label on an `animal` track; a filter
19987
+ * that read only the class would answer "animal" and never "dog".
19988
+ *
19989
+ * ABSENT or EMPTY means no filter — absent is not a selection of none.
19990
+ */
19991
+ classes: array(string().min(1).max(60)).max(40).optional()
19992
+ });
19993
+ var RecentSummariesPageSchema = object({
19994
+ /** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
19995
+ * {@link listSummaries} — one list shape, so a card renders the same
19996
+ * whichever feed drew it. */
19997
+ summaries: array(SummaryListItemSchema).readonly(),
19998
+ nextCursor: string().nullable()
19757
19999
  });
19758
20000
  var RecentTracksPageSchema = object({
19759
20001
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -20167,7 +20409,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20167
20409
  classes: array(string()).optional(),
20168
20410
  /** See {@link ExcludeSourcesDoc}. */
20169
20411
  excludeSources: array(TrackSourceSchema).optional()
20170
- }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
20412
+ }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(RecentSummariesQueryInput, RecentSummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
20171
20413
  kind: "mutation",
20172
20414
  auth: "admin"
20173
20415
  }), 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({
@@ -23556,10 +23798,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23556
23798
  }), boolean()), method(object({
23557
23799
  deviceId: number().int().nonnegative(),
23558
23800
  sessionId: string()
23559
- }), object({ pendingRenegotiation: object({
23560
- target: WebrtcStreamTargetSchema,
23561
- epoch: number()
23562
- }).nullable() }));
23801
+ }), object({
23802
+ pendingRenegotiation: object({
23803
+ target: WebrtcStreamTargetSchema,
23804
+ epoch: number()
23805
+ }).nullable(),
23806
+ /**
23807
+ * Whether the session still EXISTS.
23808
+ *
23809
+ * A consumer that holds a resource for the life of a session needs to
23810
+ * be able to ask, because a session does not always end the way it
23811
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
23812
+ * sent `SessionDisconnected`, so the Alexa exporter's
23813
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
23814
+ * H.264 transcode kept running for NOBODY for more than twenty
23815
+ * minutes. The WebRTC session had logged `WebRTC session closed`
23816
+ * minutes earlier — the broker knew; the holder had no way to ask.
23817
+ *
23818
+ * `false` for a session id the provider has never heard of, which is
23819
+ * the same answer as "it ended": either way nothing is holding it up.
23820
+ */
23821
+ alive: boolean()
23822
+ }));
23563
23823
  object({
23564
23824
  /** All accessory children of the parent. */
23565
23825
  childDeviceIds: array(number()).readonly(),
@@ -29833,7 +30093,29 @@ var LoggingSettingsPatchSchema = object({
29833
30093
  * disarmed the channels it did not mention would make the Levels page and
29834
30094
  * the Diagnostics page fight over the same value.
29835
30095
  */
29836
- channels: array(LogChannelWindowPatchSchema).readonly().optional()
30096
+ channels: array(LogChannelWindowPatchSchema).readonly().optional(),
30097
+ /**
30098
+ * How many days the analytics OPS LOG is kept — the audit trail of what
30099
+ * retention actually deleted.
30100
+ *
30101
+ * It lives HERE, on the logging document, and not on the analytics addon's
30102
+ * settings form, on the operator's instruction: every other log-ish window in
30103
+ * this system is configured through this one document, and a retention audit
30104
+ * configured somewhere else is a second place to look when the question is
30105
+ * "what happened to my data".
30106
+ *
30107
+ * That placement has a cost worth stating: this document ships in the
30108
+ * framework closure, so this knob needs a published `@camstack/server` while
30109
+ * the four windows beside it (D485) reach a node on `camstack deploy`.
30110
+ *
30111
+ * `retention-model.ts` argued this one must NOT follow a device window,
30112
+ * because the audit trail is the history of the SWEEP and not of the camera.
30113
+ * That argument stands and is untouched — what changes is that 30 days stops
30114
+ * being a constant nobody can reach. `0` keeps it forever. The floor is 1 day
30115
+ * rather than 0-as-delete: an audit log truncated to nothing is precisely the
30116
+ * state in which the next 9.5 GiB leak cannot be explained.
30117
+ */
30118
+ opsLogRetentionDays: number().int().min(0).max(3650).optional()
29837
30119
  });
29838
30120
  /**
29839
30121
  * Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
@@ -29906,6 +30188,14 @@ var LoggingSettingsStateSchema = object({
29906
30188
  channels: array(LogChannelDescriptorSchema).readonly(),
29907
30189
  /** The channels ARMED right now, each with its deadline. */
29908
30190
  activeChannels: array(LogChannelWindowStateSchema).readonly(),
30191
+ /**
30192
+ * The ops-log window in days, as it is in force. `0` = kept forever.
30193
+ *
30194
+ * Reported rather than left to the caller's memory of what it wrote: this is
30195
+ * the value the analytics sweep will actually use, and an operator asking how
30196
+ * long their audit trail lives should not have to infer it from a default.
30197
+ */
30198
+ opsLogRetentionDays: number().int().min(0),
29909
30199
  persisted: boolean()
29910
30200
  });
29911
30201
  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(), {
@@ -34065,6 +34355,12 @@ Object.freeze({
34065
34355
  addonId: null,
34066
34356
  access: "view"
34067
34357
  },
34358
+ "pipelineAnalytics.listRecentSummaries": {
34359
+ capName: "pipeline-analytics",
34360
+ capScope: "device",
34361
+ addonId: null,
34362
+ access: "view"
34363
+ },
34068
34364
  "pipelineAnalytics.listRecentTracks": {
34069
34365
  capName: "pipeline-analytics",
34070
34366
  capScope: "device",
@@ -36027,6 +36323,12 @@ Object.freeze({
36027
36323
  addonId: null,
36028
36324
  access: "create"
36029
36325
  },
36326
+ "streamBroker.reportStreamSignal": {
36327
+ capName: "stream-broker",
36328
+ capScope: "system",
36329
+ addonId: null,
36330
+ access: "create"
36331
+ },
36030
36332
  "streamBroker.restartProfile": {
36031
36333
  capName: "stream-broker",
36032
36334
  capScope: "system",
@@ -36111,6 +36413,12 @@ Object.freeze({
36111
36413
  addonId: null,
36112
36414
  access: "create"
36113
36415
  },
36416
+ "streamSignals.listSignals": {
36417
+ capName: "stream-signals",
36418
+ capScope: "device",
36419
+ addonId: null,
36420
+ access: "view"
36421
+ },
36114
36422
  "switch.setState": {
36115
36423
  capName: "switch",
36116
36424
  capScope: "device",
@@ -37892,6 +38200,11 @@ Object.freeze({
37892
38200
  form: "single",
37893
38201
  optional: true
37894
38202
  }],
38203
+ "pipelineAnalytics.listRecentSummaries": [{
38204
+ name: "deviceIds",
38205
+ form: "array",
38206
+ optional: false
38207
+ }],
37895
38208
  "pipelineAnalytics.listRecentTracks": [{
37896
38209
  name: "deviceIds",
37897
38210
  form: "array",
@@ -38478,6 +38791,11 @@ Object.freeze({
38478
38791
  form: "single",
38479
38792
  optional: false
38480
38793
  }],
38794
+ "streamBroker.reportStreamSignal": [{
38795
+ name: "deviceId",
38796
+ form: "single",
38797
+ optional: false
38798
+ }],
38481
38799
  "streamBroker.restartProfile": [{
38482
38800
  name: "deviceId",
38483
38801
  form: "single",
@@ -23,7 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
23
23
  let node_crypto = require("node:crypto");
24
24
  let node_path = require("node:path");
25
25
  node_path = __toESM(node_path);
26
- //#region ../types/dist/event-category-ZyX6jcse.mjs
26
+ //#region ../types/dist/event-category-BVDXG4tB.mjs
27
27
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
28
28
  EventCategory["SystemBoot"] = "system.boot";
29
29
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -640,6 +640,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
640
640
  * pull-reconcile from the provider's `getStatus` on reconnect. */
641
641
  EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
642
642
  EventCategory["BackupCompleted"] = "backup.completed";
643
+ /**
644
+ * A whole backup RUN finished — every destination attempted, win or lose.
645
+ *
646
+ * `backup.completed` fires once per DESTINATION, which is the right grain for
647
+ * a progress UI and the wrong one for a notification: an operator with three
648
+ * destinations would be told three times. And a run where two of three
649
+ * destinations succeeded is not a clean success — a single "backup
650
+ * completed" that hid the failed one would be a lie, so the count of each is
651
+ * carried here and the message says both.
652
+ *
653
+ * Emitted by the backup orchestrator only after the destination loop, so a
654
+ * run that dies during the BUILD phase produces no completion at all.
655
+ */
656
+ EventCategory["BackupRunCompleted"] = "backup.run-completed";
643
657
  EventCategory["BackupRestored"] = "backup.restored";
644
658
  EventCategory["NotificationDispatched"] = "notification.dispatched";
645
659
  EventCategory["NotificationFailed"] = "notification.failed";
@@ -5370,7 +5384,7 @@ var ZodIssueCode = {
5370
5384
  var ZodFirstPartyTypeKind;
5371
5385
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5372
5386
  //#endregion
5373
- //#region ../types/dist/sleep-CnLyvg3w.mjs
5387
+ //#region ../types/dist/sleep-DEuj7E3j.mjs
5374
5388
  /**
5375
5389
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5376
5390
  * window to float samples (D455).
@@ -7383,7 +7397,23 @@ var EncodeProfileSchema = object({
7383
7397
  "zerolatency",
7384
7398
  "film",
7385
7399
  "animation"
7386
- ]).optional()
7400
+ ]).optional(),
7401
+ /**
7402
+ * ONE slice per access unit.
7403
+ *
7404
+ * `-tune zerolatency` turns on x264's sliced threads, and a frame then leaves
7405
+ * the encoder as five NAL slices that share one RTP timestamp and carry one
7406
+ * marker bit. A libwebrtc depacketiser sees five frame-starts and one
7407
+ * frame-end per frame: the first pictures render and the video then freezes
7408
+ * for good while the audio, on its own plane, plays on. Measured on this hub
7409
+ * 2026-09-13 against the Echo, and reduced to one slice by this flag alone.
7410
+ *
7411
+ * A NAMED field and not a raw flag, because {@link EgressEncodeSchema} omits
7412
+ * `outputArgs` on purpose: an opaque array is part of the sharing key, so two
7413
+ * consumers meaning the same thing spelled differently would stop sharing one
7414
+ * child. Absent means "whatever the encoder does" — today's behaviour.
7415
+ */
7416
+ singleSlicePerFrame: boolean().optional()
7387
7417
  }),
7388
7418
  audio: union([literal("passthrough"), object({
7389
7419
  codec: _enum([
@@ -7433,7 +7463,7 @@ var BASE_LIVE_EGRESS_PROFILE = {
7433
7463
  audio: "passthrough"
7434
7464
  };
7435
7465
  ({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
7436
- ({ ...BASE_LIVE_EGRESS_PROFILE });
7466
+ ({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
7437
7467
  /**
7438
7468
  * Deep wiring healthcheck — snapshot of active reachability probes across
7439
7469
  * every declared capability + widget of every installed plugin, on every
@@ -11482,6 +11512,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11482
11512
  auth: "admin"
11483
11513
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11484
11514
  DeviceType.Camera;
11515
+ /**
11516
+ * The signals a device can emit to WAKE its own stream.
11517
+ *
11518
+ * A camera whose stream is built on demand sleeps until something asks for it,
11519
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
11520
+ * puller holds a session open for ever, and treating that as demand would keep
11521
+ * a battery camera awake for ever, which is the whole thing the battery is for
11522
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
11523
+ * itself, with no stream running.
11524
+ *
11525
+ * ## The vocabulary is the PROVIDER'S, not ours
11526
+ *
11527
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
11528
+ * names each signal with a `code` it chooses and a `label` an operator reads.
11529
+ * Reolink offers motion and camera-native detection; another provider may offer
11530
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
11531
+ * yet. A fixed enum here would mean every new signal is a framework release.
11532
+ *
11533
+ * It is deliberately NOT derived from the caps a device already binds. Whether
11534
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
11535
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
11536
+ * binding — but both answer "what drives the detection pipeline", which is a
11537
+ * different question from "what may wake a sleeping stream". A camera can do
11538
+ * the first and not be trusted with the second, and the operator picks per
11539
+ * camera. Two questions, two authorities.
11540
+ *
11541
+ * ## Availability is not permission
11542
+ *
11543
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
11544
+ * wakes the stream is the operator's per-camera choice, held by the broker
11545
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
11546
+ * provider declaring a signal is not a provider enabling it.
11547
+ */
11548
+ /** One signal a device can emit. */
11549
+ var StreamSignalSchema = object({
11550
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
11551
+ code: string().min(1),
11552
+ /** What an operator reads in the picker. The provider's own wording. */
11553
+ label: string().min(1),
11554
+ /**
11555
+ * Whether the provider recommends this signal ON when a camera is first set
11556
+ * up. A provider knows which of its signals are cheap and reliable; an
11557
+ * operator should not have to discover that by trial. Reolink recommends
11558
+ * both of its own.
11559
+ */
11560
+ recommended: boolean()
11561
+ });
11562
+ object({
11563
+ signals: array(StreamSignalSchema),
11564
+ lastFetchedAt: number()
11565
+ });
11566
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
11485
11567
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11486
11568
  var StreamFormatSchema = _enum([
11487
11569
  "webrtc",
@@ -11878,6 +11960,22 @@ var EgressTranscodeSchema = object({
11878
11960
  camStreamId: string().nullable()
11879
11961
  });
11880
11962
  method(object({
11963
+ deviceId: number().int().nonnegative(),
11964
+ /** The provider's signal code. */
11965
+ code: string().min(1),
11966
+ /** Ms epoch. Absent ⇒ now. */
11967
+ at: number().optional()
11968
+ }), object({
11969
+ /** Whether the broker acted on it, and if not, why. */
11970
+ accepted: boolean(),
11971
+ reason: _enum([
11972
+ "woke",
11973
+ "hold-extended",
11974
+ "not-enabled",
11975
+ "no-consumer",
11976
+ "unknown-code"
11977
+ ])
11978
+ }), { kind: "mutation" }), method(object({
11881
11979
  deviceId: number().int().nonnegative(),
11882
11980
  camStreamId: string().min(1),
11883
11981
  kind: CamStreamKindSchema,
@@ -12132,6 +12230,16 @@ var PickStreamRequirementsSchema = object({
12132
12230
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12133
12231
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12134
12232
  minHeight: number().int().positive().optional(),
12233
+ /**
12234
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12235
+ *
12236
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12237
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12238
+ * Without this the ceiling had to be re-implemented by every caller — and
12239
+ * one caller implementing it privately is how a second scoring authority
12240
+ * gets born.
12241
+ */
12242
+ maxHeight: number().int().positive().optional(),
12135
12243
  /** Minimum horizontal resolution. */
12136
12244
  minWidth: number().int().positive().optional(),
12137
12245
  /**
@@ -12148,7 +12256,22 @@ var PickStreamRequirementsSchema = object({
12148
12256
  * transcoded" guard: if the device is already serving the consumer's
12149
12257
  * codec end-to-end, there's nothing to optimise.
12150
12258
  */
12151
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12259
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12260
+ /**
12261
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12262
+ * understanding that it will be transcoded.
12263
+ *
12264
+ * Default `false` — today's behaviour, and the right one for a bypass
12265
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12266
+ * ask the larger question: "what is the best stream for me, transcoding if
12267
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12268
+ * does not, so a passthrough is never lost to a transcode; the answer says
12269
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12270
+ *
12271
+ * This is what lets one picker serve both the bypass and the full source
12272
+ * choice, instead of a consumer scoring privately when the bypass misses.
12273
+ */
12274
+ allowTranscode: boolean().optional()
12152
12275
  }).readonly();
12153
12276
  var PickStreamPreferencesSchema = object({
12154
12277
  /**
@@ -12162,12 +12285,32 @@ var PickStreamPreferencesSchema = object({
12162
12285
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12163
12286
  * memory-constrained consumers / Apple Home guest sessions).
12164
12287
  */
12165
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12288
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12289
+ /**
12290
+ * The height the consumer actually wants to DELIVER.
12291
+ *
12292
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12293
+ * above the target wins, and only if nothing reaches it does the tallest
12294
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12295
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12296
+ * express that: it says "as big as possible", which is a different wish.
12297
+ *
12298
+ * Ignored when absent, so every existing caller keeps its ordering.
12299
+ */
12300
+ targetHeight: number().int().positive().optional()
12166
12301
  }).readonly();
12167
12302
  var PickedCamStreamSchema = object({
12168
12303
  camStreamId: string(),
12169
12304
  codec: string().optional(),
12170
12305
  resolution: CamStreamResolutionSchema.optional(),
12306
+ /**
12307
+ * Whether serving this stream requires a decode + re-encode.
12308
+ *
12309
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12310
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12311
+ * not ask cannot be handed a cost it never agreed to pay.
12312
+ */
12313
+ transcodes: boolean(),
12171
12314
  /** One-line explanation of why this stream won — for logs / debug UI. */
12172
12315
  reason: string()
12173
12316
  });
@@ -16356,6 +16499,8 @@ var NcSystemEventKindSchema = _enum([
16356
16499
  "device-enabled",
16357
16500
  "device-battery-low",
16358
16501
  "device-battery-normal",
16502
+ "device-consumable-low",
16503
+ "device-consumable-normal",
16359
16504
  "stream-online",
16360
16505
  "stream-offline",
16361
16506
  "node-online",
@@ -16374,6 +16519,7 @@ var NcSystemEventKindSchema = _enum([
16374
16519
  "addon-updated",
16375
16520
  "server-updated",
16376
16521
  "export-completed",
16522
+ "backup-completed",
16377
16523
  "camera-online",
16378
16524
  "camera-offline",
16379
16525
  "camera-disabled",
@@ -19770,13 +19916,109 @@ var SummariesQueryInput = object({
19770
19916
  deviceIds: array(number()).min(1),
19771
19917
  since: number().optional(),
19772
19918
  until: number().optional(),
19773
- limit: number().int().min(1).max(200).default(50)
19919
+ limit: number().int().min(1).max(200).default(50),
19920
+ /** The same member-wise filter {@link listRecentSummaries} takes — one
19921
+ * meaning of "dog" on every summary surface. */
19922
+ classes: array(string().min(1).max(60)).max(40).optional()
19774
19923
  });
19775
- var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
19776
19924
  var SummaryDetailSchema = object({
19777
19925
  summary: SummarySchema,
19778
- /** Member track ids, in absorption order. */
19779
- trackIds: array(string()).readonly()
19926
+ /** Members in absorption order, oldest join first. */
19927
+ members: array(object({
19928
+ trackId: string(),
19929
+ /**
19930
+ * The track's class at the time it JOINED, or `null` when it was unresolved
19931
+ * and the track no longer exists to fill it.
19932
+ *
19933
+ * The join, not the latest opinion: class voting can re-decide a track's
19934
+ * class afterwards, and a group's composition is the history of who came
19935
+ * together. A consumer counts these to badge a thumbnail — "two people and a
19936
+ * dog" — rather than being handed a second, denormalised tally that would
19937
+ * drift from the members it claims to describe.
19938
+ */
19939
+ className: string().nullable(),
19940
+ /** `primary` is the one member that carries the group's identity. */
19941
+ role: _enum([
19942
+ "primary",
19943
+ "sibling",
19944
+ "child"
19945
+ ]).nullable(),
19946
+ joinedAt: number(),
19947
+ /** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
19948
+ * at read time. Absent when nothing resolved, never an empty string. */
19949
+ label: string().optional(),
19950
+ /** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
19951
+ * recognised nobody, and absent for a member whose track has been pruned —
19952
+ * a thumbnail that names the wrong person is worse than one naming nobody. */
19953
+ subLabel: string().optional()
19954
+ })).readonly()
19955
+ });
19956
+ /**
19957
+ * What a LIST of groups carries: the envelope plus what it is MADE OF.
19958
+ *
19959
+ * Coarse on purpose — the operator's rule is "only the rough data on the list,
19960
+ * we extend when we notice we need more". Enough to draw the card ("two people
19961
+ * and a dog") and no more. The MEMBERS, their names and the per-member links
19962
+ * are on {@link getSummary}: shipping every member of every group so a client
19963
+ * can count them turns a page of two hundred groups into a thousand records to
19964
+ * draw two hundred badges.
19965
+ */
19966
+ var SummaryListItemSchema = object({
19967
+ summary: SummarySchema,
19968
+ /** Class counts, most numerous first; `className: null` is a member whose
19969
+ * class never resolved, counted so the counts add up to `memberCount`. */
19970
+ classes: array(object({
19971
+ className: string().nullable(),
19972
+ count: number().int().positive()
19973
+ })).readonly()
19974
+ });
19975
+ var SummariesPageSchema = object({ summaries: array(SummaryListItemSchema).readonly() });
19976
+ /**
19977
+ * The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
19978
+ *
19979
+ * The reel on the cameras page and the Events gallery both ride a cursor, so a
19980
+ * summaries feed that could only answer "the last N for these cameras"
19981
+ * (`listSummaries`) would make groups available in the timeline and nowhere
19982
+ * else. Two feeds with different ordering contracts would be two ideas of what
19983
+ * "newest" means, on one screen.
19984
+ */
19985
+ var RecentSummariesQueryInput = object({
19986
+ /** Devices to merge. An empty array yields an empty page. */
19987
+ deviceIds: array(number()),
19988
+ /** Window lower bound on `lastActiveAt` (inclusive). */
19989
+ since: number().optional(),
19990
+ /** Window upper bound on `lastActiveAt` (inclusive). */
19991
+ until: number().optional(),
19992
+ limit: number().int().min(1).max(500).default(100),
19993
+ /** Opaque continuation cursor from a previous page's `nextCursor`. */
19994
+ cursor: string().optional(),
19995
+ /**
19996
+ * Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
19997
+ * deliberately the same name: the events filter tree emits one list of ticked
19998
+ * taxonomy nodes, and a summaries feed that called it something else would
19999
+ * make the operator's one filter component produce two shapes.
20000
+ *
20001
+ * A question about the MEMBERS: a group matches when ANY of them does. "Show
20002
+ * me the arrivals with a dog" has to return the group of four people who had
20003
+ * one with them; a filter on the group's own fields could only ever answer
20004
+ * about its primary.
20005
+ *
20006
+ * Matched against all THREE tiers of a member — the class (`animal`), the
20007
+ * sub-class (`dog`) and the instance (a name, a plate) — because which tier a
20008
+ * ticked node lives on is the taxonomy's business, not the caller's. `dog` is
20009
+ * an event kind in the tree and a tier-1 label on an `animal` track; a filter
20010
+ * that read only the class would answer "animal" and never "dog".
20011
+ *
20012
+ * ABSENT or EMPTY means no filter — absent is not a selection of none.
20013
+ */
20014
+ classes: array(string().min(1).max(60)).max(40).optional()
20015
+ });
20016
+ var RecentSummariesPageSchema = object({
20017
+ /** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
20018
+ * {@link listSummaries} — one list shape, so a card renders the same
20019
+ * whichever feed drew it. */
20020
+ summaries: array(SummaryListItemSchema).readonly(),
20021
+ nextCursor: string().nullable()
19780
20022
  });
19781
20023
  var RecentTracksPageSchema = object({
19782
20024
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -20190,7 +20432,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20190
20432
  classes: array(string()).optional(),
20191
20433
  /** See {@link ExcludeSourcesDoc}. */
20192
20434
  excludeSources: array(TrackSourceSchema).optional()
20193
- }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
20435
+ }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(RecentSummariesQueryInput, RecentSummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
20194
20436
  kind: "mutation",
20195
20437
  auth: "admin"
20196
20438
  }), 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({
@@ -23579,10 +23821,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23579
23821
  }), boolean()), method(object({
23580
23822
  deviceId: number().int().nonnegative(),
23581
23823
  sessionId: string()
23582
- }), object({ pendingRenegotiation: object({
23583
- target: WebrtcStreamTargetSchema,
23584
- epoch: number()
23585
- }).nullable() }));
23824
+ }), object({
23825
+ pendingRenegotiation: object({
23826
+ target: WebrtcStreamTargetSchema,
23827
+ epoch: number()
23828
+ }).nullable(),
23829
+ /**
23830
+ * Whether the session still EXISTS.
23831
+ *
23832
+ * A consumer that holds a resource for the life of a session needs to
23833
+ * be able to ask, because a session does not always end the way it
23834
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
23835
+ * sent `SessionDisconnected`, so the Alexa exporter's
23836
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
23837
+ * H.264 transcode kept running for NOBODY for more than twenty
23838
+ * minutes. The WebRTC session had logged `WebRTC session closed`
23839
+ * minutes earlier — the broker knew; the holder had no way to ask.
23840
+ *
23841
+ * `false` for a session id the provider has never heard of, which is
23842
+ * the same answer as "it ended": either way nothing is holding it up.
23843
+ */
23844
+ alive: boolean()
23845
+ }));
23586
23846
  object({
23587
23847
  /** All accessory children of the parent. */
23588
23848
  childDeviceIds: array(number()).readonly(),
@@ -29856,7 +30116,29 @@ var LoggingSettingsPatchSchema = object({
29856
30116
  * disarmed the channels it did not mention would make the Levels page and
29857
30117
  * the Diagnostics page fight over the same value.
29858
30118
  */
29859
- channels: array(LogChannelWindowPatchSchema).readonly().optional()
30119
+ channels: array(LogChannelWindowPatchSchema).readonly().optional(),
30120
+ /**
30121
+ * How many days the analytics OPS LOG is kept — the audit trail of what
30122
+ * retention actually deleted.
30123
+ *
30124
+ * It lives HERE, on the logging document, and not on the analytics addon's
30125
+ * settings form, on the operator's instruction: every other log-ish window in
30126
+ * this system is configured through this one document, and a retention audit
30127
+ * configured somewhere else is a second place to look when the question is
30128
+ * "what happened to my data".
30129
+ *
30130
+ * That placement has a cost worth stating: this document ships in the
30131
+ * framework closure, so this knob needs a published `@camstack/server` while
30132
+ * the four windows beside it (D485) reach a node on `camstack deploy`.
30133
+ *
30134
+ * `retention-model.ts` argued this one must NOT follow a device window,
30135
+ * because the audit trail is the history of the SWEEP and not of the camera.
30136
+ * That argument stands and is untouched — what changes is that 30 days stops
30137
+ * being a constant nobody can reach. `0` keeps it forever. The floor is 1 day
30138
+ * rather than 0-as-delete: an audit log truncated to nothing is precisely the
30139
+ * state in which the next 9.5 GiB leak cannot be explained.
30140
+ */
30141
+ opsLogRetentionDays: number().int().min(0).max(3650).optional()
29860
30142
  });
29861
30143
  /**
29862
30144
  * Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
@@ -29929,6 +30211,14 @@ var LoggingSettingsStateSchema = object({
29929
30211
  channels: array(LogChannelDescriptorSchema).readonly(),
29930
30212
  /** The channels ARMED right now, each with its deadline. */
29931
30213
  activeChannels: array(LogChannelWindowStateSchema).readonly(),
30214
+ /**
30215
+ * The ops-log window in days, as it is in force. `0` = kept forever.
30216
+ *
30217
+ * Reported rather than left to the caller's memory of what it wrote: this is
30218
+ * the value the analytics sweep will actually use, and an operator asking how
30219
+ * long their audit trail lives should not have to infer it from a default.
30220
+ */
30221
+ opsLogRetentionDays: number().int().min(0),
29932
30222
  persisted: boolean()
29933
30223
  });
29934
30224
  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(), {
@@ -34088,6 +34378,12 @@ Object.freeze({
34088
34378
  addonId: null,
34089
34379
  access: "view"
34090
34380
  },
34381
+ "pipelineAnalytics.listRecentSummaries": {
34382
+ capName: "pipeline-analytics",
34383
+ capScope: "device",
34384
+ addonId: null,
34385
+ access: "view"
34386
+ },
34091
34387
  "pipelineAnalytics.listRecentTracks": {
34092
34388
  capName: "pipeline-analytics",
34093
34389
  capScope: "device",
@@ -36050,6 +36346,12 @@ Object.freeze({
36050
36346
  addonId: null,
36051
36347
  access: "create"
36052
36348
  },
36349
+ "streamBroker.reportStreamSignal": {
36350
+ capName: "stream-broker",
36351
+ capScope: "system",
36352
+ addonId: null,
36353
+ access: "create"
36354
+ },
36053
36355
  "streamBroker.restartProfile": {
36054
36356
  capName: "stream-broker",
36055
36357
  capScope: "system",
@@ -36134,6 +36436,12 @@ Object.freeze({
36134
36436
  addonId: null,
36135
36437
  access: "create"
36136
36438
  },
36439
+ "streamSignals.listSignals": {
36440
+ capName: "stream-signals",
36441
+ capScope: "device",
36442
+ addonId: null,
36443
+ access: "view"
36444
+ },
36137
36445
  "switch.setState": {
36138
36446
  capName: "switch",
36139
36447
  capScope: "device",
@@ -37915,6 +38223,11 @@ Object.freeze({
37915
38223
  form: "single",
37916
38224
  optional: true
37917
38225
  }],
38226
+ "pipelineAnalytics.listRecentSummaries": [{
38227
+ name: "deviceIds",
38228
+ form: "array",
38229
+ optional: false
38230
+ }],
37918
38231
  "pipelineAnalytics.listRecentTracks": [{
37919
38232
  name: "deviceIds",
37920
38233
  form: "array",
@@ -38501,6 +38814,11 @@ Object.freeze({
38501
38814
  form: "single",
38502
38815
  optional: false
38503
38816
  }],
38817
+ "streamBroker.reportStreamSignal": [{
38818
+ name: "deviceId",
38819
+ form: "single",
38820
+ optional: false
38821
+ }],
38504
38822
  "streamBroker.restartProfile": [{
38505
38823
  name: "deviceId",
38506
38824
  form: "single",
package/dist/smb.addon.js CHANGED
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-C99NWjGN.js");
5
+ const require_shared = require("./shared-SgmN8tGm.js");
6
6
  let node_crypto = require("node:crypto");
7
7
  let node_path = require("node:path");
8
8
  node_path = require_shared.__toESM(node_path);
@@ -1,4 +1,4 @@
1
- import { c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, s as storageProviderCapability } from "./shared-wpNbUebc.mjs";
1
+ import { c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, s as storageProviderCapability } from "./shared-C0LzFm0z.mjs";
2
2
  import { randomUUID } from "node:crypto";
3
3
  import * as path from "node:path";
4
4
  import * as fsp from "node:fs/promises";
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-C99NWjGN.js");
5
+ const require_shared = require("./shared-SgmN8tGm.js");
6
6
  let node_stream = require("node:stream");
7
7
  let webdav = require("webdav");
8
8
  //#region src/providers/webdav/webdav-config-schema.ts
@@ -1,4 +1,4 @@
1
- import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-wpNbUebc.mjs";
1
+ import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-C0LzFm0z.mjs";
2
2
  import { PassThrough } from "node:stream";
3
3
  import { AuthType, createClient } from "webdav";
4
4
  //#region src/providers/webdav/webdav-config-schema.ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-remote-storage",
3
- "version": "1.2.99",
3
+ "version": "1.2.101",
4
4
  "description": "Remote storage providers (SFTP, S3, WebDAV, SMB) — unifies remote backends behind the storage-provider cap",
5
5
  "keywords": [
6
6
  "camstack",