@camstack/types 1.2.243 → 1.2.245

package/dist/capabilities/videoclips.cap.d.ts

@@ -91,6 +91,31 @@ export declare const ClipStillDispositionSchema: z.ZodEnum<{
 export type ClipStillDisposition = z.infer<typeof ClipStillDispositionSchema>;
 /** The camera's / provider's own words. Kept verbatim, never parsed. */
 export declare const CLIP_STILL_REASON_HEADER = "x-camstack-reason";
+/** Longest reason a header carries. Beyond this the sentence is cut. */
+export declare const CLIP_REASON_HEADER_MAX = 500;
+/**
+ * Make a refusal sentence safe to put in an HTTP header.
+ *
+ * **An HTTP header value is Latin-1.** Node throws `Invalid character in
+ * header content` on anything above U+00FF, the handler dies mid-response,
+ * and the client gets a socket hang up — no status, no reason, nothing. The
+ * mechanism that exists to EXPLAIN a refusal is then the thing that silences
+ * it, and the surface shows "nothing happened".
+ *
+ * That is not hypothetical: measured 2026-09-23 on 1436, a Hikvision replay
+ * refusal read `SETUP of the video track answered 500 — the camera refused
+ * this replay`, and the EM DASH in it threw on every clip the operator
+ * opened. This repository writes its refusals in prose, and its prose uses
+ * `—`, `’` and `…` everywhere, so every reason string is a candidate.
+ *
+ * Substitutes rather than strips: an operator reading a log or a response
+ * should get a readable sentence, not one with holes in it. The typographic
+ * characters this repo actually writes have exact ASCII equivalents; anything
+ * else non-Latin-1 becomes `?`, which is visible rather than silent. Control
+ * characters go too — a newline in a header value is a response-splitting
+ * bug, not a formatting one.
+ */
+export declare function clipReasonHeaderValue(reason: string): string;
 /** One {@link ClipStillRefusalCodeSchema} token, alone. */
 export declare const CLIP_STILL_REASON_CODE_HEADER = "x-camstack-reason-code";
 /** One {@link ClipStillDispositionSchema} token, alone. */

package/dist/generated/addon-api.d.ts

@@ -36,6 +36,7 @@ import type { customModelRegistryCapability } from '../capabilities/custom-model
 import type { dataStoreProviderCapability } from '../capabilities/data-store-provider.cap.js';
 import type { dayNightCapability } from '../capabilities/day-night.cap.js';
 import type { decoderCapability } from '../capabilities/decoder.cap.js';
+import type { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap.js';
 import type { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 import type { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 import type { deviceExportCapability } from '../capabilities/device-export.cap.js';
@@ -94,6 +95,7 @@ import type { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.j
 import type { ptzCapability } from '../capabilities/ptz.cap.js';
 import type { rebootCapability } from '../capabilities/reboot.cap.js';
 import type { recordingExportCapability } from '../capabilities/recording-export.cap.js';
+import type { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import type { recordingCapability } from '../capabilities/recording.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
@@ -1917,6 +1919,20 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    deviceAdminLink: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getAdminLink: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceAdminLinkCapability.methods.getAdminLink.input>;
+            output: z.infer<typeof deviceAdminLinkCapability.methods.getAdminLink.output>;
+            meta: object;
+        }>;
+    }>>;
     deviceAdoption: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;
@@ -7137,6 +7153,34 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    recordingOnboard: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getStatus: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof DEVICE_STATUS_METHOD.getStatus.input>;
+            output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
+            meta: object;
+        }>;
+        getOptions: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingOnboardCapability.methods.getOptions.input>;
+            output: z.infer<typeof recordingOnboardCapability.methods.getOptions.output>;
+            meta: object;
+        }>;
+        setSettings: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingOnboardCapability.methods.setSettings.input>;
+            output: z.infer<typeof recordingOnboardCapability.methods.setSettings.output>;
+            meta: object;
+        }>;
+    }>>;
     recordingSignal: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;

package/dist/generated/cap-status-types.d.ts

@@ -55,6 +55,7 @@ import type { PrivacyMaskStatusSchema } from '../capabilities/privacy-mask.cap.j
 import type { PtzStatusSchema } from '../capabilities/ptz.cap.js';
 import type { PtzAutotrackStatusSchema } from '../capabilities/ptz-autotrack.cap.js';
 import type { RecordingStatusSchema } from '../capabilities/recording.cap.js';
+import type { RecordingOnboardStatusSchema } from '../capabilities/recording-onboard.cap.js';
 import type { RecordingSignalStatusSchema } from '../capabilities/recording-signal.cap.js';
 import type { SceneMonitorStatusSchema } from '../capabilities/scene-monitor.cap.js';
 import type { ScriptRunnerStatusSchema } from '../capabilities/script-runner.cap.js';
@@ -132,6 +133,7 @@ export type CapStatusTypeMap = {
     readonly 'ptz': z.infer<typeof PtzStatusSchema>;
     readonly 'ptz-autotrack': z.infer<typeof PtzAutotrackStatusSchema>;
     readonly 'recording': z.infer<typeof RecordingStatusSchema>;
+    readonly 'recording-onboard': z.infer<typeof RecordingOnboardStatusSchema>;
     readonly 'recording-signal': z.infer<typeof RecordingSignalStatusSchema>;
     readonly 'scene-monitor': z.infer<typeof SceneMonitorStatusSchema>;
     readonly 'script-runner': z.infer<typeof ScriptRunnerStatusSchema>;
@@ -155,4 +157,4 @@ export type CapNameWithStatus = keyof CapStatusTypeMap;
  * aggregator to enumerate caps whose `status` should be polled +
  * streamed via `subscribeDeviceStatusAggregate`.
  */
-export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording", "recording-signal", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];
+export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];

package/dist/generated/capability-router-map.d.ts

@@ -42,6 +42,7 @@ export { dataStoreProviderCapability } from '../capabilities/data-store-provider
 export { dayNightCapability } from '../capabilities/day-night.cap.js';
 export { decoderCapability } from '../capabilities/decoder.cap.js';
 export { detectionPipelineCapability } from '../capabilities/detection-pipeline.cap.js';
+export { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap.js';
 export { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 export { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 export { deviceExportCapability } from '../capabilities/device-export.cap.js';
@@ -116,6 +117,7 @@ export { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 export { rebootCapability } from '../capabilities/reboot.cap.js';
 export { recordingCapability } from '../capabilities/recording.cap.js';
 export { recordingExportCapability } from '../capabilities/recording-export.cap.js';
+export { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 export { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 export { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 export { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -201,6 +203,7 @@ export declare const CAPABILITY_NAMES: {
     readonly dayNight: "day-night";
     readonly decoder: "decoder";
     readonly detectionPipeline: "detection-pipeline";
+    readonly deviceAdminLink: "device-admin-link";
     readonly deviceAdoption: "device-adoption";
     readonly deviceDiscovery: "device-discovery";
     readonly deviceExport: "device-export";
@@ -275,6 +278,7 @@ export declare const CAPABILITY_NAMES: {
     readonly reboot: "reboot";
     readonly recording: "recording";
     readonly recordingExport: "recording-export";
+    readonly recordingOnboard: "recording-onboard";
     readonly recordingSignal: "recording-signal";
     readonly sceneMonitor: "scene-monitor";
     readonly scriptRunner: "script-runner";
@@ -373,6 +377,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly dayNight: TRouter;
     readonly decoder: TRouter;
     readonly detectionPipeline: TRouter;
+    readonly deviceAdminLink: TRouter;
     readonly deviceAdoption: TRouter;
     readonly deviceDiscovery: TRouter;
     readonly deviceExport: TRouter;
@@ -447,6 +452,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly reboot: TRouter;
     readonly recording: TRouter;
     readonly recordingExport: TRouter;
+    readonly recordingOnboard: TRouter;
     readonly recordingSignal: TRouter;
     readonly sceneMonitor: TRouter;
     readonly scriptRunner: TRouter;
@@ -488,8 +494,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly zoneRules: TRouter;
     readonly zones: TRouter;
 }
-/** Capability names whose mode is `singleton` (129 caps). */
-export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-grid-layout", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording", "recording-export", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "stream-signals", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
+/** Capability names whose mode is `singleton` (131 caps). */
+export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-grid-layout", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-admin-link", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording", "recording-export", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "stream-signals", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
 /** Capability names whose mode is `collection` (29 caps). */

package/dist/generated/device-local-state.d.ts

@@ -48,6 +48,7 @@ import { presenceCapability } from '../capabilities/presence.cap.js';
 import { pressureSensorCapability } from '../capabilities/pressure-sensor.cap.js';
 import { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js';
 import { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
+import { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -128,6 +129,7 @@ export interface DeviceLocalState {
     pressureSensor: InferRuntimeState<typeof pressureSensorCapability>;
     privacyMask: InferRuntimeState<typeof privacyMaskCapability>;
     ptzAutotrack: InferRuntimeState<typeof ptzAutotrackCapability>;
+    recordingOnboard: InferRuntimeState<typeof recordingOnboardCapability>;
     recordingSignal: InferRuntimeState<typeof recordingSignalCapability>;
     sceneMonitor: InferRuntimeState<typeof sceneMonitorCapability>;
     scriptRunner: InferRuntimeState<typeof scriptRunnerCapability>;
@@ -218,6 +220,7 @@ export interface CapNameToRuntimeStateMap {
     'pressure-sensor': InferRuntimeState<typeof pressureSensorCapability>;
     'privacy-mask': InferRuntimeState<typeof privacyMaskCapability>;
     'ptz-autotrack': InferRuntimeState<typeof ptzAutotrackCapability>;
+    'recording-onboard': InferRuntimeState<typeof recordingOnboardCapability>;
     'recording-signal': InferRuntimeState<typeof recordingSignalCapability>;
     'scene-monitor': InferRuntimeState<typeof sceneMonitorCapability>;
     'script-runner': InferRuntimeState<typeof scriptRunnerCapability>;

package/dist/generated/device-proxy.d.ts

@@ -26,6 +26,7 @@ import type { controlCapability } from '../capabilities/control.cap.js';
 import type { coverCapability } from '../capabilities/cover.cap.js';
 import type { dayNightCapability } from '../capabilities/day-night.cap.js';
 import type { detectionPipelineCapability } from '../capabilities/detection-pipeline.cap.js';
+import type { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap.js';
 import type { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
 import type { deviceStatusCapability } from '../capabilities/device-status.cap.js';
@@ -65,6 +66,7 @@ import type { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js'
 import type { ptzCapability } from '../capabilities/ptz.cap.js';
 import type { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 import type { rebootCapability } from '../capabilities/reboot.cap.js';
+import type { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import type { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -160,6 +162,7 @@ export interface DeviceProxyState {
     readonly pressureSensor: SliceHandle<InferRuntimeState<typeof pressureSensorCapability>>;
     readonly privacyMask: SliceHandle<InferRuntimeState<typeof privacyMaskCapability>>;
     readonly ptzAutotrack: SliceHandle<InferRuntimeState<typeof ptzAutotrackCapability>>;
+    readonly recordingOnboard: SliceHandle<InferRuntimeState<typeof recordingOnboardCapability>>;
     readonly recordingSignal: SliceHandle<InferRuntimeState<typeof recordingSignalCapability>>;
     readonly sceneMonitor: SliceHandle<InferRuntimeState<typeof sceneMonitorCapability>>;
     readonly scriptRunner: SliceHandle<InferRuntimeState<typeof scriptRunnerCapability>>;
@@ -222,6 +225,7 @@ export interface DeviceProxy {
     readonly cover?: InferDeviceProxyCap<typeof coverCapability>;
     readonly dayNight?: InferDeviceProxyCap<typeof dayNightCapability>;
     readonly detectionPipeline?: InferDeviceProxyCap<typeof detectionPipelineCapability>;
+    readonly deviceAdminLink?: InferDeviceProxyCap<typeof deviceAdminLinkCapability>;
     readonly deviceDiscovery?: InferDeviceProxyCap<typeof deviceDiscoveryCapability>;
     readonly deviceOps?: InferDeviceProxyCap<typeof deviceOpsCapability>;
     readonly deviceStatus?: InferDeviceProxyCap<typeof deviceStatusCapability>;
@@ -261,6 +265,7 @@ export interface DeviceProxy {
     readonly ptz?: InferDeviceProxyCap<typeof ptzCapability>;
     readonly ptzAutotrack?: InferDeviceProxyCap<typeof ptzAutotrackCapability>;
     readonly reboot?: InferDeviceProxyCap<typeof rebootCapability>;
+    readonly recordingOnboard?: InferDeviceProxyCap<typeof recordingOnboardCapability>;
     readonly recordingSignal?: InferDeviceProxyCap<typeof recordingSignalCapability>;
     readonly sceneMonitor?: InferDeviceProxyCap<typeof sceneMonitorCapability>;
     readonly scriptRunner?: InferDeviceProxyCap<typeof scriptRunnerCapability>;

package/dist/generated/device-scoped-caps.d.ts

@@ -5,7 +5,7 @@
  * can answer "may a rule actuate this?" without importing the schema barrel
  * (~144MB RSS per runner, D28).
  *
- * Coverage: 85 device-scoped capabilities.
+ * Coverage: 87 device-scoped capabilities.
  */
 export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
 /**

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1165 method paths across 158 capabilities.
+ * Coverage: 1169 method paths across 160 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 392 methods carry a device reference, of which
+ * Coverage: 395 methods carry a device reference, of which
  * 141 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/runtime-state-durability.d.ts

@@ -11,7 +11,7 @@ export interface RuntimeStatePolicy {
 }
 /**
  * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
- * `runtimeState`. 68 caps: 35 `restored`, 33 `session`.
+ * `runtimeState`. 69 caps: 36 `restored`, 33 `session`.
  *
  * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
  * with `durability: 'session'` has one and has decided not to keep it.