@camstack/types 1.2.16 → 1.2.18

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

@@ -50,7 +50,6 @@ export declare const BrokerAudioClientSchema: z.ZodObject<{
  */
 export declare const BrokerConsumerKindSchema: z.ZodEnum<{
     unknown: "unknown";
-    snapshot: "snapshot";
     alexa: "alexa";
     homekit: "homekit";
     "webrtc-browser": "webrtc-browser";
@@ -60,13 +59,13 @@ export declare const BrokerConsumerKindSchema: z.ZodEnum<{
     "derived-broker": "derived-broker";
     recording: "recording";
     pipeline: "pipeline";
+    snapshot: "snapshot";
     warmup: "warmup";
 }>;
 export type BrokerConsumerKind = z.infer<typeof BrokerConsumerKindSchema>;
 export declare const BrokerConsumerAttributionSchema: z.ZodReadonly<z.ZodObject<{
     kind: z.ZodEnum<{
         unknown: "unknown";
-        snapshot: "snapshot";
         alexa: "alexa";
         homekit: "homekit";
         "webrtc-browser": "webrtc-browser";
@@ -76,13 +75,14 @@ export declare const BrokerConsumerAttributionSchema: z.ZodReadonly<z.ZodObject<
         "derived-broker": "derived-broker";
         recording: "recording";
         pipeline: "pipeline";
+        snapshot: "snapshot";
         warmup: "warmup";
     }>;
     label: z.ZodOptional<z.ZodString>;
     media: z.ZodOptional<z.ZodEnum<{
         audio: "audio";
-        both: "both";
         video: "video";
+        both: "both";
     }>>;
     targetCodec: z.ZodOptional<z.ZodString>;
     transport: z.ZodOptional<z.ZodEnum<{
@@ -106,7 +106,6 @@ export declare const BrokerEncodedClientSchema: z.ZodObject<{
     attribution: z.ZodReadonly<z.ZodObject<{
         kind: z.ZodEnum<{
             unknown: "unknown";
-            snapshot: "snapshot";
             alexa: "alexa";
             homekit: "homekit";
             "webrtc-browser": "webrtc-browser";
@@ -116,13 +115,14 @@ export declare const BrokerEncodedClientSchema: z.ZodObject<{
             "derived-broker": "derived-broker";
             recording: "recording";
             pipeline: "pipeline";
+            snapshot: "snapshot";
             warmup: "warmup";
         }>;
         label: z.ZodOptional<z.ZodString>;
         media: z.ZodOptional<z.ZodEnum<{
             audio: "audio";
-            both: "both";
             video: "video";
+            both: "both";
         }>>;
         targetCodec: z.ZodOptional<z.ZodString>;
         transport: z.ZodOptional<z.ZodEnum<{
@@ -172,7 +172,6 @@ export declare const BrokerClientsSchema: z.ZodObject<{
         attribution: z.ZodReadonly<z.ZodObject<{
             kind: z.ZodEnum<{
                 unknown: "unknown";
-                snapshot: "snapshot";
                 alexa: "alexa";
                 homekit: "homekit";
                 "webrtc-browser": "webrtc-browser";
@@ -182,13 +181,14 @@ export declare const BrokerClientsSchema: z.ZodObject<{
                 "derived-broker": "derived-broker";
                 recording: "recording";
                 pipeline: "pipeline";
+                snapshot: "snapshot";
                 warmup: "warmup";
             }>;
             label: z.ZodOptional<z.ZodString>;
             media: z.ZodOptional<z.ZodEnum<{
                 audio: "audio";
-                both: "both";
                 video: "video";
+                both: "both";
             }>>;
             targetCodec: z.ZodOptional<z.ZodString>;
             transport: z.ZodOptional<z.ZodEnum<{
@@ -213,8 +213,8 @@ export type BrokerDecodedClient = z.infer<typeof BrokerDecodedClientSchema>;
 export type BrokerAudioClient = z.infer<typeof BrokerAudioClientSchema>;
 export type BrokerClients = z.infer<typeof BrokerClientsSchema>;
 export declare const PlaceholderReasonSchema: z.ZodEnum<{
-    reconnecting: "reconnecting";
     sleeping: "sleeping";
+    reconnecting: "reconnecting";
     offline: "offline";
     disabled: "disabled";
     waking: "waking";
@@ -386,6 +386,52 @@ export declare const streamBrokerCapability: {
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Render a short GIF or MP4 from the broker's PRE-BUFFER around an instant.
+         *
+         * The pre-buffer is the only source that already holds the seconds BEFORE
+         * an event (it is what it exists for — "when an addon needs the last N
+         * seconds of video for clip creation"). Cutting from recorded segments
+         * cannot: only finalized segments are addressable and the one covering the
+         * moment is still being written, so a segment-sourced clip is either
+         * delayed or shows the approach instead of the event (operator,
+         * 2026-07-30). It also means a camera does not have to be RECORDING to
+         * produce a notification clip.
+         *
+         * Returns muxed BYTES, never packets: the frame plane never crosses a
+         * process boundary at frame rate (D9/D18) — this is one compressed,
+         * on-demand payload per notification.
+         *
+         * Waits up to `postRollSec` for the tail to accumulate, so the window is
+         * CENTRED on `aroundMs`.
+         */
+        readonly renderPreBufferClip: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            profile: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
+            aroundMs: z.ZodNumber;
+            preRollSec: z.ZodDefault<z.ZodNumber>;
+            postRollSec: z.ZodDefault<z.ZodNumber>;
+            format: z.ZodDefault<z.ZodEnum<{
+                gif: "gif";
+                mp4: "mp4";
+            }>>;
+            maxWidth: z.ZodDefault<z.ZodNumber>;
+            fps: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            base64: z.ZodString;
+            mime: z.ZodString;
+            bytes: z.ZodNumber;
+            profile: z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         readonly listAllCameraStreams: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             camStreamId: z.ZodString;
             deviceId: z.ZodNumber;
@@ -421,9 +467,9 @@ export declare const streamBrokerCapability: {
             sourceCamStreamId: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 error: "error";
+                connecting: "connecting";
                 unassigned: "unassigned";
                 idle: "idle";
-                connecting: "connecting";
                 streaming: "streaming";
             }>;
             resolution: z.ZodOptional<z.ZodObject<{
@@ -439,8 +485,8 @@ export declare const streamBrokerCapability: {
         }, z.core.$strip>, z.ZodObject<{
             status: z.ZodEnum<{
                 error: "error";
-                idle: "idle";
                 connecting: "connecting";
+                idle: "idle";
                 streaming: "streaming";
                 stopped: "stopped";
             }>;
@@ -515,7 +561,6 @@ export declare const streamBrokerCapability: {
                 attribution: z.ZodReadonly<z.ZodObject<{
                     kind: z.ZodEnum<{
                         unknown: "unknown";
-                        snapshot: "snapshot";
                         alexa: "alexa";
                         homekit: "homekit";
                         "webrtc-browser": "webrtc-browser";
@@ -525,13 +570,14 @@ export declare const streamBrokerCapability: {
                         "derived-broker": "derived-broker";
                         recording: "recording";
                         pipeline: "pipeline";
+                        snapshot: "snapshot";
                         warmup: "warmup";
                     }>;
                     label: z.ZodOptional<z.ZodString>;
                     media: z.ZodOptional<z.ZodEnum<{
                         audio: "audio";
-                        both: "both";
                         video: "video";
+                        both: "both";
                     }>>;
                     targetCodec: z.ZodOptional<z.ZodString>;
                     transport: z.ZodOptional<z.ZodEnum<{

package/dist/capabilities/webrtc-session.cap.d.ts

@@ -67,8 +67,8 @@ export declare const WebrtcStreamChoiceSchema: z.ZodObject<{
     }, z.core.$strip>>;
     status: z.ZodNullable<z.ZodEnum<{
         error: "error";
-        idle: "idle";
         connecting: "connecting";
+        idle: "idle";
         streaming: "streaming";
         stopped: "stopped";
     }>>;
@@ -132,8 +132,8 @@ export declare const webrtcSessionCapability: {
             }, z.core.$strip>>;
             status: z.ZodNullable<z.ZodEnum<{
                 error: "error";
-                idle: "idle";
                 connecting: "connecting";
+                idle: "idle";
                 streaming: "streaming";
                 stopped: "stopped";
             }>>;
@@ -174,7 +174,6 @@ export declare const webrtcSessionCapability: {
             consumerAttribution: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
                 kind: z.ZodEnum<{
                     unknown: "unknown";
-                    snapshot: "snapshot";
                     alexa: "alexa";
                     homekit: "homekit";
                     "webrtc-browser": "webrtc-browser";
@@ -184,13 +183,14 @@ export declare const webrtcSessionCapability: {
                     "derived-broker": "derived-broker";
                     recording: "recording";
                     pipeline: "pipeline";
+                    snapshot: "snapshot";
                     warmup: "warmup";
                 }>;
                 label: z.ZodOptional<z.ZodString>;
                 media: z.ZodOptional<z.ZodEnum<{
                     audio: "audio";
-                    both: "both";
                     video: "video";
+                    both: "both";
                 }>>;
                 targetCodec: z.ZodOptional<z.ZodString>;
                 transport: z.ZodOptional<z.ZodEnum<{
@@ -245,7 +245,6 @@ export declare const webrtcSessionCapability: {
             consumerAttribution: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
                 kind: z.ZodEnum<{
                     unknown: "unknown";
-                    snapshot: "snapshot";
                     alexa: "alexa";
                     homekit: "homekit";
                     "webrtc-browser": "webrtc-browser";
@@ -255,13 +254,14 @@ export declare const webrtcSessionCapability: {
                     "derived-broker": "derived-broker";
                     recording: "recording";
                     pipeline: "pipeline";
+                    snapshot: "snapshot";
                     warmup: "warmup";
                 }>;
                 label: z.ZodOptional<z.ZodString>;
                 media: z.ZodOptional<z.ZodEnum<{
                     audio: "audio";
-                    both: "both";
                     video: "video";
+                    both: "both";
                 }>>;
                 targetCodec: z.ZodOptional<z.ZodString>;
                 transport: z.ZodOptional<z.ZodEnum<{

package/dist/enums/event-category.d.ts

@@ -267,6 +267,19 @@ export declare enum EventCategory {
      * without filtering on `capName`.
      */
     DeviceStateChanged = "device.state-changed",
+    /**
+     * Frame occupancy for a camera CHANGED — a tracked object was gained or
+     * lost. Carries `{ deviceId, totalObjects, byClass, zones }`.
+     *
+     * Emitted only on a change, so a steady scene is silent. It exists so a
+     * client can stop polling `zoneAnalytics.getCurrentSnapshot`: that was the
+     * one live badge with no push signal at all, and it cost a request every
+     * four seconds per visible camera.
+     *
+     * Like every event it is telemetry and may be dropped ([D8]) — a consumer
+     * keeps a slow reconcile rather than trusting it alone.
+     */
+    ZoneAnalyticsOccupancyChanged = "zone-analytics.occupancy-changed",
     /**
      * Cap event fired by every device that registers the `battery`
      * capability. Mirrors the cap definition's `onStatusChanged`. Carries

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-Cdyife4p.js");
+const require_event_category = require("./event-category-39bpf1r_.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-BLcNejAE.mjs";
+import { t as EventCategory } from "./event-category-Bz24uP1U.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-Cdyife4p.js → event-category-39bpf1r_.js}

@@ -269,6 +269,19 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["DeviceStateChanged"] = "device.state-changed";
 	/**
+	* Frame occupancy for a camera CHANGED — a tracked object was gained or
+	* lost. Carries `{ deviceId, totalObjects, byClass, zones }`.
+	*
+	* Emitted only on a change, so a steady scene is silent. It exists so a
+	* client can stop polling `zoneAnalytics.getCurrentSnapshot`: that was the
+	* one live badge with no push signal at all, and it cost a request every
+	* four seconds per visible camera.
+	*
+	* Like every event it is telemetry and may be dropped ([D8]) — a consumer
+	* keeps a slow reconcile rather than trusting it alone.
+	*/
+	EventCategory["ZoneAnalyticsOccupancyChanged"] = "zone-analytics.occupancy-changed";
+	/**
 	* Cap event fired by every device that registers the `battery`
 	* capability. Mirrors the cap definition's `onStatusChanged`. Carries
 	* `{ deviceId, status: BatteryStatus }`. Subscribers (alert center,

package/dist/{event-category-BLcNejAE.mjs → event-category-Bz24uP1U.mjs}

@@ -269,6 +269,19 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["DeviceStateChanged"] = "device.state-changed";
 	/**
+	* Frame occupancy for a camera CHANGED — a tracked object was gained or
+	* lost. Carries `{ deviceId, totalObjects, byClass, zones }`.
+	*
+	* Emitted only on a change, so a steady scene is silent. It exists so a
+	* client can stop polling `zoneAnalytics.getCurrentSnapshot`: that was the
+	* one live badge with no push signal at all, and it cost a request every
+	* four seconds per visible camera.
+	*
+	* Like every event it is telemetry and may be dropped ([D8]) — a consumer
+	* keeps a slow reconcile rather than trusting it alone.
+	*/
+	EventCategory["ZoneAnalyticsOccupancyChanged"] = "zone-analytics.occupancy-changed";
+	/**
 	* Cap event fired by every device that registers the `battery`
 	* capability. Mirrors the cap definition's `onStatusChanged`. Carries
 	* `{ deviceId, status: BatteryStatus }`. Subscribers (alert center,