@camstack/types 1.2.16 → 1.2.18

package/dist/capabilities/local-network.cap.d.ts

@@ -74,6 +74,16 @@ declare const ConnectionEndpointSchema: z.ZodObject<{
     plausibleReason: z.ZodString;
     priority: z.ZodNumber;
 }, z.core.$strip>;
+/**
+ * The chosen outbound endpoint for notification artifacts. `baseUrl: null` =
+ * AUTO (resolved from the candidate ranking at send time); `resolved` reports
+ * what AUTO currently picks, so the UI can show the effective value either way.
+ */
+declare const NotificationEndpointSchema: z.ZodObject<{
+    baseUrl: z.ZodNullable<z.ZodString>;
+    resolved: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type NotificationEndpoint = z.infer<typeof NotificationEndpointSchema>;
 export declare const localNetworkCapability: {
     readonly name: "local-network";
     readonly scope: "system";
@@ -180,6 +190,34 @@ export declare const localNetworkCapability: {
                 priority: z.ZodNumber;
             }, z.core.$strip>>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * The endpoint OUTBOUND artifacts must be addressed by — notification
+         * attachment links and deep links. `baseUrl: null` means AUTO: the first
+         * public candidate (a configured origin, then a connected tunnel, then the
+         * LAN), never loopback.
+         *
+         * Why an explicit marker: the automatic ranking cannot know which of
+         * several reachable addresses the RECIPIENT can actually open. A link is
+         * consumed on someone's phone, off the LAN, possibly hours later — and a
+         * link nobody can open is worse than no link, because the notification
+         * arrives advertising media that 404s.
+         */
+        readonly getNotificationEndpoint: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            baseUrl: z.ZodNullable<z.ZodString>;
+            resolved: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Mark which endpoint notification artifacts use. `baseUrl: null` restores
+         * AUTO. The value is stored verbatim (not an index into the candidate
+         * list): interfaces come and go, and an index would silently re-point at a
+         * different address after a reboot.
+         */
+        readonly setNotificationEndpoint: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            baseUrl: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            baseUrl: z.ZodNullable<z.ZodString>;
+            resolved: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
         /**
          * Read the operator's allowlist. Empty = "auto" (no filter). Used
          * by the admin UI's address selector to seed its checkbox state.

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

@@ -14,9 +14,9 @@ import { DeviceType } from '../device/device-type.js';
  * fetch — same pattern as `PanTiltZoom` for cameras.
  */
 export declare const MediaPlayerStateSchema: z.ZodEnum<{
+    off: "off";
     idle: "idle";
     playing: "playing";
-    off: "off";
     on: "on";
     paused: "paused";
     buffering: "buffering";
@@ -24,8 +24,8 @@ export declare const MediaPlayerStateSchema: z.ZodEnum<{
 }>;
 export type MediaPlayerState = z.infer<typeof MediaPlayerStateSchema>;
 export declare const MediaPlayerRepeatSchema: z.ZodEnum<{
-    all: "all";
     off: "off";
+    all: "all";
     one: "one";
 }>;
 export type MediaPlayerRepeat = z.infer<typeof MediaPlayerRepeatSchema>;
@@ -39,9 +39,9 @@ declare const MediaInfoSchema: z.ZodObject<{
 export type MediaInfo = z.infer<typeof MediaInfoSchema>;
 export declare const MediaPlayerStatusSchema: z.ZodObject<{
     state: z.ZodEnum<{
+        off: "off";
         idle: "idle";
         playing: "playing";
-        off: "off";
         on: "on";
         paused: "paused";
         buffering: "buffering";
@@ -62,8 +62,8 @@ export declare const MediaPlayerStatusSchema: z.ZodObject<{
     durationMs: z.ZodNullable<z.ZodNumber>;
     shuffle: z.ZodNullable<z.ZodBoolean>;
     repeat: z.ZodNullable<z.ZodEnum<{
-        all: "all";
         off: "off";
+        all: "all";
         one: "one";
     }>>;
     lastChangedAt: z.ZodNumber;
@@ -110,8 +110,8 @@ export declare const mediaPlayerCapability: {
         readonly setRepeat: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
             repeat: z.ZodEnum<{
-                all: "all";
                 off: "off";
+                all: "all";
                 one: "one";
             }>;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
@@ -128,9 +128,9 @@ export declare const mediaPlayerCapability: {
     readonly status: {
         readonly schema: z.ZodObject<{
             state: z.ZodEnum<{
+                off: "off";
                 idle: "idle";
                 playing: "playing";
-                off: "off";
                 on: "on";
                 paused: "paused";
                 buffering: "buffering";
@@ -151,8 +151,8 @@ export declare const mediaPlayerCapability: {
             durationMs: z.ZodNullable<z.ZodNumber>;
             shuffle: z.ZodNullable<z.ZodBoolean>;
             repeat: z.ZodNullable<z.ZodEnum<{
-                all: "all";
                 off: "off";
+                all: "all";
                 one: "one";
             }>>;
             lastChangedAt: z.ZodNumber;
@@ -166,9 +166,9 @@ export declare const mediaPlayerCapability: {
      */
     readonly runtimeState: z.ZodObject<{
         state: z.ZodEnum<{
+            off: "off";
             idle: "idle";
             playing: "playing";
-            off: "off";
             on: "on";
             paused: "paused";
             buffering: "buffering";
@@ -189,8 +189,8 @@ export declare const mediaPlayerCapability: {
         durationMs: z.ZodNullable<z.ZodNumber>;
         shuffle: z.ZodNullable<z.ZodBoolean>;
         repeat: z.ZodNullable<z.ZodEnum<{
-            all: "all";
             off: "off";
+            all: "all";
             one: "one";
         }>>;
         lastChangedAt: z.ZodNumber;

package/dist/capabilities/metrics-provider.cap.d.ts

@@ -172,8 +172,8 @@ declare const AddonInstanceSchema: z.ZodObject<{
         running: "running";
         stopped: "stopped";
         starting: "starting";
-        stopping: "stopping";
         crashed: "crashed";
+        stopping: "stopping";
     }>;
     uptimeSec: z.ZodNumber;
 }, z.core.$strip>;
@@ -468,8 +468,8 @@ export declare const metricsProviderCapability: {
                 running: "running";
                 stopped: "stopped";
                 starting: "starting";
-                stopping: "stopping";
                 crashed: "crashed";
+                stopping: "stopping";
             }>;
             uptimeSec: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;

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

@@ -10,10 +10,10 @@ import { type InferProvider } from './capability-definition.js';
  * - `tls-error` — TLS handshake failed (cert / SNI / cipher)
  */
 declare const BrokerStatusSchema: z.ZodEnum<{
-    unreachable: "unreachable";
     connected: "connected";
     disconnected: "disconnected";
     "auth-failed": "auth-failed";
+    unreachable: "unreachable";
     "tls-error": "tls-error";
 }>;
 declare const BrokerInfoSchema: z.ZodObject<{
@@ -25,10 +25,10 @@ declare const BrokerInfoSchema: z.ZodObject<{
         embedded: "embedded";
     }>;
     status: z.ZodEnum<{
-        unreachable: "unreachable";
         connected: "connected";
         disconnected: "disconnected";
         "auth-failed": "auth-failed";
+        unreachable: "unreachable";
         "tls-error": "tls-error";
     }>;
     latencyMs: z.ZodNullable<z.ZodNumber>;
@@ -90,10 +90,10 @@ export declare const mqttBrokerCapability: {
                 embedded: "embedded";
             }>;
             status: z.ZodEnum<{
-                unreachable: "unreachable";
                 connected: "connected";
                 disconnected: "disconnected";
                 "auth-failed": "auth-failed";
+                unreachable: "unreachable";
                 "tls-error": "tls-error";
             }>;
             latencyMs: z.ZodNullable<z.ZodNumber>;

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

@@ -199,6 +199,8 @@ export declare const TargetKindSchema: z.ZodObject<{
     label: z.ZodString;
     icon: z.ZodString;
     addonId: z.ZodString;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    iconMediaType: z.ZodOptional<z.ZodString>;
     configSchema: z.ZodUnknown;
     supportsDiscovery: z.ZodBoolean;
     caps: z.ZodObject<{
@@ -326,6 +328,8 @@ export declare const notificationOutputCapability: {
             label: z.ZodString;
             icon: z.ZodString;
             addonId: z.ZodString;
+            iconUrl: z.ZodOptional<z.ZodString>;
+            iconMediaType: z.ZodOptional<z.ZodString>;
             configSchema: z.ZodUnknown;
             supportsDiscovery: z.ZodBoolean;
             caps: z.ZodObject<{