@camstack/addon-tailscale 1.2.71 → 1.2.73

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-B4NWlEs4.js");
27
+ const require_dist = require("../dist-CRZZaJqB.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-CQNpm4VU.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability, r as BOOT_RECOVERY_BACKOFF_MS, t as meshNetworkCapability } from "../dist-BxbhH1L5.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";
@@ -5405,6 +5405,12 @@ Object.fromEntries([
5405
5405
  icon: "move",
5406
5406
  order: 40
5407
5407
  },
5408
+ {
5409
+ id: "navigation",
5410
+ label: "Navigation",
5411
+ icon: "compass",
5412
+ order: 41
5413
+ },
5408
5414
  {
5409
5415
  id: "consumables",
5410
5416
  label: "Consumables",
@@ -6438,6 +6444,21 @@ var CameraStreamSchema = object({
6438
6444
  */
6439
6445
  autoEligible: boolean().optional(),
6440
6446
  /**
6447
+ * The profile slot the PUBLISHER says this stream is: `low` for a stream
6448
+ * whose only sensible role is the low-bandwidth one, `high` for a main
6449
+ * stream. Consulted by the broker's automatic ranking
6450
+ * (`rankInitialAssignment`) BEFORE the pixel-count heuristic, and only there:
6451
+ * an operator's manual assignment still wins, and an absent hint is the
6452
+ * pixel-ranked default every camera had before this field existed.
6453
+ *
6454
+ * Why it exists: a camera with ONE stream ranked to `mid` — the slot no
6455
+ * storage class is written for on its own (`recordings` is high|mid,
6456
+ * `recordingsLow` is low) and the one profile scrub does not read. The robot
6457
+ * camera's single 720p relay is a `low` in every respect except the slot the
6458
+ * heuristic put it in.
6459
+ */
6460
+ profileHint: CamProfileSchema.optional(),
6461
+ /**
6441
6462
  * Transport-specific opaque metadata. The broker passes it through to
6442
6463
  * the source reader without inspecting it. Currently used by
6443
6464
  * `pull-rfc4571` streams to carry the upstream SDP (so the reader can
@@ -7905,7 +7926,22 @@ var RecordingTriggersSchema = object({
7905
7926
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
7906
7927
  * registrare.
7907
7928
  */
7908
- sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
7929
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
7930
+ /**
7931
+ * La camera registra per tutta la durata del SEGNALE che lei stessa
7932
+ * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
7933
+ * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
7934
+ * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
7935
+ * caduta, così una pulizia di quaranta minuti è UNA clip.
7936
+ *
7937
+ * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
7938
+ * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
7939
+ * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
7940
+ * segnale mai abbassato (un evento perso) non può tenere aperta una
7941
+ * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
7942
+ * (`holdTrigger` / `releaseTrigger`).
7943
+ */
7944
+ deviceSignal: boolean().optional()
7909
7945
  });
7910
7946
  /**
7911
7947
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -11369,6 +11405,8 @@ method(object({
11369
11405
  label: string().optional(),
11370
11406
  deviceFeatures: array(string()).optional(),
11371
11407
  autoEligible: boolean().optional(),
11408
+ /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
11409
+ profileHint: CamProfileSchema.optional(),
11372
11410
  metadata: record(string(), unknown()).optional(),
11373
11411
  /** Required when kind === 'derived' — the source camStreamId the
11374
11412
  * derived broker reads its encoded plane from.
@@ -27756,6 +27794,47 @@ method(object({
27756
27794
  auth: "protected"
27757
27795
  });
27758
27796
  /**
27797
+ * A camera's own "record me NOW" LEVEL — a signal the device raises while
27798
+ * something it knows about is happening (a robot vacuum cleaning, a machine
27799
+ * running, a gate open) and lowers when it stops.
27800
+ *
27801
+ * It is a level, not an edge. The sensor triggers the recorder already listens
27802
+ * to (`SOURCE_CAP_ACTIVE_FIELD`) fire on a rising edge and record for a fixed
27803
+ * post-buffer; a cleaning lasts forty minutes, and forty minutes of "this is
27804
+ * still happening" cannot be expressed as an edge plus a post-buffer without
27805
+ * either re-triggering on a timer (polling — D224 forbids the consumer keeping
27806
+ * the fact fresh) or picking a post-buffer long enough to cover every job,
27807
+ * which records the dock for that long after every short one. So the recorder
27808
+ * reads the LEVEL: it records for as long as `active` is true, plus the band's
27809
+ * own post-buffer once it falls.
27810
+ *
27811
+ * Who owns the fact: the PROVIDER of the device, which already reads the state
27812
+ * the signal is derived from (the vacuum's lifecycle state, for Dreame). It
27813
+ * writes this slice on every change; consumers subscribe to the kernel's
27814
+ * `DeviceStateChanged` for it and read it back through
27815
+ * `deviceState.getCapSlice` to reconcile — never a second copy, never a poll
27816
+ * against the device (D224, D8/D11).
27817
+ *
27818
+ * Deliberately NOT a `binary` sensor on the camera: a binary sensor is exported
27819
+ * to Home Assistant, HomeKit and the sensor picker as a thing an operator can
27820
+ * bind, and "the camera wants to record" is not a room sensor. It is a fact
27821
+ * about the camera, on the camera.
27822
+ */
27823
+ var RecordingSignalStatusSchema = object({
27824
+ /** True while the device asks to be recorded. */
27825
+ active: boolean(),
27826
+ /**
27827
+ * Why, in the provider's own vocabulary (a vacuum's `cleaning` / `docked`,
27828
+ * …). Free text for the log line and the UI badge; the recorder never
27829
+ * branches on it.
27830
+ */
27831
+ reason: string(),
27832
+ /** Ms epoch of the last `active` transition. 0 if never observed. */
27833
+ lastChangedAt: number()
27834
+ });
27835
+ RecordingSignalStatusSchema.extend({ lastFetchedAt: number() });
27836
+ DeviceType.Camera, method(object({ deviceId: number() }), RecordingSignalStatusSchema);
27837
+ /**
27759
27838
  * scene-monitor — device-scoped reference-region state cap. An operator marks
27760
27839
  * a rect ROI on a camera frame and names one or more states; the engine
27761
27840
  * (pipeline-analytics, designated post-processing node) reports which state is
@@ -28128,6 +28207,8 @@ var CamStreamDescriptorSchema = object({
28128
28207
  deviceFeatures: array(string()).optional(),
28129
28208
  /** Eligible for automatic profile assignment. Absent = `true`. */
28130
28209
  autoEligible: boolean().optional(),
28210
+ /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
28211
+ profileHint: CamProfileSchema.optional(),
28131
28212
  /** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
28132
28213
  metadata: record(string(), unknown()).optional()
28133
28214
  });
@@ -34073,6 +34154,12 @@ Object.freeze({
34073
34154
  addonId: null,
34074
34155
  access: "view"
34075
34156
  },
34157
+ "recordingSignal.getStatus": {
34158
+ capName: "recording-signal",
34159
+ capScope: "device",
34160
+ addonId: null,
34161
+ access: "view"
34162
+ },
34076
34163
  "sceneMonitor.captureReference": {
34077
34164
  capName: "scene-monitor",
34078
34165
  capScope: "device",
@@ -37065,6 +37152,11 @@ Object.freeze({
37065
37152
  form: "single",
37066
37153
  optional: true
37067
37154
  }],
37155
+ "recordingSignal.getStatus": [{
37156
+ name: "deviceId",
37157
+ form: "single",
37158
+ optional: false
37159
+ }],
37068
37160
  "sceneMonitor.captureReference": [{
37069
37161
  name: "deviceId",
37070
37162
  form: "single",
@@ -5405,6 +5405,12 @@ Object.fromEntries([
5405
5405
  icon: "move",
5406
5406
  order: 40
5407
5407
  },
5408
+ {
5409
+ id: "navigation",
5410
+ label: "Navigation",
5411
+ icon: "compass",
5412
+ order: 41
5413
+ },
5408
5414
  {
5409
5415
  id: "consumables",
5410
5416
  label: "Consumables",
@@ -6438,6 +6444,21 @@ var CameraStreamSchema = object({
6438
6444
  */
6439
6445
  autoEligible: boolean().optional(),
6440
6446
  /**
6447
+ * The profile slot the PUBLISHER says this stream is: `low` for a stream
6448
+ * whose only sensible role is the low-bandwidth one, `high` for a main
6449
+ * stream. Consulted by the broker's automatic ranking
6450
+ * (`rankInitialAssignment`) BEFORE the pixel-count heuristic, and only there:
6451
+ * an operator's manual assignment still wins, and an absent hint is the
6452
+ * pixel-ranked default every camera had before this field existed.
6453
+ *
6454
+ * Why it exists: a camera with ONE stream ranked to `mid` — the slot no
6455
+ * storage class is written for on its own (`recordings` is high|mid,
6456
+ * `recordingsLow` is low) and the one profile scrub does not read. The robot
6457
+ * camera's single 720p relay is a `low` in every respect except the slot the
6458
+ * heuristic put it in.
6459
+ */
6460
+ profileHint: CamProfileSchema.optional(),
6461
+ /**
6441
6462
  * Transport-specific opaque metadata. The broker passes it through to
6442
6463
  * the source reader without inspecting it. Currently used by
6443
6464
  * `pull-rfc4571` streams to carry the upstream SDP (so the reader can
@@ -7905,7 +7926,22 @@ var RecordingTriggersSchema = object({
7905
7926
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
7906
7927
  * registrare.
7907
7928
  */
7908
- sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
7929
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
7930
+ /**
7931
+ * La camera registra per tutta la durata del SEGNALE che lei stessa
7932
+ * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
7933
+ * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
7934
+ * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
7935
+ * caduta, così una pulizia di quaranta minuti è UNA clip.
7936
+ *
7937
+ * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
7938
+ * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
7939
+ * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
7940
+ * segnale mai abbassato (un evento perso) non può tenere aperta una
7941
+ * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
7942
+ * (`holdTrigger` / `releaseTrigger`).
7943
+ */
7944
+ deviceSignal: boolean().optional()
7909
7945
  });
7910
7946
  /**
7911
7947
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -11369,6 +11405,8 @@ method(object({
11369
11405
  label: string().optional(),
11370
11406
  deviceFeatures: array(string()).optional(),
11371
11407
  autoEligible: boolean().optional(),
11408
+ /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
11409
+ profileHint: CamProfileSchema.optional(),
11372
11410
  metadata: record(string(), unknown()).optional(),
11373
11411
  /** Required when kind === 'derived' — the source camStreamId the
11374
11412
  * derived broker reads its encoded plane from.
@@ -27756,6 +27794,47 @@ method(object({
27756
27794
  auth: "protected"
27757
27795
  });
27758
27796
  /**
27797
+ * A camera's own "record me NOW" LEVEL — a signal the device raises while
27798
+ * something it knows about is happening (a robot vacuum cleaning, a machine
27799
+ * running, a gate open) and lowers when it stops.
27800
+ *
27801
+ * It is a level, not an edge. The sensor triggers the recorder already listens
27802
+ * to (`SOURCE_CAP_ACTIVE_FIELD`) fire on a rising edge and record for a fixed
27803
+ * post-buffer; a cleaning lasts forty minutes, and forty minutes of "this is
27804
+ * still happening" cannot be expressed as an edge plus a post-buffer without
27805
+ * either re-triggering on a timer (polling — D224 forbids the consumer keeping
27806
+ * the fact fresh) or picking a post-buffer long enough to cover every job,
27807
+ * which records the dock for that long after every short one. So the recorder
27808
+ * reads the LEVEL: it records for as long as `active` is true, plus the band's
27809
+ * own post-buffer once it falls.
27810
+ *
27811
+ * Who owns the fact: the PROVIDER of the device, which already reads the state
27812
+ * the signal is derived from (the vacuum's lifecycle state, for Dreame). It
27813
+ * writes this slice on every change; consumers subscribe to the kernel's
27814
+ * `DeviceStateChanged` for it and read it back through
27815
+ * `deviceState.getCapSlice` to reconcile — never a second copy, never a poll
27816
+ * against the device (D224, D8/D11).
27817
+ *
27818
+ * Deliberately NOT a `binary` sensor on the camera: a binary sensor is exported
27819
+ * to Home Assistant, HomeKit and the sensor picker as a thing an operator can
27820
+ * bind, and "the camera wants to record" is not a room sensor. It is a fact
27821
+ * about the camera, on the camera.
27822
+ */
27823
+ var RecordingSignalStatusSchema = object({
27824
+ /** True while the device asks to be recorded. */
27825
+ active: boolean(),
27826
+ /**
27827
+ * Why, in the provider's own vocabulary (a vacuum's `cleaning` / `docked`,
27828
+ * …). Free text for the log line and the UI badge; the recorder never
27829
+ * branches on it.
27830
+ */
27831
+ reason: string(),
27832
+ /** Ms epoch of the last `active` transition. 0 if never observed. */
27833
+ lastChangedAt: number()
27834
+ });
27835
+ RecordingSignalStatusSchema.extend({ lastFetchedAt: number() });
27836
+ DeviceType.Camera, method(object({ deviceId: number() }), RecordingSignalStatusSchema);
27837
+ /**
27759
27838
  * scene-monitor — device-scoped reference-region state cap. An operator marks
27760
27839
  * a rect ROI on a camera frame and names one or more states; the engine
27761
27840
  * (pipeline-analytics, designated post-processing node) reports which state is
@@ -28128,6 +28207,8 @@ var CamStreamDescriptorSchema = object({
28128
28207
  deviceFeatures: array(string()).optional(),
28129
28208
  /** Eligible for automatic profile assignment. Absent = `true`. */
28130
28209
  autoEligible: boolean().optional(),
28210
+ /** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
28211
+ profileHint: CamProfileSchema.optional(),
28131
28212
  /** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
28132
28213
  metadata: record(string(), unknown()).optional()
28133
28214
  });
@@ -34073,6 +34154,12 @@ Object.freeze({
34073
34154
  addonId: null,
34074
34155
  access: "view"
34075
34156
  },
34157
+ "recordingSignal.getStatus": {
34158
+ capName: "recording-signal",
34159
+ capScope: "device",
34160
+ addonId: null,
34161
+ access: "view"
34162
+ },
34076
34163
  "sceneMonitor.captureReference": {
34077
34164
  capName: "scene-monitor",
34078
34165
  capScope: "device",
@@ -37065,6 +37152,11 @@ Object.freeze({
37065
37152
  form: "single",
37066
37153
  optional: true
37067
37154
  }],
37155
+ "recordingSignal.getStatus": [{
37156
+ name: "deviceId",
37157
+ form: "single",
37158
+ optional: false
37159
+ }],
37068
37160
  "sceneMonitor.captureReference": [{
37069
37161
  name: "deviceId",
37070
37162
  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-B4NWlEs4.js");
5
+ const require_dist = require("../dist-CRZZaJqB.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-CQNpm4VU.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability } from "../dist-BxbhH1L5.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.71",
3
+ "version": "1.2.73",
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",