@camstack/addon-tailscale 1.2.101 → 1.2.102

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
24
24
  enumerable: true
25
25
  }) : target, mod));
26
26
  //#endregion
27
- const require_dist = require("../dist-BfWsQb9o.js");
27
+ const require_dist = require("../dist-BcyUFopm.js");
28
28
  let node_child_process = require("node:child_process");
29
29
  let node_util = require("node:util");
30
30
  let node_fs = require("node:fs");
@@ -1,4 +1,4 @@
1
- import { a as EventCategory, i as BaseAddon, n as networkAccessCapability, r as BOOT_RECOVERY_BACKOFF_MS, t as meshNetworkCapability } from "../dist-Gl7DmccH.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability, r as BOOT_RECOVERY_BACKOFF_MS, t as meshNetworkCapability } from "../dist-AkkjrQjN.mjs";
2
2
  import { execFile, spawn } from "node:child_process";
3
3
  import { promisify } from "node:util";
4
4
  import * as fs from "node:fs";
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-ZyX6jcse.mjs
1
+ //#region ../types/dist/event-category-BVDXG4tB.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -615,6 +615,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
615
615
  * pull-reconcile from the provider's `getStatus` on reconnect. */
616
616
  EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
617
617
  EventCategory["BackupCompleted"] = "backup.completed";
618
+ /**
619
+ * A whole backup RUN finished — every destination attempted, win or lose.
620
+ *
621
+ * `backup.completed` fires once per DESTINATION, which is the right grain for
622
+ * a progress UI and the wrong one for a notification: an operator with three
623
+ * destinations would be told three times. And a run where two of three
624
+ * destinations succeeded is not a clean success — a single "backup
625
+ * completed" that hid the failed one would be a lie, so the count of each is
626
+ * carried here and the message says both.
627
+ *
628
+ * Emitted by the backup orchestrator only after the destination loop, so a
629
+ * run that dies during the BUILD phase produces no completion at all.
630
+ */
631
+ EventCategory["BackupRunCompleted"] = "backup.run-completed";
618
632
  EventCategory["BackupRestored"] = "backup.restored";
619
633
  EventCategory["NotificationDispatched"] = "notification.dispatched";
620
634
  EventCategory["NotificationFailed"] = "notification.failed";
@@ -5345,7 +5359,7 @@ var ZodIssueCode = {
5345
5359
  var ZodFirstPartyTypeKind;
5346
5360
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5347
5361
  //#endregion
5348
- //#region ../types/dist/sleep-DBKu2-U5.mjs
5362
+ //#region ../types/dist/sleep-DEuj7E3j.mjs
5349
5363
  /**
5350
5364
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5351
5365
  * window to float samples (D455).
@@ -11507,6 +11521,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11507
11521
  auth: "admin"
11508
11522
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11509
11523
  DeviceType.Camera;
11524
+ /**
11525
+ * The signals a device can emit to WAKE its own stream.
11526
+ *
11527
+ * A camera whose stream is built on demand sleeps until something asks for it,
11528
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
11529
+ * puller holds a session open for ever, and treating that as demand would keep
11530
+ * a battery camera awake for ever, which is the whole thing the battery is for
11531
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
11532
+ * itself, with no stream running.
11533
+ *
11534
+ * ## The vocabulary is the PROVIDER'S, not ours
11535
+ *
11536
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
11537
+ * names each signal with a `code` it chooses and a `label` an operator reads.
11538
+ * Reolink offers motion and camera-native detection; another provider may offer
11539
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
11540
+ * yet. A fixed enum here would mean every new signal is a framework release.
11541
+ *
11542
+ * It is deliberately NOT derived from the caps a device already binds. Whether
11543
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
11544
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
11545
+ * binding — but both answer "what drives the detection pipeline", which is a
11546
+ * different question from "what may wake a sleeping stream". A camera can do
11547
+ * the first and not be trusted with the second, and the operator picks per
11548
+ * camera. Two questions, two authorities.
11549
+ *
11550
+ * ## Availability is not permission
11551
+ *
11552
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
11553
+ * wakes the stream is the operator's per-camera choice, held by the broker
11554
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
11555
+ * provider declaring a signal is not a provider enabling it.
11556
+ */
11557
+ /** One signal a device can emit. */
11558
+ var StreamSignalSchema = object({
11559
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
11560
+ code: string().min(1),
11561
+ /** What an operator reads in the picker. The provider's own wording. */
11562
+ label: string().min(1),
11563
+ /**
11564
+ * Whether the provider recommends this signal ON when a camera is first set
11565
+ * up. A provider knows which of its signals are cheap and reliable; an
11566
+ * operator should not have to discover that by trial. Reolink recommends
11567
+ * both of its own.
11568
+ */
11569
+ recommended: boolean()
11570
+ });
11571
+ object({
11572
+ signals: array(StreamSignalSchema),
11573
+ lastFetchedAt: number()
11574
+ });
11575
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
11510
11576
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11511
11577
  var StreamFormatSchema = _enum([
11512
11578
  "webrtc",
@@ -11903,6 +11969,22 @@ var EgressTranscodeSchema = object({
11903
11969
  camStreamId: string().nullable()
11904
11970
  });
11905
11971
  method(object({
11972
+ deviceId: number().int().nonnegative(),
11973
+ /** The provider's signal code. */
11974
+ code: string().min(1),
11975
+ /** Ms epoch. Absent ⇒ now. */
11976
+ at: number().optional()
11977
+ }), object({
11978
+ /** Whether the broker acted on it, and if not, why. */
11979
+ accepted: boolean(),
11980
+ reason: _enum([
11981
+ "woke",
11982
+ "hold-extended",
11983
+ "not-enabled",
11984
+ "no-consumer",
11985
+ "unknown-code"
11986
+ ])
11987
+ }), { kind: "mutation" }), method(object({
11906
11988
  deviceId: number().int().nonnegative(),
11907
11989
  camStreamId: string().min(1),
11908
11990
  kind: CamStreamKindSchema,
@@ -12157,6 +12239,16 @@ var PickStreamRequirementsSchema = object({
12157
12239
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12158
12240
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12159
12241
  minHeight: number().int().positive().optional(),
12242
+ /**
12243
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12244
+ *
12245
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12246
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12247
+ * Without this the ceiling had to be re-implemented by every caller — and
12248
+ * one caller implementing it privately is how a second scoring authority
12249
+ * gets born.
12250
+ */
12251
+ maxHeight: number().int().positive().optional(),
12160
12252
  /** Minimum horizontal resolution. */
12161
12253
  minWidth: number().int().positive().optional(),
12162
12254
  /**
@@ -12173,7 +12265,22 @@ var PickStreamRequirementsSchema = object({
12173
12265
  * transcoded" guard: if the device is already serving the consumer's
12174
12266
  * codec end-to-end, there's nothing to optimise.
12175
12267
  */
12176
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12268
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12269
+ /**
12270
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12271
+ * understanding that it will be transcoded.
12272
+ *
12273
+ * Default `false` — today's behaviour, and the right one for a bypass
12274
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12275
+ * ask the larger question: "what is the best stream for me, transcoding if
12276
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12277
+ * does not, so a passthrough is never lost to a transcode; the answer says
12278
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12279
+ *
12280
+ * This is what lets one picker serve both the bypass and the full source
12281
+ * choice, instead of a consumer scoring privately when the bypass misses.
12282
+ */
12283
+ allowTranscode: boolean().optional()
12177
12284
  }).readonly();
12178
12285
  var PickStreamPreferencesSchema = object({
12179
12286
  /**
@@ -12187,12 +12294,32 @@ var PickStreamPreferencesSchema = object({
12187
12294
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12188
12295
  * memory-constrained consumers / Apple Home guest sessions).
12189
12296
  */
12190
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12297
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12298
+ /**
12299
+ * The height the consumer actually wants to DELIVER.
12300
+ *
12301
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12302
+ * above the target wins, and only if nothing reaches it does the tallest
12303
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12304
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12305
+ * express that: it says "as big as possible", which is a different wish.
12306
+ *
12307
+ * Ignored when absent, so every existing caller keeps its ordering.
12308
+ */
12309
+ targetHeight: number().int().positive().optional()
12191
12310
  }).readonly();
12192
12311
  var PickedCamStreamSchema = object({
12193
12312
  camStreamId: string(),
12194
12313
  codec: string().optional(),
12195
12314
  resolution: CamStreamResolutionSchema.optional(),
12315
+ /**
12316
+ * Whether serving this stream requires a decode + re-encode.
12317
+ *
12318
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12319
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12320
+ * not ask cannot be handed a cost it never agreed to pay.
12321
+ */
12322
+ transcodes: boolean(),
12196
12323
  /** One-line explanation of why this stream won — for logs / debug UI. */
12197
12324
  reason: string()
12198
12325
  });
@@ -16398,6 +16525,8 @@ var NcSystemEventKindSchema = _enum([
16398
16525
  "device-enabled",
16399
16526
  "device-battery-low",
16400
16527
  "device-battery-normal",
16528
+ "device-consumable-low",
16529
+ "device-consumable-normal",
16401
16530
  "stream-online",
16402
16531
  "stream-offline",
16403
16532
  "node-online",
@@ -16416,6 +16545,7 @@ var NcSystemEventKindSchema = _enum([
16416
16545
  "addon-updated",
16417
16546
  "server-updated",
16418
16547
  "export-completed",
16548
+ "backup-completed",
16419
16549
  "camera-online",
16420
16550
  "camera-offline",
16421
16551
  "camera-disabled",
@@ -23657,10 +23787,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23657
23787
  }), boolean()), method(object({
23658
23788
  deviceId: number().int().nonnegative(),
23659
23789
  sessionId: string()
23660
- }), object({ pendingRenegotiation: object({
23661
- target: WebrtcStreamTargetSchema,
23662
- epoch: number()
23663
- }).nullable() }));
23790
+ }), object({
23791
+ pendingRenegotiation: object({
23792
+ target: WebrtcStreamTargetSchema,
23793
+ epoch: number()
23794
+ }).nullable(),
23795
+ /**
23796
+ * Whether the session still EXISTS.
23797
+ *
23798
+ * A consumer that holds a resource for the life of a session needs to
23799
+ * be able to ask, because a session does not always end the way it
23800
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
23801
+ * sent `SessionDisconnected`, so the Alexa exporter's
23802
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
23803
+ * H.264 transcode kept running for NOBODY for more than twenty
23804
+ * minutes. The WebRTC session had logged `WebRTC session closed`
23805
+ * minutes earlier — the broker knew; the holder had no way to ask.
23806
+ *
23807
+ * `false` for a session id the provider has never heard of, which is
23808
+ * the same answer as "it ended": either way nothing is holding it up.
23809
+ */
23810
+ alive: boolean()
23811
+ }));
23664
23812
  object({
23665
23813
  /** All accessory children of the parent. */
23666
23814
  childDeviceIds: array(number()).readonly(),
@@ -36225,6 +36373,12 @@ Object.freeze({
36225
36373
  addonId: null,
36226
36374
  access: "create"
36227
36375
  },
36376
+ "streamBroker.reportStreamSignal": {
36377
+ capName: "stream-broker",
36378
+ capScope: "system",
36379
+ addonId: null,
36380
+ access: "create"
36381
+ },
36228
36382
  "streamBroker.restartProfile": {
36229
36383
  capName: "stream-broker",
36230
36384
  capScope: "system",
@@ -36309,6 +36463,12 @@ Object.freeze({
36309
36463
  addonId: null,
36310
36464
  access: "create"
36311
36465
  },
36466
+ "streamSignals.listSignals": {
36467
+ capName: "stream-signals",
36468
+ capScope: "device",
36469
+ addonId: null,
36470
+ access: "view"
36471
+ },
36312
36472
  "switch.setState": {
36313
36473
  capName: "switch",
36314
36474
  capScope: "device",
@@ -38681,6 +38841,11 @@ Object.freeze({
38681
38841
  form: "single",
38682
38842
  optional: false
38683
38843
  }],
38844
+ "streamBroker.reportStreamSignal": [{
38845
+ name: "deviceId",
38846
+ form: "single",
38847
+ optional: false
38848
+ }],
38684
38849
  "streamBroker.restartProfile": [{
38685
38850
  name: "deviceId",
38686
38851
  form: "single",
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-ZyX6jcse.mjs
1
+ //#region ../types/dist/event-category-BVDXG4tB.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -615,6 +615,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
615
615
  * pull-reconcile from the provider's `getStatus` on reconnect. */
616
616
  EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
617
617
  EventCategory["BackupCompleted"] = "backup.completed";
618
+ /**
619
+ * A whole backup RUN finished — every destination attempted, win or lose.
620
+ *
621
+ * `backup.completed` fires once per DESTINATION, which is the right grain for
622
+ * a progress UI and the wrong one for a notification: an operator with three
623
+ * destinations would be told three times. And a run where two of three
624
+ * destinations succeeded is not a clean success — a single "backup
625
+ * completed" that hid the failed one would be a lie, so the count of each is
626
+ * carried here and the message says both.
627
+ *
628
+ * Emitted by the backup orchestrator only after the destination loop, so a
629
+ * run that dies during the BUILD phase produces no completion at all.
630
+ */
631
+ EventCategory["BackupRunCompleted"] = "backup.run-completed";
618
632
  EventCategory["BackupRestored"] = "backup.restored";
619
633
  EventCategory["NotificationDispatched"] = "notification.dispatched";
620
634
  EventCategory["NotificationFailed"] = "notification.failed";
@@ -5345,7 +5359,7 @@ var ZodIssueCode = {
5345
5359
  var ZodFirstPartyTypeKind;
5346
5360
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5347
5361
  //#endregion
5348
- //#region ../types/dist/sleep-DBKu2-U5.mjs
5362
+ //#region ../types/dist/sleep-DEuj7E3j.mjs
5349
5363
  /**
5350
5364
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5351
5365
  * window to float samples (D455).
@@ -11507,6 +11521,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11507
11521
  auth: "admin"
11508
11522
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11509
11523
  DeviceType.Camera;
11524
+ /**
11525
+ * The signals a device can emit to WAKE its own stream.
11526
+ *
11527
+ * A camera whose stream is built on demand sleeps until something asks for it,
11528
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
11529
+ * puller holds a session open for ever, and treating that as demand would keep
11530
+ * a battery camera awake for ever, which is the whole thing the battery is for
11531
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
11532
+ * itself, with no stream running.
11533
+ *
11534
+ * ## The vocabulary is the PROVIDER'S, not ours
11535
+ *
11536
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
11537
+ * names each signal with a `code` it chooses and a `label` an operator reads.
11538
+ * Reolink offers motion and camera-native detection; another provider may offer
11539
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
11540
+ * yet. A fixed enum here would mean every new signal is a framework release.
11541
+ *
11542
+ * It is deliberately NOT derived from the caps a device already binds. Whether
11543
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
11544
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
11545
+ * binding — but both answer "what drives the detection pipeline", which is a
11546
+ * different question from "what may wake a sleeping stream". A camera can do
11547
+ * the first and not be trusted with the second, and the operator picks per
11548
+ * camera. Two questions, two authorities.
11549
+ *
11550
+ * ## Availability is not permission
11551
+ *
11552
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
11553
+ * wakes the stream is the operator's per-camera choice, held by the broker
11554
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
11555
+ * provider declaring a signal is not a provider enabling it.
11556
+ */
11557
+ /** One signal a device can emit. */
11558
+ var StreamSignalSchema = object({
11559
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
11560
+ code: string().min(1),
11561
+ /** What an operator reads in the picker. The provider's own wording. */
11562
+ label: string().min(1),
11563
+ /**
11564
+ * Whether the provider recommends this signal ON when a camera is first set
11565
+ * up. A provider knows which of its signals are cheap and reliable; an
11566
+ * operator should not have to discover that by trial. Reolink recommends
11567
+ * both of its own.
11568
+ */
11569
+ recommended: boolean()
11570
+ });
11571
+ object({
11572
+ signals: array(StreamSignalSchema),
11573
+ lastFetchedAt: number()
11574
+ });
11575
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
11510
11576
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11511
11577
  var StreamFormatSchema = _enum([
11512
11578
  "webrtc",
@@ -11903,6 +11969,22 @@ var EgressTranscodeSchema = object({
11903
11969
  camStreamId: string().nullable()
11904
11970
  });
11905
11971
  method(object({
11972
+ deviceId: number().int().nonnegative(),
11973
+ /** The provider's signal code. */
11974
+ code: string().min(1),
11975
+ /** Ms epoch. Absent ⇒ now. */
11976
+ at: number().optional()
11977
+ }), object({
11978
+ /** Whether the broker acted on it, and if not, why. */
11979
+ accepted: boolean(),
11980
+ reason: _enum([
11981
+ "woke",
11982
+ "hold-extended",
11983
+ "not-enabled",
11984
+ "no-consumer",
11985
+ "unknown-code"
11986
+ ])
11987
+ }), { kind: "mutation" }), method(object({
11906
11988
  deviceId: number().int().nonnegative(),
11907
11989
  camStreamId: string().min(1),
11908
11990
  kind: CamStreamKindSchema,
@@ -12157,6 +12239,16 @@ var PickStreamRequirementsSchema = object({
12157
12239
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12158
12240
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12159
12241
  minHeight: number().int().positive().optional(),
12242
+ /**
12243
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12244
+ *
12245
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12246
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12247
+ * Without this the ceiling had to be re-implemented by every caller — and
12248
+ * one caller implementing it privately is how a second scoring authority
12249
+ * gets born.
12250
+ */
12251
+ maxHeight: number().int().positive().optional(),
12160
12252
  /** Minimum horizontal resolution. */
12161
12253
  minWidth: number().int().positive().optional(),
12162
12254
  /**
@@ -12173,7 +12265,22 @@ var PickStreamRequirementsSchema = object({
12173
12265
  * transcoded" guard: if the device is already serving the consumer's
12174
12266
  * codec end-to-end, there's nothing to optimise.
12175
12267
  */
12176
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12268
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12269
+ /**
12270
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12271
+ * understanding that it will be transcoded.
12272
+ *
12273
+ * Default `false` — today's behaviour, and the right one for a bypass
12274
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12275
+ * ask the larger question: "what is the best stream for me, transcoding if
12276
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12277
+ * does not, so a passthrough is never lost to a transcode; the answer says
12278
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12279
+ *
12280
+ * This is what lets one picker serve both the bypass and the full source
12281
+ * choice, instead of a consumer scoring privately when the bypass misses.
12282
+ */
12283
+ allowTranscode: boolean().optional()
12177
12284
  }).readonly();
12178
12285
  var PickStreamPreferencesSchema = object({
12179
12286
  /**
@@ -12187,12 +12294,32 @@ var PickStreamPreferencesSchema = object({
12187
12294
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12188
12295
  * memory-constrained consumers / Apple Home guest sessions).
12189
12296
  */
12190
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12297
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12298
+ /**
12299
+ * The height the consumer actually wants to DELIVER.
12300
+ *
12301
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12302
+ * above the target wins, and only if nothing reaches it does the tallest
12303
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12304
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12305
+ * express that: it says "as big as possible", which is a different wish.
12306
+ *
12307
+ * Ignored when absent, so every existing caller keeps its ordering.
12308
+ */
12309
+ targetHeight: number().int().positive().optional()
12191
12310
  }).readonly();
12192
12311
  var PickedCamStreamSchema = object({
12193
12312
  camStreamId: string(),
12194
12313
  codec: string().optional(),
12195
12314
  resolution: CamStreamResolutionSchema.optional(),
12315
+ /**
12316
+ * Whether serving this stream requires a decode + re-encode.
12317
+ *
12318
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12319
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12320
+ * not ask cannot be handed a cost it never agreed to pay.
12321
+ */
12322
+ transcodes: boolean(),
12196
12323
  /** One-line explanation of why this stream won — for logs / debug UI. */
12197
12324
  reason: string()
12198
12325
  });
@@ -16398,6 +16525,8 @@ var NcSystemEventKindSchema = _enum([
16398
16525
  "device-enabled",
16399
16526
  "device-battery-low",
16400
16527
  "device-battery-normal",
16528
+ "device-consumable-low",
16529
+ "device-consumable-normal",
16401
16530
  "stream-online",
16402
16531
  "stream-offline",
16403
16532
  "node-online",
@@ -16416,6 +16545,7 @@ var NcSystemEventKindSchema = _enum([
16416
16545
  "addon-updated",
16417
16546
  "server-updated",
16418
16547
  "export-completed",
16548
+ "backup-completed",
16419
16549
  "camera-online",
16420
16550
  "camera-offline",
16421
16551
  "camera-disabled",
@@ -23657,10 +23787,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23657
23787
  }), boolean()), method(object({
23658
23788
  deviceId: number().int().nonnegative(),
23659
23789
  sessionId: string()
23660
- }), object({ pendingRenegotiation: object({
23661
- target: WebrtcStreamTargetSchema,
23662
- epoch: number()
23663
- }).nullable() }));
23790
+ }), object({
23791
+ pendingRenegotiation: object({
23792
+ target: WebrtcStreamTargetSchema,
23793
+ epoch: number()
23794
+ }).nullable(),
23795
+ /**
23796
+ * Whether the session still EXISTS.
23797
+ *
23798
+ * A consumer that holds a resource for the life of a session needs to
23799
+ * be able to ask, because a session does not always end the way it
23800
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
23801
+ * sent `SessionDisconnected`, so the Alexa exporter's
23802
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
23803
+ * H.264 transcode kept running for NOBODY for more than twenty
23804
+ * minutes. The WebRTC session had logged `WebRTC session closed`
23805
+ * minutes earlier — the broker knew; the holder had no way to ask.
23806
+ *
23807
+ * `false` for a session id the provider has never heard of, which is
23808
+ * the same answer as "it ended": either way nothing is holding it up.
23809
+ */
23810
+ alive: boolean()
23811
+ }));
23664
23812
  object({
23665
23813
  /** All accessory children of the parent. */
23666
23814
  childDeviceIds: array(number()).readonly(),
@@ -36225,6 +36373,12 @@ Object.freeze({
36225
36373
  addonId: null,
36226
36374
  access: "create"
36227
36375
  },
36376
+ "streamBroker.reportStreamSignal": {
36377
+ capName: "stream-broker",
36378
+ capScope: "system",
36379
+ addonId: null,
36380
+ access: "create"
36381
+ },
36228
36382
  "streamBroker.restartProfile": {
36229
36383
  capName: "stream-broker",
36230
36384
  capScope: "system",
@@ -36309,6 +36463,12 @@ Object.freeze({
36309
36463
  addonId: null,
36310
36464
  access: "create"
36311
36465
  },
36466
+ "streamSignals.listSignals": {
36467
+ capName: "stream-signals",
36468
+ capScope: "device",
36469
+ addonId: null,
36470
+ access: "view"
36471
+ },
36312
36472
  "switch.setState": {
36313
36473
  capName: "switch",
36314
36474
  capScope: "device",
@@ -38681,6 +38841,11 @@ Object.freeze({
38681
38841
  form: "single",
38682
38842
  optional: false
38683
38843
  }],
38844
+ "streamBroker.reportStreamSignal": [{
38845
+ name: "deviceId",
38846
+ form: "single",
38847
+ optional: false
38848
+ }],
38684
38849
  "streamBroker.restartProfile": [{
38685
38850
  name: "deviceId",
38686
38851
  form: "single",
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_dist = require("../dist-BfWsQb9o.js");
5
+ const require_dist = require("../dist-BcyUFopm.js");
6
6
  let node_crypto = require("node:crypto");
7
7
  let node_child_process = require("node:child_process");
8
8
  //#region src/ingress/tailscale-cli.ts
@@ -1,4 +1,4 @@
1
- import { a as EventCategory, i as BaseAddon, n as networkAccessCapability } from "../dist-Gl7DmccH.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability } from "../dist-AkkjrQjN.mjs";
2
2
  import { randomUUID } from "node:crypto";
3
3
  import { execFile } from "node:child_process";
4
4
  import { promisify } from "node:util";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-tailscale",
3
- "version": "1.2.101",
3
+ "version": "1.2.102",
4
4
  "description": "Tailscale bundle for CamStack — joins the host to a tailnet (client) and exposes the hub via Serve/Funnel (ingress). Multi-entry npm package shipping 2 addons under a single bundle.",
5
5
  "keywords": [
6
6
  "camstack",