camstack 1.2.168 → 1.2.170

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

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-B1y0Fo1U.mjs
+// ../types/dist/sleep-Dk-BdnBf.mjs
 var AUDIO_CHUNK_FORMATS = [
   "f32le",
   "pcmu",
@@ -38767,6 +38767,10 @@ var PtzHomePresetSchema = external_exports.object({
     "none"
   ])
 });
+var PtzHomeReturnSchema = external_exports.object({
+  enabled: external_exports.boolean(),
+  seconds: external_exports.number().int()
+});
 var ptzCapability = {
   name: "ptz",
   scope: "device",
@@ -38826,6 +38830,54 @@ var ptzCapability = {
       auth: "admin"
     }),
     /**
+    * Make WHERE THE HEAD IS POINTING RIGHT NOW this camera's home.
+    *
+    * `setHomePreset` takes a preset id, and a preset id is the wrong shape for
+    * the most natural thing an operator does: aim the camera, then say "here".
+    * It is also the only shape a camera whose home is NOT a preset can accept
+    * -- Reolink's home is a guard point, a stored position with no id at all,
+    * and hiding the control for that case (as the UI briefly did) left the one
+    * vendor with a native home unable to set it.
+    *
+    * Each provider does it its own way:
+    *   reolink   `setGrd` with `needSetPos`, pinning the guard point here
+    *   hikvision / amcrest  save a preset, then pin it as home
+    *   onvif     REFUSES -- its home is the PTZ origin and cannot be moved
+    *
+    * A provider that cannot honour it throws rather than silently doing
+    * nothing: an operator who pressed "set home here" and saw no error would
+    * believe it took.
+    */
+    captureHomeHere: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.void(), {
+      kind: "mutation",
+      auth: "admin"
+    }),
+    /**
+    * Whether the camera returns home on its own when left idle, and after how
+    * long. `null` when it has no such behaviour at all.
+    *
+    * Reolink's guard point carries one (`timeout`, freely settable in
+    * seconds). It is a real function of the camera that we did not expose at
+    * all, and it belongs next to the home it governs rather than in a vendor
+    * settings page nobody associates with Home.
+    */
+    getHomeReturn: method(external_exports.object({ deviceId: external_exports.number() }), PtzHomeReturnSchema.nullable()),
+    /**
+    * Set both together. Refused by a camera with no idle-return behaviour.
+    *
+    * They travel together for the same reason they are read together: the
+    * underlying write carries both, so setting one alone means reading the
+    * other back first and racing whoever else is writing.
+    */
+    setHomeReturn: method(external_exports.object({
+      deviceId: external_exports.number(),
+      enabled: external_exports.boolean(),
+      seconds: external_exports.number().int().min(0).max(3600)
+    }), 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
     * haven't migrated. Will be folded into `getStatus` in a future
@@ -46236,6 +46288,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "ptz.captureHomeHere": {
+    capName: "ptz",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
   "ptz.continuousMove": {
     capName: "ptz",
     capScope: "device",
@@ -46254,6 +46312,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "ptz.getHomeReturn": {
+    capName: "ptz",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "ptz.getOptions": {
     capName: "ptz",
     capScope: "device",
@@ -46308,6 +46372,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "ptz.setHomeReturn": {
+    capName: "ptz",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
   "ptz.stop": {
     capName: "ptz",
     capScope: "device",
@@ -49471,6 +49541,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "ptz.captureHomeHere": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "ptz.continuousMove": [{
     name: "deviceId",
     form: "single",
@@ -49486,6 +49561,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "ptz.getHomeReturn": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "ptz.getOptions": [{
     name: "deviceId",
     form: "single",
@@ -49531,6 +49611,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "ptz.setHomeReturn": [{
+    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-AWHVFK2L.js";
+} from "./chunk-HGT3EBMM.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-PSI434KW.js");
+  await import("./launcher-4GC3GGPE.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-PSI434KW.js");
+  await import("./launcher-4GC3GGPE.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-BCCPZRN4.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-GNXVHE5F.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-BCCPZRN4.js → discover-GNXVHE5F.js}

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

package/dist/{launcher-PSI434KW.js → launcher-4GC3GGPE.js}

@@ -23742,9 +23742,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-BW7x4kAI.js
-var require_dist_BW7x4kAI = __commonJS({
-  "../system/dist/dist-BW7x4kAI.js"(exports) {
+// ../system/dist/dist-Htt-fKD5.js
+var require_dist_Htt_fKD5 = __commonJS({
+  "../system/dist/dist-Htt-fKD5.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -49442,6 +49442,10 @@ var require_dist_BW7x4kAI = __commonJS({
         "none"
       ])
     });
+    var PtzHomeReturnSchema = zod.z.object({
+      enabled: zod.z.boolean(),
+      seconds: zod.z.number().int()
+    });
     var ptzCapability = {
       name: "ptz",
       scope: "device",
@@ -49501,6 +49505,54 @@ var require_dist_BW7x4kAI = __commonJS({
           auth: "admin"
         }),
         /**
+        * Make WHERE THE HEAD IS POINTING RIGHT NOW this camera's home.
+        *
+        * `setHomePreset` takes a preset id, and a preset id is the wrong shape for
+        * the most natural thing an operator does: aim the camera, then say "here".
+        * It is also the only shape a camera whose home is NOT a preset can accept
+        * -- Reolink's home is a guard point, a stored position with no id at all,
+        * and hiding the control for that case (as the UI briefly did) left the one
+        * vendor with a native home unable to set it.
+        *
+        * Each provider does it its own way:
+        *   reolink   `setGrd` with `needSetPos`, pinning the guard point here
+        *   hikvision / amcrest  save a preset, then pin it as home
+        *   onvif     REFUSES -- its home is the PTZ origin and cannot be moved
+        *
+        * A provider that cannot honour it throws rather than silently doing
+        * nothing: an operator who pressed "set home here" and saw no error would
+        * believe it took.
+        */
+        captureHomeHere: method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), {
+          kind: "mutation",
+          auth: "admin"
+        }),
+        /**
+        * Whether the camera returns home on its own when left idle, and after how
+        * long. `null` when it has no such behaviour at all.
+        *
+        * Reolink's guard point carries one (`timeout`, freely settable in
+        * seconds). It is a real function of the camera that we did not expose at
+        * all, and it belongs next to the home it governs rather than in a vendor
+        * settings page nobody associates with Home.
+        */
+        getHomeReturn: method(zod.z.object({ deviceId: zod.z.number() }), PtzHomeReturnSchema.nullable()),
+        /**
+        * Set both together. Refused by a camera with no idle-return behaviour.
+        *
+        * They travel together for the same reason they are read together: the
+        * underlying write carries both, so setting one alone means reading the
+        * other back first and racing whoever else is writing.
+        */
+        setHomeReturn: method(zod.z.object({
+          deviceId: zod.z.number(),
+          enabled: zod.z.boolean(),
+          seconds: zod.z.number().int().min(0).max(3600)
+        }), 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
         * haven't migrated. Will be folded into `getStatus` in a future
@@ -57741,6 +57793,12 @@ var require_dist_BW7x4kAI = __commonJS({
         addonId: null,
         access: "create"
       },
+      "ptz.captureHomeHere": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "create"
+      },
       "ptz.continuousMove": {
         capName: "ptz",
         capScope: "device",
@@ -57759,6 +57817,12 @@ var require_dist_BW7x4kAI = __commonJS({
         addonId: null,
         access: "view"
       },
+      "ptz.getHomeReturn": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "ptz.getOptions": {
         capName: "ptz",
         capScope: "device",
@@ -57813,6 +57877,12 @@ var require_dist_BW7x4kAI = __commonJS({
         addonId: null,
         access: "create"
       },
+      "ptz.setHomeReturn": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "create"
+      },
       "ptz.stop": {
         capName: "ptz",
         capScope: "device",
@@ -60976,6 +61046,11 @@ var require_dist_BW7x4kAI = __commonJS({
         form: "single",
         optional: false
       }],
+      "ptz.captureHomeHere": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.continuousMove": [{
         name: "deviceId",
         form: "single",
@@ -60991,6 +61066,11 @@ var require_dist_BW7x4kAI = __commonJS({
         form: "single",
         optional: false
       }],
+      "ptz.getHomeReturn": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.getOptions": [{
         name: "deviceId",
         form: "single",
@@ -61036,6 +61116,11 @@ var require_dist_BW7x4kAI = __commonJS({
         form: "single",
         optional: false
       }],
+      "ptz.setHomeReturn": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.stop": [{
         name: "deviceId",
         form: "single",
@@ -63063,7 +63148,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -63882,7 +63967,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -63976,7 +64061,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_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -64873,11 +64958,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-CeaYCDU4.js
-var require_retired_settings_keys_CeaYCDU4 = __commonJS({
-  "../system/dist/retired-settings-keys-CeaYCDU4.js"(exports) {
+// ../system/dist/retired-settings-keys-CaGqdEsM.js
+var require_retired_settings_keys_CaGqdEsM = __commonJS({
+  "../system/dist/retired-settings-keys-CaGqdEsM.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -67154,8 +67239,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
-    var require_retired_settings_keys = require_retired_settings_keys_CeaYCDU4();
+    var require_dist10 = require_dist_Htt_fKD5();
+    var require_retired_settings_keys = require_retired_settings_keys_CaGqdEsM();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -73163,7 +73248,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -73300,7 +73385,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -73496,7 +73581,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -81309,7 +81394,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -81896,7 +81981,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var node_fs_promises = __require("fs/promises");
     var node_fs = __require("fs");
     node_fs = require_chunk.__toESM(node_fs);
@@ -84649,7 +84734,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -85876,8 +85961,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
-    var require_retired_settings_keys = require_retired_settings_keys_CeaYCDU4();
+    var require_dist10 = require_dist_Htt_fKD5();
+    var require_retired_settings_keys = require_retired_settings_keys_CaGqdEsM();
     var require_wal_checkpoint_policy = require_wal_checkpoint_policy_CCJZngds();
     var node_crypto = __require("crypto");
     var node_path = __require("path");
@@ -88664,7 +88749,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -92391,7 +92476,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -110452,7 +110537,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -112490,9 +112575,9 @@ var require_event_category_BVfsrBYA = __commonJS({
   }
 });
 
-// ../types/dist/sleep-BAAUFDCk.js
-var require_sleep_BAAUFDCk = __commonJS({
-  "../types/dist/sleep-BAAUFDCk.js"(exports) {
+// ../types/dist/sleep-CDG4jaLR.js
+var require_sleep_CDG4jaLR = __commonJS({
+  "../types/dist/sleep-CDG4jaLR.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_BVfsrBYA();
     var zod = require_zod();
@@ -115397,6 +115482,9 @@ var require_sleep_BAAUFDCk = __commonJS({
           goHome: (input) => dispatch("ptz", "ptz", "goHome", "mutation", input),
           getHomePreset: (input) => dispatch("ptz", "ptz", "getHomePreset", "query", input),
           setHomePreset: (input) => dispatch("ptz", "ptz", "setHomePreset", "mutation", input),
+          captureHomeHere: (input) => dispatch("ptz", "ptz", "captureHomeHere", "mutation", input),
+          getHomeReturn: (input) => dispatch("ptz", "ptz", "getHomeReturn", "query", input),
+          setHomeReturn: (input) => dispatch("ptz", "ptz", "setHomeReturn", "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)
@@ -116395,7 +116483,7 @@ var require_addon = __commonJS({
   "../types/dist/addon.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_sleep = require_sleep_BAAUFDCk();
+    var require_sleep = require_sleep_CDG4jaLR();
     var require_event_category = require_event_category_BVfsrBYA();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
@@ -136721,7 +136809,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_BW7x4kAI();
+    var require_dist10 = require_dist_Htt_fKD5();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -217885,7 +217973,7 @@ var require_dist4 = __commonJS({
   "../types/dist/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_sleep = require_sleep_BAAUFDCk();
+    var require_sleep = require_sleep_CDG4jaLR();
     var require_event_category = require_event_category_BVfsrBYA();
     var require_canonical_hash = require_canonical_hash_CZ2JqJc3();
     var require_enums2 = require_enums();
@@ -244778,6 +244866,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         "none"
       ])
     });
+    var PtzHomeReturnSchema = zod.z.object({
+      enabled: zod.z.boolean(),
+      seconds: zod.z.number().int()
+    });
     var ptzCapability = {
       name: "ptz",
       scope: "device",
@@ -244837,6 +244929,54 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           auth: "admin"
         }),
         /**
+        * Make WHERE THE HEAD IS POINTING RIGHT NOW this camera's home.
+        *
+        * `setHomePreset` takes a preset id, and a preset id is the wrong shape for
+        * the most natural thing an operator does: aim the camera, then say "here".
+        * It is also the only shape a camera whose home is NOT a preset can accept
+        * -- Reolink's home is a guard point, a stored position with no id at all,
+        * and hiding the control for that case (as the UI briefly did) left the one
+        * vendor with a native home unable to set it.
+        *
+        * Each provider does it its own way:
+        *   reolink   `setGrd` with `needSetPos`, pinning the guard point here
+        *   hikvision / amcrest  save a preset, then pin it as home
+        *   onvif     REFUSES -- its home is the PTZ origin and cannot be moved
+        *
+        * A provider that cannot honour it throws rather than silently doing
+        * nothing: an operator who pressed "set home here" and saw no error would
+        * believe it took.
+        */
+        captureHomeHere: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), {
+          kind: "mutation",
+          auth: "admin"
+        }),
+        /**
+        * Whether the camera returns home on its own when left idle, and after how
+        * long. `null` when it has no such behaviour at all.
+        *
+        * Reolink's guard point carries one (`timeout`, freely settable in
+        * seconds). It is a real function of the camera that we did not expose at
+        * all, and it belongs next to the home it governs rather than in a vendor
+        * settings page nobody associates with Home.
+        */
+        getHomeReturn: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), PtzHomeReturnSchema.nullable()),
+        /**
+        * Set both together. Refused by a camera with no idle-return behaviour.
+        *
+        * They travel together for the same reason they are read together: the
+        * underlying write carries both, so setting one alone means reading the
+        * other back first and racing whoever else is writing.
+        */
+        setHomeReturn: require_sleep.method(zod.z.object({
+          deviceId: zod.z.number(),
+          enabled: zod.z.boolean(),
+          seconds: zod.z.number().int().min(0).max(3600)
+        }), 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
         * haven't migrated. Will be folded into `getStatus` in a future
@@ -256451,6 +256591,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "create"
       },
+      "ptz.captureHomeHere": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "create"
+      },
       "ptz.continuousMove": {
         capName: "ptz",
         capScope: "device",
@@ -256469,6 +256615,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "view"
       },
+      "ptz.getHomeReturn": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "ptz.getOptions": {
         capName: "ptz",
         capScope: "device",
@@ -256523,6 +256675,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "create"
       },
+      "ptz.setHomeReturn": {
+        capName: "ptz",
+        capScope: "device",
+        addonId: null,
+        access: "create"
+      },
       "ptz.stop": {
         capName: "ptz",
         capScope: "device",
@@ -259952,6 +260110,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "ptz.captureHomeHere": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.continuousMove": [{
         name: "deviceId",
         form: "single",
@@ -259967,6 +260130,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "ptz.getHomeReturn": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.getOptions": [{
         name: "deviceId",
         form: "single",
@@ -260012,6 +260180,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "ptz.setHomeReturn": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "ptz.stop": [{
         name: "deviceId",
         form: "single",
@@ -265162,6 +265335,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.PtzAutotrackStatusSchema = PtzAutotrackStatusSchema;
     exports.PtzAutotrackTargetOptionSchema = PtzAutotrackTargetOptionSchema;
     exports.PtzHomePresetSchema = PtzHomePresetSchema;
+    exports.PtzHomeReturnSchema = PtzHomeReturnSchema;
     exports.PtzMoveCommandSchema = PtzMoveCommandSchema;
     exports.PtzOptionsSchema = PtzOptionsSchema;
     exports.PtzPositionSchema = PtzPositionSchema;

package/package.json

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