@camstack/types 0.1.40 → 0.1.42

package/dist/capabilities/device-discovery.cap.d.ts

@@ -1,15 +1,15 @@
 import { z } from 'zod';
 import { type InferProvider, type InferNativeProvider } from './capability-definition.js';
 import { DeviceType } from '../device/device-type.js';
+import type { SourceInfo } from '../device/source-info.js';
 /**
  * device-discovery — device-scoped capability for parents that host /
  * enumerate child devices (Reolink Hub / NVR, ONVIF gateway, future
- * integrations). Mirrors Scrypted's `DeviceDiscovery` interface
- * (`scrypted-reolink-native/src/nvr.ts:42-44`): the parent advertises
- * a list of discoverable children, and the operator promotes a subset
- * to real devices via `adoptDevice`. Child lifecycle (kernel device
- * create/remove, parent reference) is owned by the framework so a
- * single shared `<DiscoveryPanel />` can drive any integration.
+ * integrations). The parent advertises a list of discoverable children,
+ * and the operator promotes a subset to real devices via `adoptDevice`.
+ * Child lifecycle (kernel device create/remove, parent reference) is
+ * owned by the framework so a single shared `<DiscoveryPanel />` can
+ * drive any integration.
  *
  * Boundaries:
  *   - The cap exposes ENUMERATION + ADOPT/RELEASE only. The protocol
@@ -34,34 +34,39 @@ export declare const DiscoveredChildStatusSchema: z.ZodEnum<{
 }>;
 export type DiscoveredChildStatus = z.infer<typeof DiscoveredChildStatusSchema>;
 /**
- * Single discovered child entry. `metadata` is integration-defined
- * but intentionally typed as a closed shape with the most-common
- * camera knobs — keeps the panel renderer dumb without forcing every
- * integration to invent a custom UI.
+ * Explicit type for the (now self-referential) discovered-child entry.
+ * A `z.lazy` schema cannot cleanly self-infer, so the shape is declared
+ * here and the schema below is annotated with it. The `children` /
+ * `sourceInfo` / `capabilities` / `features` fields are optional: Hubs
+ * (Reolink NVR enumerating flat camera channels) omit them entirely;
+ * integrations (Home Assistant previewing a device with entity-children)
+ * populate them so a shared adoption panel can render an accordion.
  */
-export declare const DiscoveredChildDeviceSchema: z.ZodObject<{
-    childNativeId: z.ZodString;
-    name: z.ZodString;
-    type: z.ZodEnum<typeof DeviceType>;
-    status: z.ZodEnum<{
-        unknown: "unknown";
-        sleeping: "sleeping";
-        offline: "offline";
-        online: "online";
-    }>;
-    metadata: z.ZodDefault<z.ZodObject<{
-        model: z.ZodOptional<z.ZodString>;
-        serialNumber: z.ZodOptional<z.ZodString>;
-        uid: z.ZodOptional<z.ZodString>;
-        rtspChannel: z.ZodOptional<z.ZodNumber>;
-        isBattery: z.ZodOptional<z.ZodBoolean>;
-        isDoorbell: z.ZodOptional<z.ZodBoolean>;
-        isMultifocal: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    alreadyAdopted: z.ZodBoolean;
-    adoptedDeviceId: z.ZodNullable<z.ZodNumber>;
-}, z.core.$strip>;
-export type DiscoveredChildDevice = z.infer<typeof DiscoveredChildDeviceSchema>;
+export type DiscoveredChildDevice = {
+    childNativeId: string;
+    name: string;
+    type: DeviceType;
+    status: DiscoveredChildStatus;
+    metadata: {
+        model?: string;
+        serialNumber?: string;
+        uid?: string;
+        rtspChannel?: number;
+        isBattery?: boolean;
+        isDoorbell?: boolean;
+        isMultifocal?: boolean;
+        externalLocation?: string;
+        manufacturer?: string;
+        integration?: string;
+    };
+    alreadyAdopted: boolean;
+    adoptedDeviceId: number | null;
+    capabilities?: readonly string[];
+    features?: readonly string[];
+    sourceInfo?: SourceInfo;
+    children?: readonly DiscoveredChildDevice[];
+};
+export declare const DiscoveredChildDeviceSchema: z.ZodType<DiscoveredChildDevice>;
 /**
  * Status block — populated by the integration after each
  * `refreshDiscovery` (or push-driven update). The runtime-state slice
@@ -69,28 +74,7 @@ export type DiscoveredChildDevice = z.infer<typeof DiscoveredChildDeviceSchema>;
  * returns the same payload via the codegen'd auto-injection.
  */
 export declare const DeviceDiscoveryStatusSchema: z.ZodObject<{
-    discovered: z.ZodArray<z.ZodObject<{
-        childNativeId: z.ZodString;
-        name: z.ZodString;
-        type: z.ZodEnum<typeof DeviceType>;
-        status: z.ZodEnum<{
-            unknown: "unknown";
-            sleeping: "sleeping";
-            offline: "offline";
-            online: "online";
-        }>;
-        metadata: z.ZodDefault<z.ZodObject<{
-            model: z.ZodOptional<z.ZodString>;
-            serialNumber: z.ZodOptional<z.ZodString>;
-            uid: z.ZodOptional<z.ZodString>;
-            rtspChannel: z.ZodOptional<z.ZodNumber>;
-            isBattery: z.ZodOptional<z.ZodBoolean>;
-            isDoorbell: z.ZodOptional<z.ZodBoolean>;
-            isMultifocal: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>;
-        alreadyAdopted: z.ZodBoolean;
-        adoptedDeviceId: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>>;
+    discovered: z.ZodArray<z.ZodType<DiscoveredChildDevice, unknown, z.core.$ZodTypeInternals<DiscoveredChildDevice, unknown>>>;
     lastDiscoveryAt: z.ZodNullable<z.ZodNumber>;
     lastError: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -98,60 +82,19 @@ export type DeviceDiscoveryStatus = z.infer<typeof DeviceDiscoveryStatusSchema>;
 export declare const deviceDiscoveryCapability: {
     readonly name: "device-discovery";
     readonly scope: "device";
+    readonly deviceNative: true;
     readonly mode: "singleton";
     readonly deviceTypes: readonly [DeviceType.Hub];
     readonly status: {
         readonly schema: z.ZodObject<{
-            discovered: z.ZodArray<z.ZodObject<{
-                childNativeId: z.ZodString;
-                name: z.ZodString;
-                type: z.ZodEnum<typeof DeviceType>;
-                status: z.ZodEnum<{
-                    unknown: "unknown";
-                    sleeping: "sleeping";
-                    offline: "offline";
-                    online: "online";
-                }>;
-                metadata: z.ZodDefault<z.ZodObject<{
-                    model: z.ZodOptional<z.ZodString>;
-                    serialNumber: z.ZodOptional<z.ZodString>;
-                    uid: z.ZodOptional<z.ZodString>;
-                    rtspChannel: z.ZodOptional<z.ZodNumber>;
-                    isBattery: z.ZodOptional<z.ZodBoolean>;
-                    isDoorbell: z.ZodOptional<z.ZodBoolean>;
-                    isMultifocal: z.ZodOptional<z.ZodBoolean>;
-                }, z.core.$strip>>;
-                alreadyAdopted: z.ZodBoolean;
-                adoptedDeviceId: z.ZodNullable<z.ZodNumber>;
-            }, z.core.$strip>>;
+            discovered: z.ZodArray<z.ZodType<DiscoveredChildDevice, unknown, z.core.$ZodTypeInternals<DiscoveredChildDevice, unknown>>>;
             lastDiscoveryAt: z.ZodNullable<z.ZodNumber>;
             lastError: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>;
         readonly kind: "poll";
     };
     readonly runtimeState: z.ZodObject<{
-        discovered: z.ZodArray<z.ZodObject<{
-            childNativeId: z.ZodString;
-            name: z.ZodString;
-            type: z.ZodEnum<typeof DeviceType>;
-            status: z.ZodEnum<{
-                unknown: "unknown";
-                sleeping: "sleeping";
-                offline: "offline";
-                online: "online";
-            }>;
-            metadata: z.ZodDefault<z.ZodObject<{
-                model: z.ZodOptional<z.ZodString>;
-                serialNumber: z.ZodOptional<z.ZodString>;
-                uid: z.ZodOptional<z.ZodString>;
-                rtspChannel: z.ZodOptional<z.ZodNumber>;
-                isBattery: z.ZodOptional<z.ZodBoolean>;
-                isDoorbell: z.ZodOptional<z.ZodBoolean>;
-                isMultifocal: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>>;
-            alreadyAdopted: z.ZodBoolean;
-            adoptedDeviceId: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>>;
+        discovered: z.ZodArray<z.ZodType<DiscoveredChildDevice, unknown, z.core.$ZodTypeInternals<DiscoveredChildDevice, unknown>>>;
         lastDiscoveryAt: z.ZodNullable<z.ZodNumber>;
         lastError: z.ZodNullable<z.ZodString>;
         lastFetchedAt: z.ZodNumber;
@@ -164,28 +107,7 @@ export declare const deviceDiscoveryCapability: {
          */
         readonly listDiscovered: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            childNativeId: z.ZodString;
-            name: z.ZodString;
-            type: z.ZodEnum<typeof DeviceType>;
-            status: z.ZodEnum<{
-                unknown: "unknown";
-                sleeping: "sleeping";
-                offline: "offline";
-                online: "online";
-            }>;
-            metadata: z.ZodDefault<z.ZodObject<{
-                model: z.ZodOptional<z.ZodString>;
-                serialNumber: z.ZodOptional<z.ZodString>;
-                uid: z.ZodOptional<z.ZodString>;
-                rtspChannel: z.ZodOptional<z.ZodNumber>;
-                isBattery: z.ZodOptional<z.ZodBoolean>;
-                isDoorbell: z.ZodOptional<z.ZodBoolean>;
-                isMultifocal: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>>;
-            alreadyAdopted: z.ZodBoolean;
-            adoptedDeviceId: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodType<DiscoveredChildDevice, unknown, z.core.$ZodTypeInternals<DiscoveredChildDevice, unknown>>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Force the integration to re-enumerate and update the
          * runtime-state slice. Returns the freshly-enumerated list (also
@@ -193,28 +115,7 @@ export declare const deviceDiscoveryCapability: {
          */
         readonly refreshDiscovery: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            childNativeId: z.ZodString;
-            name: z.ZodString;
-            type: z.ZodEnum<typeof DeviceType>;
-            status: z.ZodEnum<{
-                unknown: "unknown";
-                sleeping: "sleeping";
-                offline: "offline";
-                online: "online";
-            }>;
-            metadata: z.ZodDefault<z.ZodObject<{
-                model: z.ZodOptional<z.ZodString>;
-                serialNumber: z.ZodOptional<z.ZodString>;
-                uid: z.ZodOptional<z.ZodString>;
-                rtspChannel: z.ZodOptional<z.ZodNumber>;
-                isBattery: z.ZodOptional<z.ZodBoolean>;
-                isDoorbell: z.ZodOptional<z.ZodBoolean>;
-                isMultifocal: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>>;
-            alreadyAdopted: z.ZodBoolean;
-            adoptedDeviceId: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>>>, "mutation">;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodType<DiscoveredChildDevice, unknown, z.core.$ZodTypeInternals<DiscoveredChildDevice, unknown>>>>, "mutation">;
         /**
          * Promote a discovered entry to a real child device. The framework
          * creates the child via `kernel.devices.create()` with

package/dist/capabilities/device-discovery.cap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-discovery.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/device-discovery.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAC5H,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;EAAuD,CAAA;AAC/F,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;iBA2BtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAiBlC;;;;WAIG;;;;;;;;;;;;;;;;;;;;;;;;;QAKH;;;;WAIG;;;;;;;;;;;;;;;;;;;;;;;;;QAMH;;;;;;WAMG;;;;;;;;;QAcH;;;;;WAKG;;;;;;CAUkC,CAAA;AAEzC,MAAM,MAAM,wBAAwB,GAAG,aAAa,CAAC,OAAO,yBAAyB,CAAC,CAAA;AACtF,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,CAAC,OAAO,yBAAyB,CAAC,CAAA"}
+{"version":3,"file":"device-discovery.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/device-discovery.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAC5H,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;EAAuD,CAAA;AAC/F,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAA;CAC5C,CAAA;AAED,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CA+CxE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;iBAMtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;QAkBlC;;;;WAIG;;;;QAKH;;;;WAIG;;;;QAMH;;;;;;WAMG;;;;;;;;;QAcH;;;;;WAKG;;;;;;CAUkC,CAAA;AAEzC,MAAM,MAAM,wBAAwB,GAAG,aAAa,CAAC,OAAO,yBAAyB,CAAC,CAAA;AACtF,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,CAAC,OAAO,yBAAyB,CAAC,CAAA"}