@camstack/addon-remote-storage 1.2.100 → 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-CFfHkuDQ.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-mQ768xoI.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-CFfHkuDQ.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-mQ768xoI.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-DBKu2-U5.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).
@@ -11475,6 +11489,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11475
11489
  auth: "admin"
11476
11490
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11477
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());
11478
11544
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11479
11545
  var StreamFormatSchema = _enum([
11480
11546
  "webrtc",
@@ -11871,6 +11937,22 @@ var EgressTranscodeSchema = object({
11871
11937
  camStreamId: string().nullable()
11872
11938
  });
11873
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({
11874
11956
  deviceId: number().int().nonnegative(),
11875
11957
  camStreamId: string().min(1),
11876
11958
  kind: CamStreamKindSchema,
@@ -12125,6 +12207,16 @@ var PickStreamRequirementsSchema = object({
12125
12207
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12126
12208
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12127
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(),
12128
12220
  /** Minimum horizontal resolution. */
12129
12221
  minWidth: number().int().positive().optional(),
12130
12222
  /**
@@ -12141,7 +12233,22 @@ var PickStreamRequirementsSchema = object({
12141
12233
  * transcoded" guard: if the device is already serving the consumer's
12142
12234
  * codec end-to-end, there's nothing to optimise.
12143
12235
  */
12144
- 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()
12145
12252
  }).readonly();
12146
12253
  var PickStreamPreferencesSchema = object({
12147
12254
  /**
@@ -12155,12 +12262,32 @@ var PickStreamPreferencesSchema = object({
12155
12262
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12156
12263
  * memory-constrained consumers / Apple Home guest sessions).
12157
12264
  */
12158
- 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()
12159
12278
  }).readonly();
12160
12279
  var PickedCamStreamSchema = object({
12161
12280
  camStreamId: string(),
12162
12281
  codec: string().optional(),
12163
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(),
12164
12291
  /** One-line explanation of why this stream won — for logs / debug UI. */
12165
12292
  reason: string()
12166
12293
  });
@@ -16349,6 +16476,8 @@ var NcSystemEventKindSchema = _enum([
16349
16476
  "device-enabled",
16350
16477
  "device-battery-low",
16351
16478
  "device-battery-normal",
16479
+ "device-consumable-low",
16480
+ "device-consumable-normal",
16352
16481
  "stream-online",
16353
16482
  "stream-offline",
16354
16483
  "node-online",
@@ -16367,6 +16496,7 @@ var NcSystemEventKindSchema = _enum([
16367
16496
  "addon-updated",
16368
16497
  "server-updated",
16369
16498
  "export-completed",
16499
+ "backup-completed",
16370
16500
  "camera-online",
16371
16501
  "camera-offline",
16372
16502
  "camera-disabled",
@@ -23668,10 +23798,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23668
23798
  }), boolean()), method(object({
23669
23799
  deviceId: number().int().nonnegative(),
23670
23800
  sessionId: string()
23671
- }), object({ pendingRenegotiation: object({
23672
- target: WebrtcStreamTargetSchema,
23673
- epoch: number()
23674
- }).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
+ }));
23675
23823
  object({
23676
23824
  /** All accessory children of the parent. */
23677
23825
  childDeviceIds: array(number()).readonly(),
@@ -36175,6 +36323,12 @@ Object.freeze({
36175
36323
  addonId: null,
36176
36324
  access: "create"
36177
36325
  },
36326
+ "streamBroker.reportStreamSignal": {
36327
+ capName: "stream-broker",
36328
+ capScope: "system",
36329
+ addonId: null,
36330
+ access: "create"
36331
+ },
36178
36332
  "streamBroker.restartProfile": {
36179
36333
  capName: "stream-broker",
36180
36334
  capScope: "system",
@@ -36259,6 +36413,12 @@ Object.freeze({
36259
36413
  addonId: null,
36260
36414
  access: "create"
36261
36415
  },
36416
+ "streamSignals.listSignals": {
36417
+ capName: "stream-signals",
36418
+ capScope: "device",
36419
+ addonId: null,
36420
+ access: "view"
36421
+ },
36262
36422
  "switch.setState": {
36263
36423
  capName: "switch",
36264
36424
  capScope: "device",
@@ -38631,6 +38791,11 @@ Object.freeze({
38631
38791
  form: "single",
38632
38792
  optional: false
38633
38793
  }],
38794
+ "streamBroker.reportStreamSignal": [{
38795
+ name: "deviceId",
38796
+ form: "single",
38797
+ optional: false
38798
+ }],
38634
38799
  "streamBroker.restartProfile": [{
38635
38800
  name: "deviceId",
38636
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-DBKu2-U5.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).
@@ -11498,6 +11512,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11498
11512
  auth: "admin"
11499
11513
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11500
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());
11501
11567
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11502
11568
  var StreamFormatSchema = _enum([
11503
11569
  "webrtc",
@@ -11894,6 +11960,22 @@ var EgressTranscodeSchema = object({
11894
11960
  camStreamId: string().nullable()
11895
11961
  });
11896
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({
11897
11979
  deviceId: number().int().nonnegative(),
11898
11980
  camStreamId: string().min(1),
11899
11981
  kind: CamStreamKindSchema,
@@ -12148,6 +12230,16 @@ var PickStreamRequirementsSchema = object({
12148
12230
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12149
12231
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12150
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(),
12151
12243
  /** Minimum horizontal resolution. */
12152
12244
  minWidth: number().int().positive().optional(),
12153
12245
  /**
@@ -12164,7 +12256,22 @@ var PickStreamRequirementsSchema = object({
12164
12256
  * transcoded" guard: if the device is already serving the consumer's
12165
12257
  * codec end-to-end, there's nothing to optimise.
12166
12258
  */
12167
- 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()
12168
12275
  }).readonly();
12169
12276
  var PickStreamPreferencesSchema = object({
12170
12277
  /**
@@ -12178,12 +12285,32 @@ var PickStreamPreferencesSchema = object({
12178
12285
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12179
12286
  * memory-constrained consumers / Apple Home guest sessions).
12180
12287
  */
12181
- 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()
12182
12301
  }).readonly();
12183
12302
  var PickedCamStreamSchema = object({
12184
12303
  camStreamId: string(),
12185
12304
  codec: string().optional(),
12186
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(),
12187
12314
  /** One-line explanation of why this stream won — for logs / debug UI. */
12188
12315
  reason: string()
12189
12316
  });
@@ -16372,6 +16499,8 @@ var NcSystemEventKindSchema = _enum([
16372
16499
  "device-enabled",
16373
16500
  "device-battery-low",
16374
16501
  "device-battery-normal",
16502
+ "device-consumable-low",
16503
+ "device-consumable-normal",
16375
16504
  "stream-online",
16376
16505
  "stream-offline",
16377
16506
  "node-online",
@@ -16390,6 +16519,7 @@ var NcSystemEventKindSchema = _enum([
16390
16519
  "addon-updated",
16391
16520
  "server-updated",
16392
16521
  "export-completed",
16522
+ "backup-completed",
16393
16523
  "camera-online",
16394
16524
  "camera-offline",
16395
16525
  "camera-disabled",
@@ -23691,10 +23821,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23691
23821
  }), boolean()), method(object({
23692
23822
  deviceId: number().int().nonnegative(),
23693
23823
  sessionId: string()
23694
- }), object({ pendingRenegotiation: object({
23695
- target: WebrtcStreamTargetSchema,
23696
- epoch: number()
23697
- }).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
+ }));
23698
23846
  object({
23699
23847
  /** All accessory children of the parent. */
23700
23848
  childDeviceIds: array(number()).readonly(),
@@ -36198,6 +36346,12 @@ Object.freeze({
36198
36346
  addonId: null,
36199
36347
  access: "create"
36200
36348
  },
36349
+ "streamBroker.reportStreamSignal": {
36350
+ capName: "stream-broker",
36351
+ capScope: "system",
36352
+ addonId: null,
36353
+ access: "create"
36354
+ },
36201
36355
  "streamBroker.restartProfile": {
36202
36356
  capName: "stream-broker",
36203
36357
  capScope: "system",
@@ -36282,6 +36436,12 @@ Object.freeze({
36282
36436
  addonId: null,
36283
36437
  access: "create"
36284
36438
  },
36439
+ "streamSignals.listSignals": {
36440
+ capName: "stream-signals",
36441
+ capScope: "device",
36442
+ addonId: null,
36443
+ access: "view"
36444
+ },
36285
36445
  "switch.setState": {
36286
36446
  capName: "switch",
36287
36447
  capScope: "device",
@@ -38654,6 +38814,11 @@ Object.freeze({
38654
38814
  form: "single",
38655
38815
  optional: false
38656
38816
  }],
38817
+ "streamBroker.reportStreamSignal": [{
38818
+ name: "deviceId",
38819
+ form: "single",
38820
+ optional: false
38821
+ }],
38657
38822
  "streamBroker.restartProfile": [{
38658
38823
  name: "deviceId",
38659
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-CFfHkuDQ.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-mQ768xoI.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-CFfHkuDQ.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-mQ768xoI.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.100",
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",