@camstack/types 1.2.65 → 1.2.67

package/dist/capabilities/lawn-mower-control.cap.d.ts

@@ -109,5 +109,12 @@ export declare const lawnMowerControlCapability: {
         }>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — as `vacuum-control`.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type ILawnMowerControlProvider = InferProvider<typeof lawnMowerControlCapability>;

package/dist/capabilities/lock-control.cap.d.ts

@@ -87,5 +87,15 @@ export declare const lockControlCapability: {
         }>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — a lock left locked must still read locked.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastChangedAt"];
 };
 export type ILockControlProvider = InferProvider<typeof lockControlCapability>;

package/dist/capabilities/media-player.cap.d.ts

@@ -195,6 +195,13 @@ export declare const mediaPlayerCapability: {
         }>>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — a restored transport position describes a playback that stopped when the hub did.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IMediaPlayerProvider = InferProvider<typeof mediaPlayerCapability>;
 export {};

package/dist/capabilities/motion-trigger.cap.d.ts

@@ -74,5 +74,12 @@ export declare const motionTriggerCapability: {
         lastChangedAt: z.ZodNumber;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — the authority for motion-trigger enablement is the provider's own config; the slice is a mirror of it, re-published on connect.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IMotionTriggerProvider = InferProvider<typeof motionTriggerCapability>;

package/dist/capabilities/motion-zones.cap.d.ts

@@ -160,5 +160,15 @@ export declare const motionZonesCapability: {
         }, z.core.$strip>>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — the 14 KB polygon list is the single largest slice on the fleet and has not changed since the operator drew it. Highest value per byte in the table.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type IMotionZonesProvider = InferNativeProvider<typeof motionZonesCapability>;

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

@@ -129,5 +129,12 @@ export declare const motionCapability: {
         lastDetectedAt: z.ZodNullable<z.ZodNumber>;
         autoClearAfterMs: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — self-clearing by construction (`autoClearAfterMs`); a restored `detected: true` is a frozen event, and the next frame re-publishes the real one.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
 };
 export type IMotionProvider = InferProvider<typeof motionCapability>;

package/dist/capabilities/native-object-detection.cap.d.ts

@@ -193,5 +193,15 @@ export declare const nativeObjectDetectionCapability: {
         enabled: z.ZodBoolean;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **restored** — `enabled` is an operator toggle on a camera whose refresh is a no-op and whose staleMs is Infinity. There is no hardware value to re-read — losing it loses the setting.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "restored";
+    /** Clock fields: written, but excluded from the compare that decides
+     *  whether persisting is worth a SQLite commit. */
+    readonly volatileStateFields: readonly ["lastFetchedAt"];
 };
 export type INativeObjectDetectionProvider = InferProvider<typeof nativeObjectDetectionCapability>;

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

@@ -82,8 +82,30 @@ export type NotificationFormat = z.infer<typeof NotificationFormatSchema>;
  * Named by INTENT, never by glyph. "check" would tie the vocabulary to one
  * renderer's icon set; "acknowledge" survives an adapter that draws it
  * differently.
+ *
+ * ── A TOKEN IS NOT A WIRE VALUE ─────────────────────────────────────
+ *
+ * These names are for US. **No adapter may forward one verbatim.** Each maps
+ * the whole set onto its own renderer's vocabulary through a
+ * `Record<NotificationActionIcon, string>` — a Record, never a lookup with a
+ * fallback, so adding a member here fails every adapter's build until someone
+ * decides its glyph, which is the only place that decision can be made
+ * honestly.
+ *
+ * This paragraph is the bug. Zentik declared `actionIcons: true` and passed
+ * `disarm` straight through; iOS feeds that string to
+ * `UNNotificationActionIcon(systemImageName:)`, `disarm` is not an SF Symbol,
+ * and every snooze and alarm button arrived BLANK. A pass-through is not a
+ * mapping, and "the field is documented" is not "the value renders".
+ *
+ * Adding a member is TRAIN-BOUND. The enum lives in the published
+ * `@camstack/server` closure and the cap seam validates against the HUB's copy,
+ * so an addon that emits a token the running hub does not know does not lose an
+ * icon — its whole `send` fails Zod validation and the notification never
+ * arrives. Never emit a new token from an addon before the train carrying it.
  */
 export declare const NotificationActionIconSchema: z.ZodEnum<{
+    camera: "camera";
     light: "light";
     lock: "lock";
     view: "view";
@@ -96,6 +118,10 @@ export declare const NotificationActionIconSchema: z.ZodEnum<{
     play: "play";
     acknowledge: "acknowledge";
     silence: "silence";
+    snooze: "snooze";
+    "arm-home": "arm-home";
+    "arm-away": "arm-away";
+    "arm-night": "arm-night";
     alert: "alert";
 }>;
 export type NotificationActionIcon = z.infer<typeof NotificationActionIconSchema>;
@@ -105,6 +131,7 @@ export declare const NotificationActionSchema: z.ZodObject<{
     label: z.ZodString;
     url: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodEnum<{
+        camera: "camera";
         light: "light";
         lock: "lock";
         view: "view";
@@ -117,9 +144,17 @@ export declare const NotificationActionSchema: z.ZodObject<{
         play: "play";
         acknowledge: "acknowledge";
         silence: "silence";
+        snooze: "snooze";
+        "arm-home": "arm-home";
+        "arm-away": "arm-away";
+        "arm-night": "arm-night";
         alert: "alert";
     }>>;
     destructive: z.ZodOptional<z.ZodBoolean>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        navigate: "navigate";
+        background: "background";
+    }>>;
 }, z.core.$strip>;
 export type NotificationAction = z.infer<typeof NotificationActionSchema>;
 /**
@@ -159,6 +194,7 @@ export declare const NotificationSchema: z.ZodObject<{
         label: z.ZodString;
         url: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodEnum<{
+            camera: "camera";
             light: "light";
             lock: "lock";
             view: "view";
@@ -171,9 +207,17 @@ export declare const NotificationSchema: z.ZodObject<{
             play: "play";
             acknowledge: "acknowledge";
             silence: "silence";
+            snooze: "snooze";
+            "arm-home": "arm-home";
+            "arm-away": "arm-away";
+            "arm-night": "arm-night";
             alert: "alert";
         }>>;
         destructive: z.ZodOptional<z.ZodBoolean>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            navigate: "navigate";
+            background: "background";
+        }>>;
     }, z.core.$strip>>>;
     sound: z.ZodOptional<z.ZodString>;
     ttl: z.ZodOptional<z.ZodNumber>;
@@ -484,6 +528,7 @@ export declare const notificationOutputCapability: {
                     label: z.ZodString;
                     url: z.ZodOptional<z.ZodString>;
                     icon: z.ZodOptional<z.ZodEnum<{
+                        camera: "camera";
                         light: "light";
                         lock: "lock";
                         view: "view";
@@ -496,9 +541,17 @@ export declare const notificationOutputCapability: {
                         play: "play";
                         acknowledge: "acknowledge";
                         silence: "silence";
+                        snooze: "snooze";
+                        "arm-home": "arm-home";
+                        "arm-away": "arm-away";
+                        "arm-night": "arm-night";
                         alert: "alert";
                     }>>;
                     destructive: z.ZodOptional<z.ZodBoolean>;
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        navigate: "navigate";
+                        background: "background";
+                    }>>;
                 }, z.core.$strip>>>;
                 sound: z.ZodOptional<z.ZodString>;
                 ttl: z.ZodOptional<z.ZodNumber>;
@@ -554,6 +607,7 @@ export declare const notificationOutputCapability: {
                     label: z.ZodString;
                     url: z.ZodOptional<z.ZodString>;
                     icon: z.ZodOptional<z.ZodEnum<{
+                        camera: "camera";
                         light: "light";
                         lock: "lock";
                         view: "view";
@@ -566,9 +620,17 @@ export declare const notificationOutputCapability: {
                         play: "play";
                         acknowledge: "acknowledge";
                         silence: "silence";
+                        snooze: "snooze";
+                        "arm-home": "arm-home";
+                        "arm-away": "arm-away";
+                        "arm-night": "arm-night";
                         alert: "alert";
                     }>>;
                     destructive: z.ZodOptional<z.ZodBoolean>;
+                    mode: z.ZodOptional<z.ZodEnum<{
+                        navigate: "navigate";
+                        background: "background";
+                    }>>;
                 }, z.core.$strip>>>;
                 sound: z.ZodOptional<z.ZodString>;
                 ttl: z.ZodOptional<z.ZodNumber>;