@camstack/addon-provider-onvif 1.2.74 → 1.2.75

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/addon.js CHANGED
@@ -7848,17 +7848,29 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
7848
7848
  /**
7849
7849
  * DERIVED per-camera storage summary — the single field cheap consumers read
7850
7850
  * (the viewer's status dot, the camera list) instead of walking `bands`:
7851
- * - `off` — no band covers the camera (or it is disabled).
7852
- * - `events` — every band records around triggers only.
7853
- * - `continuous` — at least one band records continuously.
7854
- *
7855
- * NEVER authored: the recorder stamps it from the authoritative `bands` on
7856
- * every save (`activeModeForConfig`). Writing it has no effect.
7851
+ * - `off` — no band covers the camera (or it is disabled).
7852
+ * - `events` — every band records around triggers only.
7853
+ * - `continuous` — at least one band records continuously.
7854
+ * - `on-device-decision`— the DEVICE decides: recording runs for as long as the
7855
+ * camera raises its own `recording-signal` level (a robot that cleans). There
7856
+ * is no schedule to author, because there is no hour to program — see
7857
+ * {@link RecordingConfigSchema}`.deviceDecision`.
7858
+ *
7859
+ * NEVER authored: the recorder stamps it from the authoritative intent
7860
+ * (`bands` + `deviceDecision`) on every save (`activeModeForConfig`). Writing it
7861
+ * has no effect.
7862
+ *
7863
+ * `on-device-decision` is named for WHO decides, not for how the recording is
7864
+ * requested. `on-demand` was rejected: in this repo's vocabulary a "demand" is
7865
+ * something the operator makes (the live gate is the recorder's own "demand
7866
+ * window"), and a knob whose name suggests the operator starts it while the
7867
+ * device actually does is the D62 shape — a control nobody can predict.
7857
7868
  */
7858
7869
  var RecordingStorageModeSchema = _enum([
7859
7870
  "off",
7860
7871
  "events",
7861
- "continuous"
7872
+ "continuous",
7873
+ "on-device-decision"
7862
7874
  ]);
7863
7875
  /**
7864
7876
  * Le macro classi che possono aprire una finestra di registrazione — le stesse
@@ -7908,22 +7920,7 @@ var RecordingTriggersSchema = object({
7908
7920
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
7909
7921
  * registrare.
7910
7922
  */
7911
- sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
7912
- /**
7913
- * La camera registra per tutta la durata del SEGNALE che lei stessa
7914
- * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
7915
- * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
7916
- * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
7917
- * caduta, così una pulizia di quaranta minuti è UNA clip.
7918
- *
7919
- * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
7920
- * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
7921
- * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
7922
- * segnale mai abbassato (un evento perso) non può tenere aperta una
7923
- * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
7924
- * (`holdTrigger` / `releaseTrigger`).
7925
- */
7926
- deviceSignal: boolean().optional()
7923
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
7927
7924
  });
7928
7925
  /**
7929
7926
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -8007,8 +8004,29 @@ var RecordingConfigSchema = object({
8007
8004
  * "off" is the absence of a covering band, never a band value.
8008
8005
  */
8009
8006
  bands: array(RecordingBandSchema).default([]),
8007
+ /**
8008
+ * THE device-decided intent: record for as long as the camera itself raises
8009
+ * `recording-signal` (`active: true` while the device is in function — a
8010
+ * robot that cleans). AUTHORED, unlike `mode`, and the only authored
8011
+ * recording intent that is not a band.
8012
+ *
8013
+ * It carries NO schedule on purpose. A band is an HOUR, and this feature has
8014
+ * no hour to program: the device decides. What it costs the operator is one
8015
+ * flag — "this camera can record on its own" — and what it buys is the same
8016
+ * hold/release the recorder already implements (D371, `holdTrigger` /
8017
+ * `releaseTrigger`): the window opens on the rise, stays open for the whole
8018
+ * job however long it is, and closes one pad after the fall.
8019
+ *
8020
+ * EXCLUSIVE with `bands` (below): two authorities deciding when the same
8021
+ * camera records is the D62 failure. `off` remains `enabled: false`, so an
8022
+ * operator switching this camera off is REPORTED off, never as broken.
8023
+ */
8024
+ deviceDecision: boolean().optional(),
8010
8025
  retention: RecordingRetentionSchema.optional()
8011
- }).strict();
8026
+ }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
8027
+ message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
8028
+ path: ["bands"]
8029
+ });
8012
8030
  /**
8013
8031
  * Entity-relocation job state (storage entity-routing spec, Phase 4).
8014
8032
  *
@@ -20737,11 +20755,7 @@ var CameraAudioStatusSchema = object({
20737
20755
  });
20738
20756
  /** Recording block — null when no recording cap is active for this device. */
20739
20757
  var CameraRecordingStatusSchema = object({
20740
- mode: _enum([
20741
- "off",
20742
- "continuous",
20743
- "events"
20744
- ]),
20758
+ mode: RecordingStorageModeSchema,
20745
20759
  active: boolean(),
20746
20760
  storageBytes: number()
20747
20761
  });
@@ -27293,11 +27307,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27293
27307
  var RecordingStatusSchema = object({
27294
27308
  deviceId: number(),
27295
27309
  enabled: boolean(),
27296
- activeMode: _enum([
27297
- "off",
27298
- "continuous",
27299
- "events"
27300
- ]),
27310
+ /** THE derived storage mode, from the one definition
27311
+ * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
27312
+ * `on-device-decision` could have reached the recorder and not the status. */
27313
+ activeMode: RecordingStorageModeSchema,
27301
27314
  nodeId: string(),
27302
27315
  storageBytes: number()
27303
27316
  });
package/dist/addon.mjs CHANGED
@@ -7849,17 +7849,29 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
7849
7849
  /**
7850
7850
  * DERIVED per-camera storage summary — the single field cheap consumers read
7851
7851
  * (the viewer's status dot, the camera list) instead of walking `bands`:
7852
- * - `off` — no band covers the camera (or it is disabled).
7853
- * - `events` — every band records around triggers only.
7854
- * - `continuous` — at least one band records continuously.
7855
- *
7856
- * NEVER authored: the recorder stamps it from the authoritative `bands` on
7857
- * every save (`activeModeForConfig`). Writing it has no effect.
7852
+ * - `off` — no band covers the camera (or it is disabled).
7853
+ * - `events` — every band records around triggers only.
7854
+ * - `continuous` — at least one band records continuously.
7855
+ * - `on-device-decision`— the DEVICE decides: recording runs for as long as the
7856
+ * camera raises its own `recording-signal` level (a robot that cleans). There
7857
+ * is no schedule to author, because there is no hour to program — see
7858
+ * {@link RecordingConfigSchema}`.deviceDecision`.
7859
+ *
7860
+ * NEVER authored: the recorder stamps it from the authoritative intent
7861
+ * (`bands` + `deviceDecision`) on every save (`activeModeForConfig`). Writing it
7862
+ * has no effect.
7863
+ *
7864
+ * `on-device-decision` is named for WHO decides, not for how the recording is
7865
+ * requested. `on-demand` was rejected: in this repo's vocabulary a "demand" is
7866
+ * something the operator makes (the live gate is the recorder's own "demand
7867
+ * window"), and a knob whose name suggests the operator starts it while the
7868
+ * device actually does is the D62 shape — a control nobody can predict.
7858
7869
  */
7859
7870
  var RecordingStorageModeSchema = _enum([
7860
7871
  "off",
7861
7872
  "events",
7862
- "continuous"
7873
+ "continuous",
7874
+ "on-device-decision"
7863
7875
  ]);
7864
7876
  /**
7865
7877
  * Le macro classi che possono aprire una finestra di registrazione — le stesse
@@ -7909,22 +7921,7 @@ var RecordingTriggersSchema = object({
7909
7921
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
7910
7922
  * registrare.
7911
7923
  */
7912
- sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
7913
- /**
7914
- * La camera registra per tutta la durata del SEGNALE che lei stessa
7915
- * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
7916
- * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
7917
- * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
7918
- * caduta, così una pulizia di quaranta minuti è UNA clip.
7919
- *
7920
- * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
7921
- * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
7922
- * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
7923
- * segnale mai abbassato (un evento perso) non può tenere aperta una
7924
- * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
7925
- * (`holdTrigger` / `releaseTrigger`).
7926
- */
7927
- deviceSignal: boolean().optional()
7924
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
7928
7925
  });
7929
7926
  /**
7930
7927
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -8008,8 +8005,29 @@ var RecordingConfigSchema = object({
8008
8005
  * "off" is the absence of a covering band, never a band value.
8009
8006
  */
8010
8007
  bands: array(RecordingBandSchema).default([]),
8008
+ /**
8009
+ * THE device-decided intent: record for as long as the camera itself raises
8010
+ * `recording-signal` (`active: true` while the device is in function — a
8011
+ * robot that cleans). AUTHORED, unlike `mode`, and the only authored
8012
+ * recording intent that is not a band.
8013
+ *
8014
+ * It carries NO schedule on purpose. A band is an HOUR, and this feature has
8015
+ * no hour to program: the device decides. What it costs the operator is one
8016
+ * flag — "this camera can record on its own" — and what it buys is the same
8017
+ * hold/release the recorder already implements (D371, `holdTrigger` /
8018
+ * `releaseTrigger`): the window opens on the rise, stays open for the whole
8019
+ * job however long it is, and closes one pad after the fall.
8020
+ *
8021
+ * EXCLUSIVE with `bands` (below): two authorities deciding when the same
8022
+ * camera records is the D62 failure. `off` remains `enabled: false`, so an
8023
+ * operator switching this camera off is REPORTED off, never as broken.
8024
+ */
8025
+ deviceDecision: boolean().optional(),
8011
8026
  retention: RecordingRetentionSchema.optional()
8012
- }).strict();
8027
+ }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
8028
+ message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
8029
+ path: ["bands"]
8030
+ });
8013
8031
  /**
8014
8032
  * Entity-relocation job state (storage entity-routing spec, Phase 4).
8015
8033
  *
@@ -20738,11 +20756,7 @@ var CameraAudioStatusSchema = object({
20738
20756
  });
20739
20757
  /** Recording block — null when no recording cap is active for this device. */
20740
20758
  var CameraRecordingStatusSchema = object({
20741
- mode: _enum([
20742
- "off",
20743
- "continuous",
20744
- "events"
20745
- ]),
20759
+ mode: RecordingStorageModeSchema,
20746
20760
  active: boolean(),
20747
20761
  storageBytes: number()
20748
20762
  });
@@ -27294,11 +27308,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27294
27308
  var RecordingStatusSchema = object({
27295
27309
  deviceId: number(),
27296
27310
  enabled: boolean(),
27297
- activeMode: _enum([
27298
- "off",
27299
- "continuous",
27300
- "events"
27301
- ]),
27311
+ /** THE derived storage mode, from the one definition
27312
+ * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
27313
+ * `on-device-decision` could have reached the recorder and not the status. */
27314
+ activeMode: RecordingStorageModeSchema,
27302
27315
  nodeId: string(),
27303
27316
  storageBytes: number()
27304
27317
  });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-onvif",
3
- "version": "1.2.74",
3
+ "version": "1.2.75",
4
4
  "description": "ONVIF camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",