@camstack/types 0.1.14 → 0.1.16

package/dist/device/system-mirror.d.ts

@@ -0,0 +1,318 @@
+/**
+ * SystemMirror — system-wide reactive view of every device, like
+ * Scrypted's `systemManager.getDeviceById`. One warm-boot fetches the
+ * full bindings + runtime-state snapshot + device metadata; live
+ * `device.state-changed`, `capability.binding-changed`,
+ * `device.registered`, `device.unregistered`, and `device.updated`
+ * events keep the in-memory mirrors fresh. Subsequent
+ * `getDeviceById(id)` calls are sync.
+ *
+ * Renamed from `SystemManager` (and its file `system-manager.ts`) when
+ * the SDK introduced a top-level `System` facade. The cluster-wide
+ * mirror is one of `System`'s collaborators — calling it a "mirror"
+ * disambiguates from the new public class. The old export name is
+ * still available as a deprecated alias from this file.
+ *
+ * Cap-agnostic by construction: the state mirror is `Map<deviceId,
+ * Map<capName, slice>>` and the proxies are produced by the
+ * codegen'd `createDeviceProxy` we already use everywhere — so a
+ * brand-new cap with `runtimeState:` lights up here without a single
+ * line of additional code.
+ *
+ * Two transports today, same shape:
+ *   - tRPC client (browser, Electron, SDK consumers).
+ *   - In-process AddonApi (server REPL, addons that want a global view).
+ *
+ * Boot:
+ *
+ *   const sm = new SystemMirror(api)
+ *   await sm.init()
+ *
+ *   const dev = sm.getDeviceById(8)            // sync
+ *   dev?.state.battery.value?.sleeping         // sync read from mirror
+ *   await dev?.snapshot?.getSnapshot({...})    // method dispatch via cap-router
+ *
+ *   sm.query({ addonId: 'reolink', online: true })
+ *   sm.whereState('battery', s => s.percentage < 20)
+ *   sm.listenCap('motion', (id, slice) => …)
+ *   await sm.waitForState(8, 'battery', s => !s.sleeping, 30_000)
+ *
+ * Lifecycle: caller is responsible for `dispose()` when done — closes
+ * the live event subscriptions.
+ */
+import type { DeviceBinding } from './device-binding.js';
+import { type DeviceProxy } from '../generated/device-proxy.js';
+import type { DeviceInfo } from '../capabilities/device-manager.cap.js';
+import { DeviceType } from './device-type.js';
+import { type SliceHandleApi } from './device-state-handle.js';
+/**
+ * Minimal subset of `AddonApi` the SystemMirror needs.
+ */
+export interface SystemMirrorApi extends SliceHandleApi {
+    readonly deviceManager: {
+        readonly getAllBindings: {
+            query(input: Record<string, never>): Promise<ReadonlyArray<DeviceBinding>>;
+        };
+        readonly listAll: {
+            query(input: {
+                addonId?: string;
+            }): Promise<ReadonlyArray<DeviceInfo>>;
+        };
+    };
+    readonly deviceState: SliceHandleApi['deviceState'] & {
+        readonly getAllSnapshots: {
+            query(input: Record<string, never>): Promise<Record<string, Record<string, Record<string, unknown>>>>;
+        };
+    };
+}
+export type SystemMirrorListener = (deviceId: number, capName: string, slice: Record<string, unknown> | undefined) => void;
+export type DeviceCapListener = (deviceId: number, slice: Record<string, unknown> | undefined) => void;
+export type DeviceLifecycleListener = (deviceId: number, info: DeviceInfo | null) => void;
+/**
+ * Match shape — `string` is exact match, `RegExp` is regex match,
+ * `{ contains }` is case-insensitive substring, `{ exact }` is the
+ * verbose form of plain string. Useful for `query({ name: ... })`
+ * where the same field accepts multiple match modes.
+ */
+export type StringMatch = string | RegExp | {
+    readonly exact: string;
+} | {
+    readonly contains: string;
+};
+/**
+ * Filter set for `query()`. All fields are optional and ANDed
+ * together. Array values are ORed within a single field
+ * (`addonId: ['a', 'b']` matches devices owned by either). The
+ * `where` escape hatch runs LAST so the structured filters do the
+ * cheap rejection first.
+ */
+export interface DeviceQueryFilters {
+    /** Match by exact deviceId. Single value or array (OR'd). */
+    readonly id?: number | readonly number[];
+    /** Match by exact stableId. Single value or array. */
+    readonly stableId?: string | readonly string[];
+    /** Match by owning addonId. Single value or array. */
+    readonly addonId?: string | readonly string[];
+    /** Match by `DeviceType` enum value. Single value or array. */
+    readonly type?: DeviceType | readonly DeviceType[];
+    /** Match devices that bind ALL listed caps. Single capName or array. */
+    readonly caps?: string | readonly string[];
+    /** Match devices that bind ANY of the listed caps. Mutually exclusive
+     *  with `caps`. */
+    readonly anyCap?: string | readonly string[];
+    /** Match by device name. */
+    readonly name?: StringMatch;
+    /** Match the `online` flag. */
+    readonly online?: boolean;
+    /** Match by parent device id. Pass `null` for top-level devices. */
+    readonly parentDeviceId?: number | null;
+    /** Match devices that expose a feature (e.g. `'BatteryOperated'`). */
+    readonly feature?: string | readonly string[];
+    /** Match `isCamera` flag. */
+    readonly isCamera?: boolean;
+    /** Custom predicate. Runs last; receives both metadata and proxy. */
+    readonly where?: (info: DeviceInfo, proxy: DeviceProxy) => boolean;
+}
+export declare class SystemMirror {
+    private readonly api;
+    /** deviceId → capName → slice (push-driven mirror). */
+    private readonly stateMirror;
+    /** deviceId → binding (warm-boot + binding-changed events). */
+    private readonly bindings;
+    /** deviceId → metadata (warm-boot + lifecycle events). */
+    private readonly devices;
+    /** Listener map for individual `(deviceId, capName)` watches —
+     *  shared with every `MirrorSource` we hand out. */
+    private readonly handleListeners;
+    /** Global state-change listeners registered via `listen()`. */
+    private readonly globalStateListeners;
+    /** Per-cap state listeners registered via `listenCap(capName, …)`. */
+    private readonly capListeners;
+    /** Per-device state listeners registered via `listenDevice(id, …)`. */
+    private readonly deviceListeners;
+    /** Lifecycle listeners. */
+    private readonly addedListeners;
+    private readonly removedListeners;
+    /** waitForState pending requests — keyed by an internal counter. */
+    private readonly pendingWaits;
+    /** Memoised state source — every proxy shares it. */
+    private readonly stateSource;
+    /** Live event bridges — closed in `dispose()`. */
+    private bridges;
+    private initialized;
+    private initPromise;
+    constructor(api: SystemMirrorApi);
+    /**
+     * Warm-boot: three round-trips (bindings + snapshots + listAll) and
+     * then the live event subscriptions. Idempotent — concurrent callers
+     * await the same in-flight Promise.
+     *
+     * Each warm-boot query is wrapped in a 15s timeout so a missing
+     * endpoint or stuck broker poll surfaces as a clear error instead
+     * of silently hanging the caller forever. The default is generous
+     * enough for cluster-wide setups but short enough for ops to
+     * notice and fix the underlying transport issue.
+     */
+    init(timeoutMs?: number): Promise<void>;
+    /** True after `init()` resolves. */
+    isReady(): boolean;
+    /** Promise that resolves once `init()` has completed. */
+    awaitReady(): Promise<void>;
+    /**
+     * Tear down the event bridges + clear listener registries. Existing
+     * proxy references become inert (slice reads keep working off the
+     * stale mirror, but no further updates arrive).
+     */
+    dispose(): void;
+    /** Sync lookup by numeric id. `null` if unknown. */
+    getDeviceById(deviceId: number): DeviceProxy | null;
+    /** Sync lookup by display name (exact match). `null` if unknown. */
+    getDeviceByName(name: string): DeviceProxy | null;
+    /** Sync lookup by stableId (the addon-scoped external id). */
+    getDeviceByStableId(stableId: string): DeviceProxy | null;
+    /** All devices owned by an addon. */
+    getDevicesByAddon(addonId: string): readonly DeviceProxy[];
+    /** All devices of a given `DeviceType`. */
+    getDevicesByType(type: DeviceType): readonly DeviceProxy[];
+    /**
+     * Live metadata snapshot for a device. Same shape as
+     * `deviceManager.getDevice(id)`; sync from the mirror.
+     */
+    getDeviceInfo(deviceId: number): DeviceInfo | null;
+    /** Snapshot of every known device as a typed proxy. */
+    getAllDevices(): readonly DeviceProxy[];
+    /** Filter devices by cap presence — shorthand for `query({caps: capName})`. */
+    filterByCap(capName: string): readonly DeviceProxy[];
+    /**
+     * Filter the fleet against a structured filter set. All fields ANDed,
+     * arrays ORed within a single field. Returns proxies — chain with
+     * cap-method calls or state reads as needed.
+     *
+     * Examples:
+     *
+     *   sm.query({ addonId: 'reolink', online: true })
+     *   sm.query({ type: DeviceType.Camera, caps: ['snapshot', 'motion'] })
+     *   sm.query({ id: [1, 2, 3] })
+     *   sm.query({ name: { contains: 'sala' } })
+     *   sm.query({ name: /^cam-\d+$/ })
+     *   sm.query({ parentDeviceId: 8 })  // accessories of cam 8
+     *   sm.query({ where: (info, dev) => dev.state.battery.value?.sleeping })
+     */
+    query(filters?: DeviceQueryFilters): readonly DeviceProxy[];
+    /**
+     * Return every proxy whose runtime-state slice for `capName` matches
+     * `predicate`. Devices without the cap or without a slice are
+     * skipped. The predicate receives a typed slice reference — pass
+     * the typed cap (e.g. `'battery'`) and TypeScript widens to
+     * `Record<string, unknown>`; cast inside the predicate body if the
+     * caller knows the cap shape.
+     */
+    whereState<T extends Record<string, unknown> = Record<string, unknown>>(capName: string, predicate: (slice: T, deviceId: number) => boolean): readonly DeviceProxy[];
+    /** Map every device's slice for `capName` to a derived value. Devices
+     *  without the cap or without a slice are skipped. */
+    mapState<T extends Record<string, unknown> = Record<string, unknown>, R = unknown>(capName: string, mapper: (slice: T, deviceId: number) => R): readonly R[];
+    /** First device whose slice matches `predicate`, or null. */
+    findState<T extends Record<string, unknown> = Record<string, unknown>>(capName: string, predicate: (slice: T, deviceId: number) => boolean): DeviceProxy | null;
+    /** Count devices that bind a cap. Faster than `filterByCap(...).length`. */
+    countByCap(capName: string): number;
+    /** Count devices whose slice for `capName` matches `predicate`. */
+    countByState<T extends Record<string, unknown> = Record<string, unknown>>(capName: string, predicate: (slice: T, deviceId: number) => boolean): number;
+    /**
+     * Global listener — fires for every `device.state-changed` event the
+     * mirror absorbs.
+     */
+    listen(cb: SystemMirrorListener): () => void;
+    /**
+     * Per-cap listener — fires only for state changes on `capName`,
+     * across every device. The callback receives the deviceId so the
+     * caller can route.
+     */
+    listenCap(capName: string, cb: DeviceCapListener): () => void;
+    /**
+     * Per-device listener — fires for every cap change on `deviceId`.
+     */
+    listenDevice(deviceId: number, cb: SystemMirrorListener): () => void;
+    /** Fires when `device.registered` lands. Receives the new metadata. */
+    onDeviceAdded(cb: DeviceLifecycleListener): () => void;
+    /** Fires when `device.unregistered` lands. `info` is the LAST-known
+     *  metadata (or null if the device was never seen). */
+    onDeviceRemoved(cb: DeviceLifecycleListener): () => void;
+    /**
+     * Resolve when `predicate` over the runtime-state slice for
+     * `(deviceId, capName)` becomes true. Resolves immediately if the
+     * current slice already matches. Rejects with `Error('timeout')`
+     * after `timeoutMs` (default 30s; pass `Infinity` to wait forever).
+     *
+     * Returns the matching slice — caller can read it directly without
+     * a second mirror lookup.
+     */
+    waitForState<T extends Record<string, unknown> = Record<string, unknown>>(deviceId: number, capName: string, predicate: (slice: T) => boolean, timeoutMs?: number): Promise<T>;
+    /**
+     * Resolve when a device with `deviceId` becomes available (a
+     * binding exists). Resolves immediately if already known. Rejects
+     * with timeout.
+     */
+    waitForDevice(deviceId: number, timeoutMs?: number): Promise<DeviceProxy>;
+    /**
+     * Iterate every device that binds `capName`. Awaits each callback
+     * sequentially — for parallel use `invokeCap` with explicit
+     * parallelism.
+     */
+    forEachCap(capName: string, cb: (proxy: DeviceProxy) => void | Promise<void>): Promise<void>;
+    /**
+     * Invoke a cap method on every device that binds the cap. Returns
+     * one result per device, success or failure isolated. Optional
+     * parallelism cap — useful for "snapshot all cameras but only 4
+     * at a time so battery cams don't all wake at once".
+     *
+     * Example:
+     *
+     *   const results = await sm.invokeCap('snapshot', 'getSnapshot', {}, { parallelism: 4 })
+     *   const failed = results.filter(r => !r.ok)
+     */
+    invokeCap<R = unknown>(capName: string, methodName: string, args: Record<string, unknown>, opts?: {
+        parallelism?: number;
+    }): Promise<ReadonlyArray<{
+        deviceId: number;
+        ok: boolean;
+        result?: R;
+        error?: unknown;
+    }>>;
+    /**
+     * One-shot summary — fleet size, breakdown by cap / addon / type.
+     * Designed for REPL inspection (`sm.summary()`).
+     */
+    summary(): {
+        totalDevices: number;
+        online: number;
+        offline: number;
+        byCap: Record<string, number>;
+        byAddon: Record<string, number>;
+        byType: Record<string, number>;
+        statedDevices: number;
+    };
+    /**
+     * Debug-friendly dump — full state + binding + metadata for one
+     * device or all devices. Cheap deep clone so caller mutations don't
+     * leak into the mirror.
+     */
+    dump(deviceId?: number): unknown;
+    /**
+     * Direct read-only access to the underlying state mirror. Use
+     * sparingly — `getSystemState` returns a deep copy that's safer for
+     * exploratory work; this avoids the clone cost when iterating
+     * thousands of slices.
+     */
+    getRawMirror(): ReadonlyMap<number, ReadonlyMap<string, Record<string, unknown>>>;
+    /**
+     * Snapshot of the full state mirror — same shape as the warm-boot
+     * payload. Deep-cloned; safe to mutate.
+     */
+    getSystemState(): Map<number, Map<string, Record<string, unknown>>>;
+    private subscribeBus;
+    private applyStateUpdate;
+    private applyDeviceRemoval;
+    private refreshBinding;
+    private refreshDeviceMetadata;
+}
+//# sourceMappingURL=system-mirror.d.ts.map

package/dist/device/system-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-mirror.d.ts","sourceRoot":"","sources":["../../src/device/system-mirror.ts"],"names":[],"mappings":"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"}

package/dist/device/zod-to-config-ui.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import type { ConfigUISchema } from '../interfaces/config-ui.js';
+export interface DeviceConfigEntry {
+    key: string;
+    schema: z.ZodType;
+    value: unknown;
+    description?: string;
+}
+/**
+ * Convert DeviceConfig.entries() output to ConfigUISchema for the admin UI FormBuilder.
+ *
+ * Each entry's Zod type is inspected to determine the correct ConfigField type:
+ * - ZodString → 'text' (or 'password' when key contains "password"/"secret"/"token"/"apikey")
+ * - ZodNumber → 'number' (extracts min/max/step from Zod v4 checks)
+ * - ZodBoolean → 'boolean'
+ * - ZodEnum → 'select' (options built from enum values)
+ * - Anything else → 'text' fallback
+ *
+ * Wrapper types ZodDefault, ZodOptional, and ZodNullable are unwrapped transparently.
+ * Default values are extracted from ZodDefault wrappers.
+ */
+export declare function zodEntriesToConfigUI(entries: readonly DeviceConfigEntry[], sectionTitle?: string, sectionId?: string): ConfigUISchema;
+//# sourceMappingURL=zod-to-config-ui.d.ts.map

package/dist/device/zod-to-config-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-config-ui.d.ts","sourceRoot":"","sources":["../../src/device/zod-to-config-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EACV,cAAc,EAQf,MAAM,4BAA4B,CAAA;AAInC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,CAAC,CAAC,OAAO,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAqCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,YAAY,SAAkB,EAC9B,SAAS,SAAS,GACjB,cAAc,CAchB"}

package/dist/disposer-chain.d.ts

@@ -0,0 +1,32 @@
+export type DisposerFn = () => void | Promise<void>;
+export interface DisposerChainOptions {
+    /** Logged when an individual disposer throws. Defaults to console.error. */
+    onError?: (err: unknown, index: number) => void;
+}
+export declare class DisposerChain {
+    private disposers;
+    private disposed;
+    private readonly onError;
+    constructor(opts?: DisposerChainOptions);
+    /**
+     * Register a teardown callback. Returns an unregister function so
+     * callers can drop a single disposer without disposing the whole
+     * chain.
+     *
+     * If the chain has already been disposed, the callback runs immediately
+     * (sync) — this matches the “register-after-shutdown” edge case where
+     * an addon's late initialization races with kernel restart.
+     */
+    add(fn: DisposerFn): () => void;
+    /** True after `dispose()` has been called at least once. */
+    get isDisposed(): boolean;
+    /** Number of disposers currently registered. */
+    get size(): number;
+    /**
+     * Run every registered disposer in LIFO order. Idempotent: subsequent
+     * calls do nothing. Awaits async disposers so callers can sequence
+     * shutdown → restart correctly.
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=disposer-chain.d.ts.map

package/dist/disposer-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposer-chain.d.ts","sourceRoot":"","sources":["../src/disposer-chain.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,UAAU,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEnD,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAChD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;gBAEnD,IAAI,GAAE,oBAAyB;IAS3C;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,IAAI;IAoB/B,4DAA4D;IAC5D,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB/B"}