camstack 1.2.167 → 1.2.168

package/dist/{chunk-MXBN3QZ5.js → chunk-AWHVFK2L.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-BDR76Ykr.mjs
+// ../types/dist/sleep-B1y0Fo1U.mjs
 var AUDIO_CHUNK_FORMATS = [
   "f32le",
   "pcmu",
@@ -15384,7 +15384,7 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
 }
 
-// ../types/dist/canonical-hash-Ch5bSjFG.mjs
+// ../types/dist/canonical-hash-DBkl8q6V.mjs
 import { createHash } from "crypto";
 var DEFAULT_MAX_UNIT_BYTES = 16 * 1024 * 1024;
 
@@ -38683,14 +38683,36 @@ var privacyMaskCapability = {
   *  whether persisting is worth a SQLite commit. */
   volatileStateFields: ["lastFetchedAt"]
 };
+var PtzPresetFunctionSchema = external_exports.enum([
+  "home",
+  "day-mode",
+  "night-mode",
+  "day-night-auto",
+  "set-limits",
+  "save-limits",
+  "reboot",
+  "osd-menu"
+]);
 var PtzPresetSchema = external_exports.object({
   id: external_exports.string(),
-  name: external_exports.string()
+  name: external_exports.string(),
+  /**
+  * The firmware function this id performs, when the provider KNOWS the id is
+  * reserved. `null` = an ordinary stored position, OR a reserved id this
+  * provider does not recognise -- the two are told apart by `writable`.
+  */
+  fn: PtzPresetFunctionSchema.nullable(),
+  /**
+  * Whether `savePreset` / `deletePreset` may target this id. A provider sets
+  * it false only for a band it KNOWS is reserved; where the firmware is not
+  * documented it stays true and a refusal comes from the camera, named.
+  */
+  writable: external_exports.boolean()
 });
 var PtzPositionSchema = external_exports.object({
-  pan: external_exports.number(),
-  tilt: external_exports.number(),
-  zoom: external_exports.number()
+  pan: external_exports.number().nullable(),
+  tilt: external_exports.number().nullable(),
+  zoom: external_exports.number().nullable()
 });
 var PtzMoveCommandSchema = external_exports.object({
   pan: external_exports.number().optional(),
@@ -38708,7 +38730,42 @@ var PtzOptionsSchema = external_exports.object({
   maxPresets: external_exports.number().optional(),
   /** Whether the camera exposes a controllable autofocus toggle
   *  (boolean `hasX` per the getOptions availability convention). */
-  hasAutofocus: external_exports.boolean()
+  hasAutofocus: external_exports.boolean(),
+  /**
+  * How many distinct speeds this camera's NATIVE scale offers.
+  *
+  * The cap's `speed` is normalized 0..1 and each provider maps it down --
+  * Baichuan 1..63, Dahua 1..8, ISAPI's percentage -100..100. The normalized
+  * value hides how coarse that really is: asking an amcrest for `0.37` is
+  * meaningless, because it has eight steps and three of them round to the
+  * same one. A loop that tunes its own gain has to know the granularity of
+  * the knob it is turning.
+  *
+  * `null` = the driver does not know, or the scale is continuous (ONVIF takes
+  * a float). Never a made-up number.
+  */
+  speedSteps: external_exports.number().int().positive().nullable(),
+  /**
+  * How long ONE `move` pulse runs on this driver, ms.
+  *
+  * `move` is a self-terminating burst everywhere, but every provider hardcoded
+  * its own duration in private -- 200 reolink, 350 amcrest, 500 hikvision,
+  * 1000 onvif -- so no caller could read it. It is the DENOMINATOR of "how far
+  * did the head travel per pulse": without it a measured displacement has no
+  * gain to be divided into.
+  *
+  * `null` = the driver cannot say.
+  */
+  moveImpulseMs: external_exports.number().int().positive().nullable()
+});
+var PtzHomePresetSchema = external_exports.object({
+  presetId: external_exports.string().nullable(),
+  source: external_exports.enum([
+    "operator",
+    "firmware",
+    "native",
+    "none"
+  ])
 });
 var ptzCapability = {
   name: "ptz",
@@ -38749,7 +38806,25 @@ var ptzCapability = {
       auth: "admin"
     }),
     getOptions: method(external_exports.object({ deviceId: external_exports.number() }), PtzOptionsSchema),
+    /**
+    * Move to the camera's configured home preset. THROWS when
+    * `getHomePreset()` resolves to `none` -- a head that did not move must
+    * never look like a head that went home.
+    */
     goHome: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.void(), { kind: "mutation" }),
+    /** Which preset `goHome` targets, and who decided it. */
+    getHomePreset: method(external_exports.object({ deviceId: external_exports.number() }), PtzHomePresetSchema),
+    /**
+    * Pin the home preset for this camera. `null` clears the operator's choice
+    * and falls back to whatever the firmware names, or to `none`.
+    */
+    setHomePreset: method(external_exports.object({
+      deviceId: external_exports.number(),
+      presetId: external_exports.string().nullable()
+    }), external_exports.void(), {
+      kind: "mutation",
+      auth: "admin"
+    }),
     /**
     * Pull the current PTZ position. Redundant with the auto-injected
     * `getStatus` method (see `status` below); kept for callers that
@@ -46173,6 +46248,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "delete"
   },
+  "ptz.getHomePreset": {
+    capName: "ptz",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "ptz.getOptions": {
     capName: "ptz",
     capScope: "device",
@@ -46221,6 +46302,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "ptz.setHomePreset": {
+    capName: "ptz",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
   "ptz.stop": {
     capName: "ptz",
     capScope: "device",
@@ -49394,6 +49481,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "ptz.getHomePreset": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "ptz.getOptions": [{
     name: "deviceId",
     form: "single",
@@ -49434,6 +49526,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "ptz.setHomePreset": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "ptz.stop": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-MXBN3QZ5.js";
+} from "./chunk-AWHVFK2L.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-AYZZUJZ6.js");
+  await import("./launcher-PSI434KW.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-AYZZUJZ6.js");
+  await import("./launcher-PSI434KW.js");
 }
 
 // src/commands/setup.ts
@@ -1140,7 +1140,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-7R72RWAY.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-BCCPZRN4.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-7R72RWAY.js → discover-BCCPZRN4.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-MXBN3QZ5.js";
+} from "./chunk-AWHVFK2L.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-AYZZUJZ6.js → launcher-PSI434KW.js}

@@ -23742,9 +23742,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-DluLUTzR.js
-var require_dist_DluLUTzR = __commonJS({
-  "../system/dist/dist-DluLUTzR.js"(exports) {
+// ../system/dist/dist-BW7x4kAI.js
+var require_dist_BW7x4kAI = __commonJS({
+  "../system/dist/dist-BW7x4kAI.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -49358,14 +49358,36 @@ var require_dist_DluLUTzR = __commonJS({
       *  whether persisting is worth a SQLite commit. */
       volatileStateFields: ["lastFetchedAt"]
     };
+    var PtzPresetFunctionSchema = zod.z.enum([
+      "home",
+      "day-mode",
+      "night-mode",
+      "day-night-auto",
+      "set-limits",
+      "save-limits",
+      "reboot",
+      "osd-menu"
+    ]);
     var PtzPresetSchema = zod.z.object({
       id: zod.z.string(),
-      name: zod.z.string()
+      name: zod.z.string(),
+      /**
+      * The firmware function this id performs, when the provider KNOWS the id is
+      * reserved. `null` = an ordinary stored position, OR a reserved id this
+      * provider does not recognise -- the two are told apart by `writable`.
+      */
+      fn: PtzPresetFunctionSchema.nullable(),
+      /**
+      * Whether `savePreset` / `deletePreset` may target this id. A provider sets
+      * it false only for a band it KNOWS is reserved; where the firmware is not
+      * documented it stays true and a refusal comes from the camera, named.
+      */
+      writable: zod.z.boolean()
     });
     var PtzPositionSchema = zod.z.object({
-      pan: zod.z.number(),
-      tilt: zod.z.number(),
-      zoom: zod.z.number()
+      pan: zod.z.number().nullable(),
+      tilt: zod.z.number().nullable(),
+      zoom: zod.z.number().nullable()
     });
     var PtzMoveCommandSchema = zod.z.object({
       pan: zod.z.number().optional(),
@@ -49383,7 +49405,42 @@ var require_dist_DluLUTzR = __commonJS({
       maxPresets: zod.z.number().optional(),
       /** Whether the camera exposes a controllable autofocus toggle
       *  (boolean `hasX` per the getOptions availability convention). */
-      hasAutofocus: zod.z.boolean()
+      hasAutofocus: zod.z.boolean(),
+      /**
+      * How many distinct speeds this camera's NATIVE scale offers.
+      *
+      * The cap's `speed` is normalized 0..1 and each provider maps it down --
+      * Baichuan 1..63, Dahua 1..8, ISAPI's percentage -100..100. The normalized
+      * value hides how coarse that really is: asking an amcrest for `0.37` is
+      * meaningless, because it has eight steps and three of them round to the
+      * same one. A loop that tunes its own gain has to know the granularity of
+      * the knob it is turning.
+      *
+      * `null` = the driver does not know, or the scale is continuous (ONVIF takes
+      * a float). Never a made-up number.
+      */
+      speedSteps: zod.z.number().int().positive().nullable(),
+      /**
+      * How long ONE `move` pulse runs on this driver, ms.
+      *
+      * `move` is a self-terminating burst everywhere, but every provider hardcoded
+      * its own duration in private -- 200 reolink, 350 amcrest, 500 hikvision,
+      * 1000 onvif -- so no caller could read it. It is the DENOMINATOR of "how far
+      * did the head travel per pulse": without it a measured displacement has no
+      * gain to be divided into.
+      *
+      * `null` = the driver cannot say.
+      */
+      moveImpulseMs: zod.z.number().int().positive().nullable()
+    });
+    var PtzHomePresetSchema = zod.z.object({
+      presetId: zod.z.string().nullable(),
+      source: zod.z.enum([
+        "operator",
+        "firmware",
+        "native",
+        "none"
+      ])
     });
     var ptzCapability = {
       name: "ptz",
@@ -49424,7 +49481,25 @@ var require_dist_DluLUTzR = __commonJS({
           auth: "admin"
         }),
         getOptions: method(zod.z.object({ deviceId: zod.z.number() }), PtzOptionsSchema),
+        /**
+        * Move to the camera's configured home preset. THROWS when
+        * `getHomePreset()` resolves to `none` -- a head that did not move must
+        * never look like a head that went home.
+        */
         goHome: method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), { kind: "mutation" }),
+        /** Which preset `goHome` targets, and who decided it. */
+        getHomePreset: method(zod.z.object({ deviceId: zod.z.number() }), PtzHomePresetSchema),
+        /**
+        * Pin the home preset for this camera. `null` clears the operator's choice
+        * and falls back to whatever the firmware names, or to `none`.
+        */
+        setHomePreset: method(zod.z.object({
+          deviceId: zod.z.number(),
+          presetId: zod.z.string().nullable()
+        }), zod.z.void(), {
+          kind: "mutation",
+          auth: "admin"
+        }),
         /**
         * Pull the current PTZ position. Redundant with the auto-injected
         * `getStatus` method (see `status` below); kept for callers that
@@ -57678,6 +57753,12 @@ var require_dist_DluLUTzR = __commonJS({
         addonId: null,
         access: "delete"
       },
+      "ptz.getHomePreset": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "ptz.getOptions": {
         capName: "ptz",
         capScope: "device",
@@ -57726,6 +57807,12 @@ var require_dist_DluLUTzR = __commonJS({
         addonId: null,
         access: "create"
       },
+      "ptz.setHomePreset": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "create"
+      },
       "ptz.stop": {
         capName: "ptz",
         capScope: "device",
@@ -60899,6 +60986,11 @@ var require_dist_DluLUTzR = __commonJS({
         form: "single",
         optional: false
       }],
+      "ptz.getHomePreset": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.getOptions": [{
         name: "deviceId",
         form: "single",
@@ -60939,6 +61031,11 @@ var require_dist_DluLUTzR = __commonJS({
         form: "single",
         optional: false
       }],
+      "ptz.setHomePreset": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.stop": [{
         name: "deviceId",
         form: "single",
@@ -62966,7 +63063,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -63785,7 +63882,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -63879,7 +63976,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -64776,11 +64873,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-VcrnwKN0.js
-var require_retired_settings_keys_VcrnwKN0 = __commonJS({
-  "../system/dist/retired-settings-keys-VcrnwKN0.js"(exports) {
+// ../system/dist/retired-settings-keys-CeaYCDU4.js
+var require_retired_settings_keys_CeaYCDU4 = __commonJS({
+  "../system/dist/retired-settings-keys-CeaYCDU4.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -65060,9 +65157,9 @@ var require_retired_settings_keys_VcrnwKN0 = __commonJS({
   }
 });
 
-// ../types/dist/canonical-hash-9lydiEzx.js
-var require_canonical_hash_9lydiEzx = __commonJS({
-  "../types/dist/canonical-hash-9lydiEzx.js"(exports) {
+// ../types/dist/canonical-hash-CZ2JqJc3.js
+var require_canonical_hash_CZ2JqJc3 = __commonJS({
+  "../types/dist/canonical-hash-CZ2JqJc3.js"(exports) {
     "use strict";
     var node_crypto = __require("crypto");
     var AUDIO_ENCODER_BY_CODEC = {
@@ -65114,7 +65211,27 @@ var require_canonical_hash_9lydiEzx = __commonJS({
       args.push("-i", input.url);
       return args;
     }
-    function buildVideoFilterArgs(scale, outputArgs) {
+    function resolveStreamMaps(selection) {
+      const graph = selection.filterGraph;
+      if (graph) return {
+        video: `[${graph.videoOutLabel}]`,
+        audio: graph.audioOutLabel ? `[${graph.audioOutLabel}]` : "0:a:0?"
+      };
+      if (selection.extraInputs?.length) return {
+        video: "0:v:0",
+        audio: "0:a:0?"
+      };
+      return {
+        video: null,
+        audio: null
+      };
+    }
+    function buildVideoFilterArgs(scale, outputArgs, filterGraph) {
+      if (filterGraph) {
+        if (scale) throw new Error("FfmpegInvocation: video.scale cannot be combined with a filter graph \u2014 scale inside the graph instead (the -vf would feed an output the graph already feeds)");
+        if (outputArgs.some((a) => a === "-vf")) throw new Error("FfmpegInvocation: outputArgs carries a -vf while a filter graph feeds the same output \u2014 fold the filter into the graph");
+        return [];
+      }
       if (!scale) return [];
       if (outputArgs.some((a) => a === "-vf")) return [];
       if (scale.mode === "exact") return ["-vf", `scale=${scale.width}:${scale.height}`];
@@ -65136,14 +65253,17 @@ var require_canonical_hash_9lydiEzx = __commonJS({
         `${bufsize}k`
       ];
     }
-    function buildVideoArgs(video, outputArgs) {
-      if (video.kind === "copy") return [
-        "-c:v",
-        "copy",
-        ...video.bitstreamFilter ? ["-bsf:v", video.bitstreamFilter] : []
-      ];
+    function buildVideoArgs(video, outputArgs, filterGraph) {
+      if (video.kind === "copy") {
+        if (filterGraph) throw new Error("FfmpegInvocation: a filter graph produces a NEW picture, so video.kind must be `encode`");
+        return [
+          "-c:v",
+          "copy",
+          ...video.bitstreamFilter ? ["-bsf:v", video.bitstreamFilter] : []
+        ];
+      }
       const args = [
-        ...buildVideoFilterArgs(video.scale, outputArgs),
+        ...buildVideoFilterArgs(video.scale, outputArgs, filterGraph),
         "-c:v",
         video.encoder
       ];
@@ -65234,14 +65354,23 @@ var require_canonical_hash_9lydiEzx = __commonJS({
       ];
     }
     function buildFfmpegArgs(inv) {
-      const head = [...logBannerArgs(inv.logLevel), ...buildInputArgs(inv.input, inv.decodeHwAccel)];
+      const graph = inv.filterGraph ?? null;
+      const head = [
+        ...logBannerArgs(inv.logLevel),
+        ...buildInputArgs(inv.input, inv.decodeHwAccel),
+        ...(inv.extraInputs ?? []).flatMap((extra) => buildInputArgs(extra, inv.decodeHwAccel)),
+        ...graph ? ["-filter_complex", graph.graph] : []
+      ];
       const threadArgs = inv.threadCount > 0 ? ["-threads", String(inv.threadCount)] : [];
+      const maps = resolveStreamMaps(inv);
+      const videoMapArgs = maps.video ? ["-map", maps.video] : [];
+      const audioMapArgs = maps.audio ? ["-map", maps.audio] : [];
       if (inv.sink.kind === "rtp-outputs") {
         const videoLeg = inv.sink.video ? [
           "-an",
           "-map",
-          "0:v:0",
-          ...buildVideoArgs(inv.video, inv.outputArgs),
+          maps.video ?? "0:v:0",
+          ...buildVideoArgs(inv.video, inv.outputArgs, graph),
           ...threadArgs,
           ...inv.outputArgs,
           ...buildRtpOutputArgs(inv.sink.video)
@@ -65249,7 +65378,7 @@ var require_canonical_hash_9lydiEzx = __commonJS({
         const audioLeg = inv.sink.audio ? [
           "-vn",
           "-map",
-          "0:a:0?",
+          maps.audio ?? "0:a:0?",
           ...buildAudioArgs(inv.audio),
           ...buildRtpOutputArgs(inv.sink.audio)
         ] : [];
@@ -65259,15 +65388,17 @@ var require_canonical_hash_9lydiEzx = __commonJS({
           ...audioLeg
         ];
       }
+      const mutedAudio = isElementaryVideoSink(inv.sink) || inv.audio.kind === "none";
       const audioArgs = isElementaryVideoSink(inv.sink) ? ["-an"] : buildAudioArgs(inv.audio);
-      const sinkArgs = buildStdoutOrRtspSinkArgs(inv.sink);
       return [
         ...head,
-        ...buildVideoArgs(inv.video, inv.outputArgs),
+        ...videoMapArgs,
+        ...buildVideoArgs(inv.video, inv.outputArgs, graph),
         ...threadArgs,
+        ...mutedAudio ? [] : audioMapArgs,
         ...audioArgs,
         ...inv.outputArgs,
-        ...sinkArgs,
+        ...buildStdoutOrRtspSinkArgs(inv.sink),
         ...inv.audioSidecar ? buildAudioSidecarArgs(inv.audioSidecar) : []
       ];
     }
@@ -65618,6 +65749,12 @@ var require_canonical_hash_9lydiEzx = __commonJS({
         return pickVideoEncoder;
       }
     });
+    Object.defineProperty(exports, "resolveStreamMaps", {
+      enumerable: true,
+      get: function() {
+        return resolveStreamMaps;
+      }
+    });
   }
 });
 
@@ -65664,7 +65801,7 @@ var require_node = __commonJS({
       value: mod,
       enumerable: true
     }) : target, mod));
-    var require_canonical_hash = require_canonical_hash_9lydiEzx();
+    var require_canonical_hash = require_canonical_hash_CZ2JqJc3();
     var require_err_msg = require_err_msg_COpsHMw2();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
@@ -67017,8 +67154,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
-    var require_retired_settings_keys = require_retired_settings_keys_VcrnwKN0();
+    var require_dist10 = require_dist_BW7x4kAI();
+    var require_retired_settings_keys = require_retired_settings_keys_CeaYCDU4();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -73026,7 +73163,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -73163,7 +73300,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -73359,7 +73496,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -81172,7 +81309,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -81759,7 +81896,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var node_fs_promises = __require("fs/promises");
     var node_fs = __require("fs");
     node_fs = require_chunk.__toESM(node_fs);
@@ -84512,7 +84649,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -85739,8 +85876,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
-    var require_retired_settings_keys = require_retired_settings_keys_VcrnwKN0();
+    var require_dist10 = require_dist_BW7x4kAI();
+    var require_retired_settings_keys = require_retired_settings_keys_CeaYCDU4();
     var require_wal_checkpoint_policy = require_wal_checkpoint_policy_CCJZngds();
     var node_crypto = __require("crypto");
     var node_path = __require("path");
@@ -88527,7 +88664,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -92254,7 +92391,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -110315,7 +110452,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -112353,9 +112490,9 @@ var require_event_category_BVfsrBYA = __commonJS({
   }
 });
 
-// ../types/dist/sleep-DqtlfkSS.js
-var require_sleep_DqtlfkSS = __commonJS({
-  "../types/dist/sleep-DqtlfkSS.js"(exports) {
+// ../types/dist/sleep-BAAUFDCk.js
+var require_sleep_BAAUFDCk = __commonJS({
+  "../types/dist/sleep-BAAUFDCk.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_BVfsrBYA();
     var zod = require_zod();
@@ -115258,6 +115395,8 @@ var require_sleep_DqtlfkSS = __commonJS({
           deletePreset: (input) => dispatch("ptz", "ptz", "deletePreset", "mutation", input),
           getOptions: (input) => dispatch("ptz", "ptz", "getOptions", "query", input),
           goHome: (input) => dispatch("ptz", "ptz", "goHome", "mutation", input),
+          getHomePreset: (input) => dispatch("ptz", "ptz", "getHomePreset", "query", input),
+          setHomePreset: (input) => dispatch("ptz", "ptz", "setHomePreset", "mutation", input),
           getPosition: (input) => dispatch("ptz", "ptz", "getPosition", "query", input),
           setAutofocus: (input) => dispatch("ptz", "ptz", "setAutofocus", "mutation", input),
           getStatus: (input) => dispatch("ptz", "ptz", "getStatus", "query", input)
@@ -116256,7 +116395,7 @@ var require_addon = __commonJS({
   "../types/dist/addon.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_sleep = require_sleep_DqtlfkSS();
+    var require_sleep = require_sleep_BAAUFDCk();
     var require_event_category = require_event_category_BVfsrBYA();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
@@ -136582,7 +136721,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DluLUTzR();
+    var require_dist10 = require_dist_BW7x4kAI();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -217746,9 +217885,9 @@ var require_dist4 = __commonJS({
   "../types/dist/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_sleep = require_sleep_DqtlfkSS();
+    var require_sleep = require_sleep_BAAUFDCk();
     var require_event_category = require_event_category_BVfsrBYA();
-    var require_canonical_hash = require_canonical_hash_9lydiEzx();
+    var require_canonical_hash = require_canonical_hash_CZ2JqJc3();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
     var zod = require_zod();
@@ -244555,14 +244694,36 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       if (profiles.length === 0) return null;
       return profiles.some((p) => p.audioEnabled);
     }
+    var PtzPresetFunctionSchema = zod.z.enum([
+      "home",
+      "day-mode",
+      "night-mode",
+      "day-night-auto",
+      "set-limits",
+      "save-limits",
+      "reboot",
+      "osd-menu"
+    ]);
     var PtzPresetSchema = zod.z.object({
       id: zod.z.string(),
-      name: zod.z.string()
+      name: zod.z.string(),
+      /**
+      * The firmware function this id performs, when the provider KNOWS the id is
+      * reserved. `null` = an ordinary stored position, OR a reserved id this
+      * provider does not recognise -- the two are told apart by `writable`.
+      */
+      fn: PtzPresetFunctionSchema.nullable(),
+      /**
+      * Whether `savePreset` / `deletePreset` may target this id. A provider sets
+      * it false only for a band it KNOWS is reserved; where the firmware is not
+      * documented it stays true and a refusal comes from the camera, named.
+      */
+      writable: zod.z.boolean()
     });
     var PtzPositionSchema = zod.z.object({
-      pan: zod.z.number(),
-      tilt: zod.z.number(),
-      zoom: zod.z.number()
+      pan: zod.z.number().nullable(),
+      tilt: zod.z.number().nullable(),
+      zoom: zod.z.number().nullable()
     });
     var PtzMoveCommandSchema = zod.z.object({
       pan: zod.z.number().optional(),
@@ -244580,7 +244741,42 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       maxPresets: zod.z.number().optional(),
       /** Whether the camera exposes a controllable autofocus toggle
       *  (boolean `hasX` per the getOptions availability convention). */
-      hasAutofocus: zod.z.boolean()
+      hasAutofocus: zod.z.boolean(),
+      /**
+      * How many distinct speeds this camera's NATIVE scale offers.
+      *
+      * The cap's `speed` is normalized 0..1 and each provider maps it down --
+      * Baichuan 1..63, Dahua 1..8, ISAPI's percentage -100..100. The normalized
+      * value hides how coarse that really is: asking an amcrest for `0.37` is
+      * meaningless, because it has eight steps and three of them round to the
+      * same one. A loop that tunes its own gain has to know the granularity of
+      * the knob it is turning.
+      *
+      * `null` = the driver does not know, or the scale is continuous (ONVIF takes
+      * a float). Never a made-up number.
+      */
+      speedSteps: zod.z.number().int().positive().nullable(),
+      /**
+      * How long ONE `move` pulse runs on this driver, ms.
+      *
+      * `move` is a self-terminating burst everywhere, but every provider hardcoded
+      * its own duration in private -- 200 reolink, 350 amcrest, 500 hikvision,
+      * 1000 onvif -- so no caller could read it. It is the DENOMINATOR of "how far
+      * did the head travel per pulse": without it a measured displacement has no
+      * gain to be divided into.
+      *
+      * `null` = the driver cannot say.
+      */
+      moveImpulseMs: zod.z.number().int().positive().nullable()
+    });
+    var PtzHomePresetSchema = zod.z.object({
+      presetId: zod.z.string().nullable(),
+      source: zod.z.enum([
+        "operator",
+        "firmware",
+        "native",
+        "none"
+      ])
     });
     var ptzCapability = {
       name: "ptz",
@@ -244621,7 +244817,25 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           auth: "admin"
         }),
         getOptions: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), PtzOptionsSchema),
+        /**
+        * Move to the camera's configured home preset. THROWS when
+        * `getHomePreset()` resolves to `none` -- a head that did not move must
+        * never look like a head that went home.
+        */
         goHome: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), { kind: "mutation" }),
+        /** Which preset `goHome` targets, and who decided it. */
+        getHomePreset: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), PtzHomePresetSchema),
+        /**
+        * Pin the home preset for this camera. `null` clears the operator's choice
+        * and falls back to whatever the firmware names, or to `none`.
+        */
+        setHomePreset: require_sleep.method(zod.z.object({
+          deviceId: zod.z.number(),
+          presetId: zod.z.string().nullable()
+        }), zod.z.void(), {
+          kind: "mutation",
+          auth: "admin"
+        }),
         /**
         * Pull the current PTZ position. Redundant with the auto-injected
         * `getStatus` method (see `status` below); kept for callers that
@@ -256249,6 +256463,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "delete"
       },
+      "ptz.getHomePreset": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "ptz.getOptions": {
         capName: "ptz",
         capScope: "device",
@@ -256297,6 +256517,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "create"
       },
+      "ptz.setHomePreset": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "create"
+      },
       "ptz.stop": {
         capName: "ptz",
         capScope: "device",
@@ -259736,6 +259962,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "ptz.getHomePreset": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.getOptions": [{
         name: "deviceId",
         form: "single",
@@ -259776,6 +260007,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "ptz.setHomePreset": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.stop": [{
         name: "deviceId",
         form: "single",
@@ -264925,9 +265161,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.PtzAutotrackSettingsSchema = PtzAutotrackSettingsSchema;
     exports.PtzAutotrackStatusSchema = PtzAutotrackStatusSchema;
     exports.PtzAutotrackTargetOptionSchema = PtzAutotrackTargetOptionSchema;
+    exports.PtzHomePresetSchema = PtzHomePresetSchema;
     exports.PtzMoveCommandSchema = PtzMoveCommandSchema;
     exports.PtzOptionsSchema = PtzOptionsSchema;
     exports.PtzPositionSchema = PtzPositionSchema;
+    exports.PtzPresetFunctionSchema = PtzPresetFunctionSchema;
     exports.PtzPresetSchema = PtzPresetSchema;
     exports.PtzStatusSchema = PtzStatusSchema;
     exports.QueryFilterSchema = QueryFilterSchema;
@@ -265648,6 +265886,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.resolvePoolMemoryPolicy = resolvePoolMemoryPolicy;
     exports.resolveRecordingProfiles = resolveRecordingProfiles;
     exports.resolveRunnerId = resolveRunnerId;
+    exports.resolveStreamMaps = require_canonical_hash.resolveStreamMaps;
     exports.resolveVariantModelId = resolveVariantModelId;
     exports.resolveViewableDeviceIds = resolveViewableDeviceIds;
     exports.roleSpec = roleSpec;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.167",
+  "version": "1.2.168",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",