@camstack/types 1.2.188 → 1.2.189

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DXsYD0RX.js");
-const require_event_category = require("./event-category-yW4s1MGD.js");
+const require_sleep = require("./sleep-D7dV-FZB.js");
+const require_event_category = require("./event-category-BVfsrBYA.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
-import { D as adminUiCapability, E as DeviceType, G as scopeKey, H as ReadinessTimeoutError, M as expandCapMethods, R as nodePin, S as DEVICE_CHILDREN_BATCH_MAX, St as normalizeAddonInitResult, Tt as emitReadiness, V as ReadinessRegistry, a as asJsonObject, b as deviceOpsCapability, bt as DisposerChain, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as DATAPLANE_SECRET_HEADER, x as viewerUiCapability, xt as BaseAddon, z as readNodePin } from "./sleep-DBKu2-U5.mjs";
-import { t as EventCategory } from "./event-category-ZyX6jcse.mjs";
+import { D as adminUiCapability, E as DeviceType, G as scopeKey, H as ReadinessTimeoutError, M as expandCapMethods, R as nodePin, S as DEVICE_CHILDREN_BATCH_MAX, St as normalizeAddonInitResult, Tt as emitReadiness, V as ReadinessRegistry, a as asJsonObject, b as deviceOpsCapability, bt as DisposerChain, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as DATAPLANE_SECRET_HEADER, x as viewerUiCapability, xt as BaseAddon, z as readNodePin } from "./sleep-DEuj7E3j.mjs";
+import { t as EventCategory } from "./event-category-BVDXG4tB.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/camera/stream-pick.d.ts

@@ -0,0 +1,71 @@
+/**
+ * THE ranking behind `cameraStreams.pickStream` — one place where "which
+ * stream should this consumer get" is answered.
+ *
+ * It is pure, and it lives here rather than inside the broker, because the
+ * point of the exercise was that there be exactly ONE of it. On 2026-09-13
+ * there were two: this picker, and a private scorer inside the Alexa exporter
+ * written the same day because the picker could not express Amazon's ceiling.
+ * A second authority for a question that already had one is the defect this
+ * repo keeps paying for — two knobs where the second outranks the first (D62),
+ * a pin no UI could show, a flag that never reached ffmpeg.
+ *
+ * Each consumer passes ITS OWN numbers. Alexa's floor is Amazon's 480p and its
+ * ceiling 1080p; HomeKit's are its own. The thresholds belong to whoever has
+ * the requirement, never to a default in here.
+ */
+export interface PickCandidate {
+    readonly camStreamId: string;
+    readonly codec?: string | undefined;
+    readonly height?: number | undefined;
+    readonly width?: number | undefined;
+}
+export interface PickRanking {
+    /** Codecs usable with no transcode. Empty ⇒ every codec is usable. */
+    readonly acceptCodecs: readonly string[];
+    /** Whether a codec outside `acceptCodecs` may win, transcoded. */
+    readonly allowTranscode: boolean;
+    /** Ordered provider prefixes; earlier wins. */
+    readonly preferredProviders: readonly string[];
+    /** `highest` / `lowest`, used when `targetHeight` is absent. */
+    readonly resolutionPreference: 'highest' | 'lowest';
+    /** The height the consumer means to deliver. See the cap's docblock. */
+    readonly targetHeight?: number | undefined;
+}
+export interface RankedPick {
+    readonly candidate: PickCandidate;
+    readonly transcodes: boolean;
+}
+/**
+ * THE target rule: which of two sizes serves a consumer better.
+ *
+ * "Prefer at or above the target so the consumer downscales instead of
+ * upscaling; among those the SMALLEST, because the extra pixels are thrown
+ * away and the decode is not; among the rest the LARGEST, because it is the
+ * closest we can get." One sentence, and until now it was written twice — once
+ * here in lines, once in `stream-selection.ts` in pixels, for the same two
+ * exporters. The two agreed, which is luck, not a property.
+ *
+ * The `size` is whatever measure the caller ranks by: the cap ranks by LINES
+ * (a consumer's requirement is stated in p), the RTSP picker by PIXELS (it
+ * compares entries of possibly different aspect). The rule is the same either
+ * way and the measure is the caller's business.
+ *
+ * Returns a sort delta: negative when `a` should come first.
+ */
+export declare function compareToTarget(a: number, b: number, target: number): number;
+export declare function codecIsAccepted(codec: string | undefined, accept: readonly string[]): boolean;
+/**
+ * Order the candidates and return the winner, or `null` when none qualifies.
+ *
+ * The order, and every term is there for a measured reason:
+ *
+ *  1. **A stream we can take AS IS beats one we must re-encode.** A transcode
+ *     is a decode plus an encode for as long as the session lasts, and on this
+ *     hub a concurrent HEVC decode is what exhausted the VAAPI device.
+ *  2. **Provider preference**, unchanged — a native dial beats a relayed one.
+ *  3. **The target**, when the consumer named one: the smallest stream that
+ *     reaches it, else the tallest that does not. Absent, the caller's
+ *     `resolutionPreference` decides, exactly as before.
+ */
+export declare function rankStreams(candidates: readonly PickCandidate[], ranking: PickRanking): RankedPick | null;

package/dist/capabilities/camera-streams.cap.d.ts

@@ -22,6 +22,7 @@ export declare const PickStreamRequirementsSchema: z.ZodReadonly<z.ZodObject<{
         vp9: "vp9";
     }>>>>;
     minHeight: z.ZodOptional<z.ZodNumber>;
+    maxHeight: z.ZodOptional<z.ZodNumber>;
     minWidth: z.ZodOptional<z.ZodNumber>;
     excludeDerived: z.ZodOptional<z.ZodBoolean>;
     requireSiblingCodec: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
@@ -33,6 +34,7 @@ export declare const PickStreamRequirementsSchema: z.ZodReadonly<z.ZodObject<{
         vp8: "vp8";
         vp9: "vp9";
     }>>>>;
+    allowTranscode: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
 export declare const PickStreamPreferencesSchema: z.ZodReadonly<z.ZodObject<{
     preferredProviders: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -40,7 +42,10 @@ export declare const PickStreamPreferencesSchema: z.ZodReadonly<z.ZodObject<{
         highest: "highest";
         lowest: "lowest";
     }>>;
+    targetHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
+export type PickStreamRequirements = z.infer<typeof PickStreamRequirementsSchema>;
+export type PickStreamPreferences = z.infer<typeof PickStreamPreferencesSchema>;
 export declare const PickedCamStreamSchema: z.ZodObject<{
     camStreamId: z.ZodString;
     codec: z.ZodOptional<z.ZodString>;
@@ -48,6 +53,7 @@ export declare const PickedCamStreamSchema: z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strip>>;
+    transcodes: z.ZodBoolean;
     reason: z.ZodString;
 }, z.core.$strip>;
 export type PickedCamStream = z.infer<typeof PickedCamStreamSchema>;
@@ -213,6 +219,7 @@ export declare const cameraStreamsCapability: {
                     vp9: "vp9";
                 }>>>>;
                 minHeight: z.ZodOptional<z.ZodNumber>;
+                maxHeight: z.ZodOptional<z.ZodNumber>;
                 minWidth: z.ZodOptional<z.ZodNumber>;
                 excludeDerived: z.ZodOptional<z.ZodBoolean>;
                 requireSiblingCodec: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
@@ -224,6 +231,7 @@ export declare const cameraStreamsCapability: {
                     vp8: "vp8";
                     vp9: "vp9";
                 }>>>>;
+                allowTranscode: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
             preferences: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
                 preferredProviders: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -231,6 +239,7 @@ export declare const cameraStreamsCapability: {
                     highest: "highest";
                     lowest: "lowest";
                 }>>;
+                targetHeight: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
         }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
             camStreamId: z.ZodString;
@@ -239,6 +248,7 @@ export declare const cameraStreamsCapability: {
                 width: z.ZodNumber;
                 height: z.ZodNumber;
             }, z.core.$strip>>;
+            transcodes: z.ZodBoolean;
             reason: z.ZodString;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
     };

package/dist/capabilities/index.d.ts

@@ -34,7 +34,8 @@ export { AuthResultSchema, authProviderCapability } from './auth-provider.cap.js
 export { ArchiveEntrySchema, ArchiveManifestSchema, BackupDestinationInfoSchema, BackupEntrySchema, type BackupRun, type BackupRunPhase, BackupRunPhaseSchema, BackupRunSchema, type BackupRunState, BackupRunStateSchema, type BackupTriggerResult, BackupTriggerResultSchema, backupCapability, type IBackupProvider, LocationStatSchema, } from './backup.cap.js';
 export { BrokerAddInputSchema, BrokerGetStateInputSchema, type BrokerInfo as UnifiedBrokerInfo, BrokerInfoSchema as UnifiedBrokerInfoSchema, type BrokerProviderInfo, BrokerProviderInfoSchema, BrokerPublishInputSchema, BrokerRegistryStatusSchema, type BrokerStatus as UnifiedBrokerStatus, BrokerStatusEnum, BrokerSubscribeInputSchema, BrokerSubscribeResultSchema, BrokerTestConnectionResultSchema, BrokerUnsubscribeInputSchema, brokerCapability, type IBrokerProvider, } from './broker.cap.js';
 export { cameraPipelineConfigCapability, type ICameraPipelineConfigProvider, } from './camera-pipeline-config.cap.js';
-export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
+export { streamSignalsCapability, type IStreamSignalsProvider, type StreamSignal, StreamSignalSchema, type StreamSignalsStatus, StreamSignalsStatusSchema, } from './stream-signals.cap.js';
+export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, type PickStreamPreferences, PickStreamPreferencesSchema, type PickStreamRequirements, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
 export { extractNestedAddonId, isArrayOutputSchema, isCollectionArrayMethod, isObjectInput, isVoidInput, kebabToCamel, looseSchema, objectInputDeclaresAddonId, procedureAuthKey, resolveMethodAuth, } from './cap-router-predicates.js';
 export type { CapabilityDefinition, CapabilityEventSchema, CapabilityMethodAuth, CapabilityMethodCaller, CapabilityMethodKind, CapabilityMethodOptions, CapabilityMethodSchema, CapabilityMountHint, CapabilityMountKind, CapabilityStatusItemArray, CapabilityStatusKind, CapabilityStatusSchema, CapCaller, DeviceConfigDerivedFormUi, DeviceConfigSpec, DeviceConfigUiSpec, DeviceConfigWidgetUi, DeviceSettingsContribution, InferDeviceProxyCap, InferEvents, InferName, InferNativeProvider, InferProvider, InferRuntimeState, ProviderKind, RuntimeStateDurability, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
 export { DEFAULT_RUNTIME_STATE_DURABILITY, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, event, expandCapMethods, isDeviceConfigCap, method, resolveCapMount, } from './capability-definition.js';
@@ -241,6 +242,7 @@ import type { brokerCapability } from './broker.cap.js';
 import type { buttonCapability } from './button.cap.js';
 import type { cameraCredentialsCapability } from './camera-credentials.cap.js';
 import type { cameraPipelineConfigCapability } from './camera-pipeline-config.cap.js';
+import type { streamSignalsCapability } from './stream-signals.cap.js';
 import type { cameraStreamsCapability } from './camera-streams.cap.js';
 import type { carbonMonoxideCapability } from './carbon-monoxide.cap.js';
 import type { climateControlCapability } from './climate-control.cap.js';
@@ -370,6 +372,6 @@ import type { webrtcSessionCapability } from './webrtc-session.cap.js';
 import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
 import type { zoneRulesCapability } from './zone-rules.cap.js';
 import type { zonesCapability } from './zones.cap.js';
-type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof connectionTestCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability;
+type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof connectionTestCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/capabilities/notification-rules.cap.d.ts

@@ -72,6 +72,8 @@ export declare const NcSystemEventKindSchema: z.ZodEnum<{
     "device-enabled": "device-enabled";
     "device-battery-low": "device-battery-low";
     "device-battery-normal": "device-battery-normal";
+    "device-consumable-low": "device-consumable-low";
+    "device-consumable-normal": "device-consumable-normal";
     "stream-online": "stream-online";
     "stream-offline": "stream-offline";
     "node-online": "node-online";
@@ -90,6 +92,7 @@ export declare const NcSystemEventKindSchema: z.ZodEnum<{
     "addon-updated": "addon-updated";
     "server-updated": "server-updated";
     "export-completed": "export-completed";
+    "backup-completed": "backup-completed";
     "camera-online": "camera-online";
     "camera-offline": "camera-offline";
     "camera-disabled": "camera-disabled";
@@ -128,6 +131,8 @@ export declare const NcSystemEventConditionSchema: z.ZodObject<{
         "device-enabled": "device-enabled";
         "device-battery-low": "device-battery-low";
         "device-battery-normal": "device-battery-normal";
+        "device-consumable-low": "device-consumable-low";
+        "device-consumable-normal": "device-consumable-normal";
         "stream-online": "stream-online";
         "stream-offline": "stream-offline";
         "node-online": "node-online";
@@ -146,6 +151,7 @@ export declare const NcSystemEventConditionSchema: z.ZodObject<{
         "addon-updated": "addon-updated";
         "server-updated": "server-updated";
         "export-completed": "export-completed";
+        "backup-completed": "backup-completed";
         "camera-online": "camera-online";
         "camera-offline": "camera-offline";
         "camera-disabled": "camera-disabled";
@@ -611,6 +617,8 @@ export declare const NcConditionsSchema: z.ZodObject<{
             "device-enabled": "device-enabled";
             "device-battery-low": "device-battery-low";
             "device-battery-normal": "device-battery-normal";
+            "device-consumable-low": "device-consumable-low";
+            "device-consumable-normal": "device-consumable-normal";
             "stream-online": "stream-online";
             "stream-offline": "stream-offline";
             "node-online": "node-online";
@@ -629,6 +637,7 @@ export declare const NcConditionsSchema: z.ZodObject<{
             "addon-updated": "addon-updated";
             "server-updated": "server-updated";
             "export-completed": "export-completed";
+            "backup-completed": "backup-completed";
             "camera-online": "camera-online";
             "camera-offline": "camera-offline";
             "camera-disabled": "camera-disabled";
@@ -898,6 +907,8 @@ export declare const NcRuleInputSchema: z.ZodObject<{
                 "device-enabled": "device-enabled";
                 "device-battery-low": "device-battery-low";
                 "device-battery-normal": "device-battery-normal";
+                "device-consumable-low": "device-consumable-low";
+                "device-consumable-normal": "device-consumable-normal";
                 "stream-online": "stream-online";
                 "stream-offline": "stream-offline";
                 "node-online": "node-online";
@@ -916,6 +927,7 @@ export declare const NcRuleInputSchema: z.ZodObject<{
                 "addon-updated": "addon-updated";
                 "server-updated": "server-updated";
                 "export-completed": "export-completed";
+                "backup-completed": "backup-completed";
                 "camera-online": "camera-online";
                 "camera-offline": "camera-offline";
                 "camera-disabled": "camera-disabled";
@@ -1249,6 +1261,8 @@ export declare const NcRulePatchSchema: z.ZodObject<{
                 "device-enabled": "device-enabled";
                 "device-battery-low": "device-battery-low";
                 "device-battery-normal": "device-battery-normal";
+                "device-consumable-low": "device-consumable-low";
+                "device-consumable-normal": "device-consumable-normal";
                 "stream-online": "stream-online";
                 "stream-offline": "stream-offline";
                 "node-online": "node-online";
@@ -1267,6 +1281,7 @@ export declare const NcRulePatchSchema: z.ZodObject<{
                 "addon-updated": "addon-updated";
                 "server-updated": "server-updated";
                 "export-completed": "export-completed";
+                "backup-completed": "backup-completed";
                 "camera-online": "camera-online";
                 "camera-offline": "camera-offline";
                 "camera-disabled": "camera-disabled";
@@ -1417,6 +1432,8 @@ export declare const NcRuleSchema: z.ZodObject<{
                 "device-enabled": "device-enabled";
                 "device-battery-low": "device-battery-low";
                 "device-battery-normal": "device-battery-normal";
+                "device-consumable-low": "device-consumable-low";
+                "device-consumable-normal": "device-consumable-normal";
                 "stream-online": "stream-online";
                 "stream-offline": "stream-offline";
                 "node-online": "node-online";
@@ -1435,6 +1452,7 @@ export declare const NcRuleSchema: z.ZodObject<{
                 "addon-updated": "addon-updated";
                 "server-updated": "server-updated";
                 "export-completed": "export-completed";
+                "backup-completed": "backup-completed";
                 "camera-online": "camera-online";
                 "camera-offline": "camera-offline";
                 "camera-disabled": "camera-disabled";
@@ -1727,6 +1745,8 @@ export declare const NcHistorySubjectSchema: z.ZodObject<{
             "device-enabled": "device-enabled";
             "device-battery-low": "device-battery-low";
             "device-battery-normal": "device-battery-normal";
+            "device-consumable-low": "device-consumable-low";
+            "device-consumable-normal": "device-consumable-normal";
             "stream-online": "stream-online";
             "stream-offline": "stream-offline";
             "node-online": "node-online";
@@ -1745,6 +1765,7 @@ export declare const NcHistorySubjectSchema: z.ZodObject<{
             "addon-updated": "addon-updated";
             "server-updated": "server-updated";
             "export-completed": "export-completed";
+            "backup-completed": "backup-completed";
             "camera-online": "camera-online";
             "camera-offline": "camera-offline";
             "camera-disabled": "camera-disabled";
@@ -1813,6 +1834,8 @@ export declare const NcHistoryEntrySchema: z.ZodObject<{
                 "device-enabled": "device-enabled";
                 "device-battery-low": "device-battery-low";
                 "device-battery-normal": "device-battery-normal";
+                "device-consumable-low": "device-consumable-low";
+                "device-consumable-normal": "device-consumable-normal";
                 "stream-online": "stream-online";
                 "stream-offline": "stream-offline";
                 "node-online": "node-online";
@@ -1831,6 +1854,7 @@ export declare const NcHistoryEntrySchema: z.ZodObject<{
                 "addon-updated": "addon-updated";
                 "server-updated": "server-updated";
                 "export-completed": "export-completed";
+                "backup-completed": "backup-completed";
                 "camera-online": "camera-online";
                 "camera-offline": "camera-offline";
                 "camera-disabled": "camera-disabled";
@@ -2116,6 +2140,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -2134,6 +2160,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -2378,6 +2405,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -2396,6 +2425,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -2638,6 +2668,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -2656,6 +2688,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -2892,6 +2925,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -2910,6 +2945,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -3243,6 +3279,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -3261,6 +3299,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -3410,6 +3449,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -3428,6 +3469,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -3718,6 +3760,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -3736,6 +3780,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -4073,6 +4118,8 @@ export declare const notificationRulesCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -4091,6 +4138,7 @@ export declare const notificationRulesCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";

package/dist/capabilities/osd-manager.cap.d.ts

@@ -151,6 +151,8 @@ export declare const OsdSlotBindingSchema: z.ZodObject<{
                 "device-enabled": "device-enabled";
                 "device-battery-low": "device-battery-low";
                 "device-battery-normal": "device-battery-normal";
+                "device-consumable-low": "device-consumable-low";
+                "device-consumable-normal": "device-consumable-normal";
                 "stream-online": "stream-online";
                 "stream-offline": "stream-offline";
                 "node-online": "node-online";
@@ -169,6 +171,7 @@ export declare const OsdSlotBindingSchema: z.ZodObject<{
                 "addon-updated": "addon-updated";
                 "server-updated": "server-updated";
                 "export-completed": "export-completed";
+                "backup-completed": "backup-completed";
                 "camera-online": "camera-online";
                 "camera-offline": "camera-offline";
                 "camera-disabled": "camera-disabled";
@@ -319,6 +322,8 @@ export declare const OsdSlotViewSchema: z.ZodObject<{
                     "device-enabled": "device-enabled";
                     "device-battery-low": "device-battery-low";
                     "device-battery-normal": "device-battery-normal";
+                    "device-consumable-low": "device-consumable-low";
+                    "device-consumable-normal": "device-consumable-normal";
                     "stream-online": "stream-online";
                     "stream-offline": "stream-offline";
                     "node-online": "node-online";
@@ -337,6 +342,7 @@ export declare const OsdSlotViewSchema: z.ZodObject<{
                     "addon-updated": "addon-updated";
                     "server-updated": "server-updated";
                     "export-completed": "export-completed";
+                    "backup-completed": "backup-completed";
                     "camera-online": "camera-online";
                     "camera-offline": "camera-offline";
                     "camera-disabled": "camera-disabled";
@@ -559,6 +565,8 @@ export declare const osdManagerCapability: {
                                 "device-enabled": "device-enabled";
                                 "device-battery-low": "device-battery-low";
                                 "device-battery-normal": "device-battery-normal";
+                                "device-consumable-low": "device-consumable-low";
+                                "device-consumable-normal": "device-consumable-normal";
                                 "stream-online": "stream-online";
                                 "stream-offline": "stream-offline";
                                 "node-online": "node-online";
@@ -577,6 +585,7 @@ export declare const osdManagerCapability: {
                                 "addon-updated": "addon-updated";
                                 "server-updated": "server-updated";
                                 "export-completed": "export-completed";
+                                "backup-completed": "backup-completed";
                                 "camera-online": "camera-online";
                                 "camera-offline": "camera-offline";
                                 "camera-disabled": "camera-disabled";
@@ -816,6 +825,8 @@ export declare const osdManagerCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -834,6 +845,7 @@ export declare const osdManagerCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";
@@ -983,6 +995,8 @@ export declare const osdManagerCapability: {
                                 "device-enabled": "device-enabled";
                                 "device-battery-low": "device-battery-low";
                                 "device-battery-normal": "device-battery-normal";
+                                "device-consumable-low": "device-consumable-low";
+                                "device-consumable-normal": "device-consumable-normal";
                                 "stream-online": "stream-online";
                                 "stream-offline": "stream-offline";
                                 "node-online": "node-online";
@@ -1001,6 +1015,7 @@ export declare const osdManagerCapability: {
                                 "addon-updated": "addon-updated";
                                 "server-updated": "server-updated";
                                 "export-completed": "export-completed";
+                                "backup-completed": "backup-completed";
                                 "camera-online": "camera-online";
                                 "camera-offline": "camera-offline";
                                 "camera-disabled": "camera-disabled";
@@ -1182,6 +1197,8 @@ export declare const osdManagerCapability: {
                             "device-enabled": "device-enabled";
                             "device-battery-low": "device-battery-low";
                             "device-battery-normal": "device-battery-normal";
+                            "device-consumable-low": "device-consumable-low";
+                            "device-consumable-normal": "device-consumable-normal";
                             "stream-online": "stream-online";
                             "stream-offline": "stream-offline";
                             "node-online": "node-online";
@@ -1200,6 +1217,7 @@ export declare const osdManagerCapability: {
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
+                            "backup-completed": "backup-completed";
                             "camera-online": "camera-online";
                             "camera-offline": "camera-offline";
                             "camera-disabled": "camera-disabled";

package/dist/capabilities/stream-broker.cap.d.ts

@@ -543,6 +543,43 @@ export declare const streamBrokerCapability: {
     readonly mode: "singleton";
     readonly exposesDeviceSettings: true;
     readonly methods: {
+        /**
+         * A device reporting that one of ITS OWN signals just fired.
+         *
+         * The provider calls this; nothing polls. The broker then decides whether
+         * to wake the source, and the decision has two terms that must BOTH hold:
+         *
+         *  - the signal is ENABLED for this camera (the operator's per-camera
+         *    choice — a camera may declare a signal the operator does not want
+         *    waking anything), and
+         *  - a consumer is actually attached and waiting on the prestream. Waking
+         *    a camera nobody is watching is the one thing a battery camera must
+         *    never do, and a signal arriving with no consumer is exactly that.
+         *
+         * Reported, never inferred: a signal that fires while the stream is
+         * already up refreshes the hold instead of starting a second one, which is
+         * what makes continuous motion keep a camera awake without stacking
+         * timers.
+         *
+         * `code` is the provider's own, from `streamSignals.listSignals`. An
+         * unknown code is REFUSED rather than treated as a wildcard wake — a
+         * provider and an operator disagreeing about a name must not become a
+         * camera that wakes for everything.
+         */
+        readonly reportStreamSignal: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            code: z.ZodString;
+            at: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            accepted: z.ZodBoolean;
+            reason: z.ZodEnum<{
+                woke: "woke";
+                "hold-extended": "hold-extended";
+                "not-enabled": "not-enabled";
+                "no-consumer": "no-consumer";
+                "unknown-code": "unknown-code";
+            }>;
+        }, z.core.$strip>, "mutation">;
         readonly publishCameraStream: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
             camStreamId: z.ZodString;