@camstack/addon-tailscale 1.2.75 → 1.2.77

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-CRZZaJqB.js");
27
+ const require_dist = require("../dist-D-r2DHbc.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-BxbhH1L5.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability, r as BOOT_RECOVERY_BACKOFF_MS, t as meshNetworkCapability } from "../dist-qvo4-OTG.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";
@@ -7866,17 +7866,29 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
7866
7866
  /**
7867
7867
  * DERIVED per-camera storage summary — the single field cheap consumers read
7868
7868
  * (the viewer's status dot, the camera list) instead of walking `bands`:
7869
- * - `off` — no band covers the camera (or it is disabled).
7870
- * - `events` — every band records around triggers only.
7871
- * - `continuous` — at least one band records continuously.
7872
- *
7873
- * NEVER authored: the recorder stamps it from the authoritative `bands` on
7874
- * every save (`activeModeForConfig`). Writing it has no effect.
7869
+ * - `off` — no band covers the camera (or it is disabled).
7870
+ * - `events` — every band records around triggers only.
7871
+ * - `continuous` — at least one band records continuously.
7872
+ * - `on-device-decision`— the DEVICE decides: recording runs for as long as the
7873
+ * camera raises its own `recording-signal` level (a robot that cleans). There
7874
+ * is no schedule to author, because there is no hour to program — see
7875
+ * {@link RecordingConfigSchema}`.deviceDecision`.
7876
+ *
7877
+ * NEVER authored: the recorder stamps it from the authoritative intent
7878
+ * (`bands` + `deviceDecision`) on every save (`activeModeForConfig`). Writing it
7879
+ * has no effect.
7880
+ *
7881
+ * `on-device-decision` is named for WHO decides, not for how the recording is
7882
+ * requested. `on-demand` was rejected: in this repo's vocabulary a "demand" is
7883
+ * something the operator makes (the live gate is the recorder's own "demand
7884
+ * window"), and a knob whose name suggests the operator starts it while the
7885
+ * device actually does is the D62 shape — a control nobody can predict.
7875
7886
  */
7876
7887
  var RecordingStorageModeSchema = _enum([
7877
7888
  "off",
7878
7889
  "events",
7879
- "continuous"
7890
+ "continuous",
7891
+ "on-device-decision"
7880
7892
  ]);
7881
7893
  /**
7882
7894
  * Le macro classi che possono aprire una finestra di registrazione — le stesse
@@ -7926,22 +7938,7 @@ var RecordingTriggersSchema = object({
7926
7938
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
7927
7939
  * registrare.
7928
7940
  */
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()
7941
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
7945
7942
  });
7946
7943
  /**
7947
7944
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -7971,13 +7968,28 @@ var RecordingBandSchema = object({
7971
7968
  end: string().regex(HHMM),
7972
7969
  mode: RecordingBandModeSchema,
7973
7970
  triggers: RecordingBandTriggersSchema.optional(),
7971
+ /**
7972
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7973
+ *
7974
+ * It was the retroactive KEEP bound — which already-written segments survive
7975
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7976
+ * broker could serve, or the gate would delete the seconds the ring had just
7977
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7978
+ * expression of the broker's retention, in different units, in a different
7979
+ * addon, with an invariant the operator had to maintain by hand. The keep
7980
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7981
+ * left to configure here.
7982
+ *
7983
+ * The key survives in the SHAPE so a config written before that record still
7984
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7985
+ * strict, so simply deleting it would strip an operator's value in silence on
7986
+ * the next save (the failure D380 came one commit from shipping). Nothing
7987
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7988
+ */
7974
7989
  preBufferSec: number().min(0).optional(),
7975
7990
  postBufferSec: number().min(0).optional()
7976
7991
  });
7977
- ({
7978
- preBufferSec: 15,
7979
- postBufferSec: 30
7980
- }).postBufferSec * 1e3;
7992
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7981
7993
  /**
7982
7994
  * Per-device retention overrides. Every field is optional; an unset or `0`
7983
7995
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -8025,8 +8037,29 @@ var RecordingConfigSchema = object({
8025
8037
  * "off" is the absence of a covering band, never a band value.
8026
8038
  */
8027
8039
  bands: array(RecordingBandSchema).default([]),
8040
+ /**
8041
+ * THE device-decided intent: record for as long as the camera itself raises
8042
+ * `recording-signal` (`active: true` while the device is in function — a
8043
+ * robot that cleans). AUTHORED, unlike `mode`, and the only authored
8044
+ * recording intent that is not a band.
8045
+ *
8046
+ * It carries NO schedule on purpose. A band is an HOUR, and this feature has
8047
+ * no hour to program: the device decides. What it costs the operator is one
8048
+ * flag — "this camera can record on its own" — and what it buys is the same
8049
+ * hold/release the recorder already implements (D371, `holdTrigger` /
8050
+ * `releaseTrigger`): the window opens on the rise, stays open for the whole
8051
+ * job however long it is, and closes one pad after the fall.
8052
+ *
8053
+ * EXCLUSIVE with `bands` (below): two authorities deciding when the same
8054
+ * camera records is the D62 failure. `off` remains `enabled: false`, so an
8055
+ * operator switching this camera off is REPORTED off, never as broken.
8056
+ */
8057
+ deviceDecision: boolean().optional(),
8028
8058
  retention: RecordingRetentionSchema.optional()
8029
- }).strict();
8059
+ }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
8060
+ message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
8061
+ path: ["bands"]
8062
+ });
8030
8063
  /**
8031
8064
  * Entity-relocation job state (storage entity-routing spec, Phase 4).
8032
8065
  *
@@ -20691,11 +20724,7 @@ var CameraAudioStatusSchema = object({
20691
20724
  });
20692
20725
  /** Recording block — null when no recording cap is active for this device. */
20693
20726
  var CameraRecordingStatusSchema = object({
20694
- mode: _enum([
20695
- "off",
20696
- "continuous",
20697
- "events"
20698
- ]),
20727
+ mode: RecordingStorageModeSchema,
20699
20728
  active: boolean(),
20700
20729
  storageBytes: number()
20701
20730
  });
@@ -27162,11 +27191,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27162
27191
  var RecordingStatusSchema = object({
27163
27192
  deviceId: number(),
27164
27193
  enabled: boolean(),
27165
- activeMode: _enum([
27166
- "off",
27167
- "continuous",
27168
- "events"
27169
- ]),
27194
+ /** THE derived storage mode, from the one definition
27195
+ * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
27196
+ * `on-device-decision` could have reached the recorder and not the status. */
27197
+ activeMode: RecordingStorageModeSchema,
27170
27198
  nodeId: string(),
27171
27199
  storageBytes: number()
27172
27200
  });
@@ -7866,17 +7866,29 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
7866
7866
  /**
7867
7867
  * DERIVED per-camera storage summary — the single field cheap consumers read
7868
7868
  * (the viewer's status dot, the camera list) instead of walking `bands`:
7869
- * - `off` — no band covers the camera (or it is disabled).
7870
- * - `events` — every band records around triggers only.
7871
- * - `continuous` — at least one band records continuously.
7872
- *
7873
- * NEVER authored: the recorder stamps it from the authoritative `bands` on
7874
- * every save (`activeModeForConfig`). Writing it has no effect.
7869
+ * - `off` — no band covers the camera (or it is disabled).
7870
+ * - `events` — every band records around triggers only.
7871
+ * - `continuous` — at least one band records continuously.
7872
+ * - `on-device-decision`— the DEVICE decides: recording runs for as long as the
7873
+ * camera raises its own `recording-signal` level (a robot that cleans). There
7874
+ * is no schedule to author, because there is no hour to program — see
7875
+ * {@link RecordingConfigSchema}`.deviceDecision`.
7876
+ *
7877
+ * NEVER authored: the recorder stamps it from the authoritative intent
7878
+ * (`bands` + `deviceDecision`) on every save (`activeModeForConfig`). Writing it
7879
+ * has no effect.
7880
+ *
7881
+ * `on-device-decision` is named for WHO decides, not for how the recording is
7882
+ * requested. `on-demand` was rejected: in this repo's vocabulary a "demand" is
7883
+ * something the operator makes (the live gate is the recorder's own "demand
7884
+ * window"), and a knob whose name suggests the operator starts it while the
7885
+ * device actually does is the D62 shape — a control nobody can predict.
7875
7886
  */
7876
7887
  var RecordingStorageModeSchema = _enum([
7877
7888
  "off",
7878
7889
  "events",
7879
- "continuous"
7890
+ "continuous",
7891
+ "on-device-decision"
7880
7892
  ]);
7881
7893
  /**
7882
7894
  * Le macro classi che possono aprire una finestra di registrazione — le stesse
@@ -7926,22 +7938,7 @@ var RecordingTriggersSchema = object({
7926
7938
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
7927
7939
  * registrare.
7928
7940
  */
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()
7941
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
7945
7942
  });
7946
7943
  /**
7947
7944
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -7971,13 +7968,28 @@ var RecordingBandSchema = object({
7971
7968
  end: string().regex(HHMM),
7972
7969
  mode: RecordingBandModeSchema,
7973
7970
  triggers: RecordingBandTriggersSchema.optional(),
7971
+ /**
7972
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7973
+ *
7974
+ * It was the retroactive KEEP bound — which already-written segments survive
7975
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7976
+ * broker could serve, or the gate would delete the seconds the ring had just
7977
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7978
+ * expression of the broker's retention, in different units, in a different
7979
+ * addon, with an invariant the operator had to maintain by hand. The keep
7980
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7981
+ * left to configure here.
7982
+ *
7983
+ * The key survives in the SHAPE so a config written before that record still
7984
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7985
+ * strict, so simply deleting it would strip an operator's value in silence on
7986
+ * the next save (the failure D380 came one commit from shipping). Nothing
7987
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7988
+ */
7974
7989
  preBufferSec: number().min(0).optional(),
7975
7990
  postBufferSec: number().min(0).optional()
7976
7991
  });
7977
- ({
7978
- preBufferSec: 15,
7979
- postBufferSec: 30
7980
- }).postBufferSec * 1e3;
7992
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7981
7993
  /**
7982
7994
  * Per-device retention overrides. Every field is optional; an unset or `0`
7983
7995
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -8025,8 +8037,29 @@ var RecordingConfigSchema = object({
8025
8037
  * "off" is the absence of a covering band, never a band value.
8026
8038
  */
8027
8039
  bands: array(RecordingBandSchema).default([]),
8040
+ /**
8041
+ * THE device-decided intent: record for as long as the camera itself raises
8042
+ * `recording-signal` (`active: true` while the device is in function — a
8043
+ * robot that cleans). AUTHORED, unlike `mode`, and the only authored
8044
+ * recording intent that is not a band.
8045
+ *
8046
+ * It carries NO schedule on purpose. A band is an HOUR, and this feature has
8047
+ * no hour to program: the device decides. What it costs the operator is one
8048
+ * flag — "this camera can record on its own" — and what it buys is the same
8049
+ * hold/release the recorder already implements (D371, `holdTrigger` /
8050
+ * `releaseTrigger`): the window opens on the rise, stays open for the whole
8051
+ * job however long it is, and closes one pad after the fall.
8052
+ *
8053
+ * EXCLUSIVE with `bands` (below): two authorities deciding when the same
8054
+ * camera records is the D62 failure. `off` remains `enabled: false`, so an
8055
+ * operator switching this camera off is REPORTED off, never as broken.
8056
+ */
8057
+ deviceDecision: boolean().optional(),
8028
8058
  retention: RecordingRetentionSchema.optional()
8029
- }).strict();
8059
+ }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
8060
+ message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
8061
+ path: ["bands"]
8062
+ });
8030
8063
  /**
8031
8064
  * Entity-relocation job state (storage entity-routing spec, Phase 4).
8032
8065
  *
@@ -20691,11 +20724,7 @@ var CameraAudioStatusSchema = object({
20691
20724
  });
20692
20725
  /** Recording block — null when no recording cap is active for this device. */
20693
20726
  var CameraRecordingStatusSchema = object({
20694
- mode: _enum([
20695
- "off",
20696
- "continuous",
20697
- "events"
20698
- ]),
20727
+ mode: RecordingStorageModeSchema,
20699
20728
  active: boolean(),
20700
20729
  storageBytes: number()
20701
20730
  });
@@ -27162,11 +27191,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27162
27191
  var RecordingStatusSchema = object({
27163
27192
  deviceId: number(),
27164
27193
  enabled: boolean(),
27165
- activeMode: _enum([
27166
- "off",
27167
- "continuous",
27168
- "events"
27169
- ]),
27194
+ /** THE derived storage mode, from the one definition
27195
+ * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
27196
+ * `on-device-decision` could have reached the recorder and not the status. */
27197
+ activeMode: RecordingStorageModeSchema,
27170
27198
  nodeId: string(),
27171
27199
  storageBytes: number()
27172
27200
  });
@@ -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-CRZZaJqB.js");
5
+ const require_dist = require("../dist-D-r2DHbc.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-BxbhH1L5.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability } from "../dist-qvo4-OTG.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.75",
3
+ "version": "1.2.77",
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",