@camstack/sdk 0.1.54 → 0.1.56

package/dist/system.d.ts

@@ -11,7 +11,7 @@
  * — a future phase will narrow the surface further.
  */
 import { createWSClient, type TRPCClient } from '@trpc/client';
-import type { DeviceProxy, DeviceQueryFilters, DeviceLifecycleListener, SystemProxy } from '@camstack/types';
+import type { DeviceProxy, DeviceInfo, DeviceQueryFilters, DeviceLifecycleListener, SystemProxy } from '@camstack/types';
 import type { BackendAppRouter } from './backend-router.js';
 import type { BackendConnectionState } from './types.js';
 /**
@@ -232,6 +232,19 @@ export declare class System {
      * make a separate `deviceManager.getBindings` round-trip.
      */
     listDevices(filters?: DeviceQueryFilters): readonly DeviceProxy[];
+    /**
+     * Sync `DeviceInfo` snapshot (name, canonical type, online, …) for one device
+     * from the warm-boot mirror — `null` if the mirror isn't booted or the device
+     * is unknown. Unlike a `DeviceProxy` (cap accessors only), this carries the
+     * display identity the UI needs to render a device on first paint.
+     */
+    getDeviceInfo(deviceId: number): DeviceInfo | null;
+    /**
+     * The `DeviceInfo` snapshots for the current device set (the warm-boot cache),
+     * honouring the same `filters` as {@link listDevices}. Lets a UI render a named
+     * device list immediately without waiting for per-device lifecycle events.
+     */
+    listDeviceInfos(filters?: DeviceQueryFilters): readonly DeviceInfo[];
     /**
      * Sync lookup by numeric id. `null` if the mirror has not been booted
      * or the device is unknown.
@@ -276,8 +289,6 @@ export declare class System {
     get pipelineExecutor(): SystemProxy['pipelineExecutor'];
     get pipelineOrchestrator(): SystemProxy['pipelineOrchestrator'];
     get pipelineRunner(): SystemProxy['pipelineRunner'];
-    get platformProbe(): SystemProxy['platformProbe'];
-    get recordingEngine(): SystemProxy['recordingEngine'];
     get settingsStore(): SystemProxy['settingsStore'];
     get storage(): SystemProxy['storage'];
     get streamBroker(): SystemProxy['streamBroker'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/sdk",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",

package/dist/adaptive-stream.d.ts

@@ -1,91 +0,0 @@
-/**
- * Adaptive Stream Session — negotiates optimal stream quality with the proxy.
- *
- * The client reports viewport size and network conditions periodically.
- * The proxy selects the best stream from the provider's available streams
- * and instructs the client to switch via go2rtc stream renegotiation.
- *
- * Flow:
- * 1. Client opens session → sends initial constraints (viewport, network)
- * 2. Server evaluates available streams → picks optimal → responds with stream assignment
- * 3. Client connects to assigned go2rtc stream via WebRTC WHEP
- * 4. Periodically, client reports updated stats → server may switch stream
- * 5. On switch: client tears down old PC, creates new PC to new go2rtc stream
- */
-/** Client-reported constraints for stream selection. */
-export interface StreamConstraints {
-    /** Viewport width in CSS pixels. */
-    viewportWidth: number;
-    /** Viewport height in CSS pixels. */
-    viewportHeight: number;
-    /** Device pixel ratio (retina = 2+). */
-    pixelRatio?: number;
-    /** Estimated downlink bandwidth in Mbps (from navigator.connection or WebRTC stats). */
-    bandwidthMbps?: number;
-    /** Round-trip time in ms (from WebRTC stats). */
-    rttMs?: number;
-    /** Packet loss ratio 0-1 (from WebRTC stats). */
-    packetLoss?: number;
-    /** Whether the client is on a cellular network. */
-    isCellular?: boolean;
-    /** Whether the client prefers low latency over quality. */
-    preferLowLatency?: boolean;
-    /** Maximum resolution the client wants (e.g., from a user setting). */
-    maxResolution?: "auto" | "high" | "medium" | "low";
-}
-/** Server-assigned stream for the client. */
-export interface StreamAssignment {
-    /** go2rtc stream name to connect to. */
-    streamName: string;
-    /** Stream profile (main/sub/ext). */
-    profile: string;
-    /** Transport type (native/rtsp/rtmp). */
-    transport: string;
-    /** Human-readable label. */
-    label: string;
-    /** Stream metadata (if known). */
-    metadata?: {
-        width?: number;
-        height?: number;
-        fps?: number;
-        bitrate?: number;
-        codec?: string;
-    };
-    /** Reason for this selection. */
-    reason: string;
-}
-/** Stream selection request from client → server. */
-export interface StreamSelectionRequest {
-    providerId: string;
-    camera: string;
-    constraints: StreamConstraints;
-    /** Current stream (for comparison — only switch if significantly better). */
-    currentStreamName?: string;
-}
-/** Stream selection response from server → client. */
-export interface StreamSelectionResponse {
-    assignment: StreamAssignment;
-    /** Available alternatives the client can manually pick. */
-    alternatives: StreamAssignment[];
-    /** Seconds until next automatic re-evaluation. */
-    nextEvalSeconds: number;
-}
-/**
- * Select the optimal stream from available options based on client constraints.
- * This is a pure function — no side effects.
- */
-export declare function selectOptimalStream(streams: Array<{
-    streamName: string;
-    profile: string;
-    transport: string;
-    label: string;
-    metadata?: {
-        width?: number;
-        height?: number;
-        fps?: number;
-        bitrate?: number;
-        codec?: string;
-    };
-}>, constraints: StreamConstraints, defaultTransport?: string): StreamAssignment | null;
-/** Determine seconds until next re-evaluation based on stability. */
-export declare function getNextEvalInterval(constraints: StreamConstraints, wasSwitch: boolean): number;