@camstack/system 1.2.390 → 1.2.391

package/dist/builtins/device-manager/device-projection.d.ts

@@ -1,85 +1,71 @@
-import { ICameraDevice, IDevice, IDeviceRegistry, SourceInfo, DeviceFeature, DeviceRole, DeviceType } from '@camstack/types';
-import { PersistedDeviceMeta } from './device-meta-types.js';
 /**
- * Return true when `err` is a transient Moleculer error that is worth
- * retrying — specifically any `MoleculerRetryableError` subclass
- * (ServiceNotAvailableError, ServiceNotFoundError, BrokerDisconnectedError,
- * RequestTimeoutError, …). Moleculer sets `retryable: true` on all of them.
- *
- * Falls back to a message-substring check for serialised errors that arrive
- * across the Moleculer transport as plain objects rather than real instances.
- */
+* Pure device-projection + small predicate helpers for the device-manager
+* addon. Extracted verbatim from `device-manager.addon.ts`. None of these
+* functions close over the addon instance — they take everything they need
+* as explicit parameters, so they are safe to share across the addon's
+* query / aggregation modules.
+*/
+import type { DeviceInfo, ICameraDevice, IDevice, IDeviceRegistry, SourceInfo } from "@camstack/types";
+import { DeviceFeature, DeviceRole } from "@camstack/types";
+import type { PersistedDeviceMeta } from "./device-meta-types.js";
+/**
+* Return true when `err` is a transient Moleculer error that is worth
+* retrying — specifically any `MoleculerRetryableError` subclass
+* (ServiceNotAvailableError, ServiceNotFoundError, BrokerDisconnectedError,
+* RequestTimeoutError, …). Moleculer sets `retryable: true` on all of them.
+*
+* Falls back to a message-substring check for serialised errors that arrive
+* across the Moleculer transport as plain objects rather than real instances.
+*/
 export declare function isTransientMoleculerError(err: unknown): boolean;
 export declare function shallowEqual(a: Record<string, unknown>, b: Record<string, unknown>): boolean;
 /** Returns true when `x` is a non-null, non-array plain object. */
 export declare function isRecord(x: unknown): x is Record<string, unknown>;
 export declare function isCameraDevice(device: IDevice): device is ICameraDevice;
 /**
- * Validate persisted feature strings against the `DeviceFeature` enum
- * — workers serialise the live `device.features` array (so every entry
- * is a valid enum value at write time) but the persisted blob is loose
- * `string[]` on the wire. The narrow keeps unknown values out of the
- * `getDevice` response without losing the enum-typed contract.
- */
+* Validate persisted feature strings against the `DeviceFeature` enum
+* — workers serialise the live `device.features` array (so every entry
+* is a valid enum value at write time) but the persisted blob is loose
+* `string[]` on the wire. The narrow keeps unknown values out of the
+* `getDevice` response without losing the enum-typed contract.
+*/
 export declare function persistedFeatures(features: readonly string[] | undefined): DeviceFeature[];
 /**
- * Infer `isCamera` from a persisted DeviceType.
- *
- * Live projection uses method presence (`getStreamSources` via
- * `isCameraDevice`). Forked-worker devices have no `IDevice` on the hub, so
- * the persisted fallbacks in `listAll` / `getDevice` / `getChildren` share
- * this one inference — they must not drift (the 4263 Campanello contradiction
- * of 2026-08-31: `listAll` said camera, `getDevice` said not).
- */
+* Infer `isCamera` from a persisted DeviceType.
+*
+* Live projection uses method presence (`getStreamSources` via
+* `isCameraDevice`). Forked-worker devices have no `IDevice` on the hub, so
+* the persisted fallbacks in `listAll` / `getDevice` / `getChildren` share
+* this one inference — they must not drift (the 4263 Campanello contradiction
+* of 2026-08-31: `listAll` said camera, `getDevice` said not).
+*/
 export declare function persistedIsCamera(type: string | undefined): boolean;
 /**
- * Build an identity-only `SourceInfo` from the persisted device config blob.
- *
- * Forked-worker accessory children (e.g. HA sensor entities) persist
- * `entityId` and `system` in their config blob at spawn time. The hub has no
- * live `IDevice` instance for these devices, so the persisted-fallback paths
- * in `listAll` / `getDevice` / `getChildren` must reconstruct the identity
- * `SourceInfo` from the config so dispatch routing keeps working.
- *
- * Rendering metadata (unit, precision) flows live through the cap STATUS SLICE
- * and must NOT be derived here. Only `id` + `system` (+ `uniqueId` when
- * present) are projected — purely identity, never rendering hints.
- *
- * Returns `undefined` when no identity anchor is resolvable (pure identity
- * devices like cameras/hubs that don't carry `entityId`/`system` in their
- * config blob) — the hub synthetic fallback applies in that case.
- */
+* Build an identity-only `SourceInfo` from the persisted device config blob.
+*
+* Forked-worker accessory children (e.g. HA sensor entities) persist
+* `entityId` and `system` in their config blob at spawn time. The hub has no
+* live `IDevice` instance for these devices, so the persisted-fallback paths
+* in `listAll` / `getDevice` / `getChildren` must reconstruct the identity
+* `SourceInfo` from the config so dispatch routing keeps working.
+*
+* Rendering metadata (unit, precision) flows live through the cap STATUS SLICE
+* and must NOT be derived here. Only `id` + `system` (+ `uniqueId` when
+* present) are projected — purely identity, never rendering hints.
+*
+* Returns `undefined` when no identity anchor is resolvable (pure identity
+* devices like cameras/hubs that don't carry `entityId`/`system` in their
+* config blob) — the hub synthetic fallback applies in that case.
+*/
 export declare function buildSourceInfoFromConfig(persistedConfig: Record<string, unknown>, stableId: string, addonId: string): SourceInfo | undefined;
 /** Type guard: a string is a known `DeviceRole` enum member. */
 export declare function isDeviceRole(value: string): value is DeviceRole;
 /** Narrow a persisted role string (sqlite TEXT column) to a `DeviceRole`.
- *  Unknown / null values resolve to `null` so a stale or unrecognised role
- *  never leaks an off-enum string onto the wire shape. */
+*  Unknown / null values resolve to `null` so a stale or unrecognised role
+*  never leaks an off-enum string onto the wire shape. */
 export declare function toDeviceRole(value: string | null | undefined): DeviceRole | null;
-export declare function toDeviceInfo(addonId: string, device: IDevice, metadata?: Record<string, unknown> | null, metaRow?: PersistedDeviceMeta | null): {
-    display?: import('@camstack/types').DeviceDisplayOverride | undefined;
-    childLayout?: import('@camstack/types').ChildLayout | undefined;
-    primaryChildEntityId?: string | null | undefined;
-    linkDeviceId?: number | null | undefined;
-    integrationId?: string | undefined;
-    metadata: Record<string, unknown> | null;
-    secretConfigPaths?: string[];
-    id: number;
-    stableId: string;
-    addonId: string;
-    type: DeviceType;
-    name: string;
-    location: string | null;
-    disabled: boolean;
-    parentDeviceId: number | null;
-    role: DeviceRole | null;
-    online: boolean;
-    probed: boolean;
-    features: DeviceFeature[];
-    isCamera: boolean;
-    config: Record<string, unknown>;
-};
+export declare function toDeviceInfo(addonId: string, device: IDevice, metadata?: Record<string, unknown> | null, metaRow?: PersistedDeviceMeta | null): DeviceInfo;
 export declare function resolveDeviceById(registry: IDeviceRegistry, deviceId: number): {
-    addonId: string;
-    device: IDevice;
+	addonId: string;
+	device: IDevice;
 } | null;

package/dist/builtins/device-manager/device-provider-context.d.ts

@@ -1,102 +1,117 @@
-import { AddonContext, ICapabilityRegistry, IDeviceAdoptionProvider, IDeviceManagerProvider, IDeviceOpsProvider, IDeviceRegistry, InferProvider, deviceProviderCapability } from '@camstack/types';
-import { AdoptionJobEngine } from './adoption-job-engine.js';
-import { BindingsDeps } from './device-bindings-store.js';
-import { DeviceManagerSettings, DeviceMetaStore } from './device-meta-store.js';
-import { FieldClaimsIndex } from './field-claims-index.js';
-import { OwnedCaps } from './field-ownership.js';
-import { MigrationGuard } from './migrate-guard.js';
-import { RemovalFence } from './removal-fence.js';
-import { SecretConfigPathRegistry } from './secret-config-paths.js';
-import { SeedMode } from './device-state-mirror.js';
-import { MirrorWriteHold } from './mirror-row-writer.js';
+/**
+* Shared dependency context for the device-manager provider-method modules
+* (`device-meta-actions`, `device-queries`). The `IDeviceManagerProvider`
+* implementation was a single ~1800-line object literal closing over
+* `onInitialize` locals AND the addon `this`. Splitting it into focused modules
+* requires an explicit context (DI) instead of those captures.
+*
+* `ProviderHost` is the narrow slice of the addon instance the extracted
+* functions reach (mostly private fields exposed through a host object the
+* addon builds). `ProviderContext` bundles that host with the meta store, the
+* settings surface, the hub registry, and the two shared closures
+* (`requireDeviceOps`, `stampIntegrationId`). Behavior is unchanged — the
+* functions read/write exactly the same state the closures did.
+*/
+import type { AddonContext, ICapabilityRegistry, IDeviceAdoptionProvider, IDeviceManagerProvider, IDeviceOpsProvider, IDeviceRegistry, InferProvider } from "@camstack/types";
+import { deviceProviderCapability } from "@camstack/types";
+import type { AdoptionJobEngine } from "./adoption-job-engine.js";
+import type { BindingsDeps } from "./device-bindings-store.js";
+import type { DeviceManagerSettings, DeviceMetaStore } from "./device-meta-store.js";
+import type { FieldClaimsIndex } from "./field-claims-index.js";
+import type { OwnedCaps } from "./field-ownership.js";
+import type { MigrationGuard } from "./migrate-guard.js";
+import type { RemovalFence } from "./removal-fence.js";
+import type { SecretConfigPathRegistry } from "./secret-config-paths.js";
+import type { SeedMode } from "./device-state-mirror.js";
+import type { MirrorWriteHold } from "./mirror-row-writer.js";
 type IDeviceProviderCap = InferProvider<typeof deviceProviderCapability>;
 /**
- * The addon-instance surface the extracted provider functions need. Exposed by
- * the addon as a host object so the functions never capture `this` directly and
- * the addon stays the sole owner of its private state.
- */
+* The addon-instance surface the extracted provider functions need. Exposed by
+* the addon as a host object so the functions never capture `this` directly and
+* the addon stays the sole owner of its private state.
+*/
 export interface ProviderHost {
-    readonly ctx: AddonContext;
-    readonly capabilityRegistry: ICapabilityRegistry | undefined;
-    /** Push-fed remote native-cap cache (numeric deviceId → capName → owner). */
-    readonly remoteNativeCaps: Map<number, Map<string, {
-        addonId: string;
-        nodeId: string;
-    }>>;
-    /**
-     * Seed the runtime-state mirror for a device (no events). `fill` (the boot
-     * path) only fills caps memory lacks; `replace` (the migration reseed) makes
-     * the mirror answer exactly this blob — the row now belongs to different
-     * hardware, so whatever memory held is the wrong device's state (D663).
-     */
-    seedMirror(deviceId: number, blob: Record<string, unknown>, mode?: SeedMode): void;
-    /**
-     * Drain the mirror's debounced writer on these devices and hold it off their
-     * rows until `release` — a migration swapping the rows must not race a write
-     * that read the pre-swap hardware's blob (D663).
-     */
-    holdMirrorWrites(deviceIds: readonly number[], settings: DeviceManagerSettings): Promise<MirrorWriteHold>;
-    /**
-     * The claims the mirror holds for a device — accepted ones included, whose
-     * write-through may not have landed yet. A migration's second look (D663).
-     */
-    mirrorOwnedCaps(deviceId: number): OwnedCaps;
-    /**
-     * Forget a REMOVED device in the mirror: cancel its armed row write, await
-     * one in flight, drop its slices, claims and baseline (D677). Called before
-     * the row is cleared, so no write lands an orphan row after it.
-     */
-    forgetMirrorDevice(deviceId: number): Promise<void>;
-    /** Reset a stale per-session `feature-probe` timestamp before mirror seeding. */
-    withResetSessionProbe(blob: Record<string, unknown>): Record<string, unknown>;
-    /** The per-field claims index (D663) — `removeDevice` prunes a removed device from it. */
-    readonly fieldClaims: FieldClaimsIndex;
-    /** Resolve a device's real `online` flag from the mirrored device-status slice. */
-    resolveDeviceOnline(deviceId: number, fallbackOnline: boolean): boolean;
-    /** Resolve a device's `probed` flag from the mirrored feature-probe slice. */
-    resolveDeviceProbed(deviceId: number): boolean;
-    /** Wait for a device-provider by addonId, returning null on timeout. */
-    waitDeviceProvider(addonId: string, timeoutMs?: number): Promise<IDeviceProviderCap | null>;
-    /** Require a device-provider by addonId — throws if not found. */
-    requireDeviceProvider(addonId: string): Promise<IDeviceProviderCap>;
-    /** Require a device-adoption provider by addonId — throws if not found. */
-    requireDeviceAdoptionProvider(addonId: string): Promise<IDeviceAdoptionProvider>;
-    /** Background adoption jobs — the deadline-free form of `adoptionAdopt`. */
-    readonly adoptionJobs: AdoptionJobEngine;
+	readonly ctx: AddonContext;
+	readonly capabilityRegistry: ICapabilityRegistry | undefined;
+	/** Push-fed remote native-cap cache (numeric deviceId → capName → owner). */
+	readonly remoteNativeCaps: Map<number, Map<string, {
+		addonId: string;
+		nodeId: string;
+	}>>;
+	/**
+	* Seed the runtime-state mirror for a device (no events). `fill` (the boot
+	* path) only fills caps memory lacks; `replace` (the migration reseed) makes
+	* the mirror answer exactly this blob — the row now belongs to different
+	* hardware, so whatever memory held is the wrong device's state (D663).
+	*/
+	seedMirror(deviceId: number, blob: Record<string, unknown>, mode?: SeedMode): void;
+	/**
+	* Drain the mirror's debounced writer on these devices and hold it off their
+	* rows until `release` — a migration swapping the rows must not race a write
+	* that read the pre-swap hardware's blob (D663).
+	*/
+	holdMirrorWrites(deviceIds: readonly number[], settings: DeviceManagerSettings): Promise<MirrorWriteHold>;
+	/**
+	* The claims the mirror holds for a device — accepted ones included, whose
+	* write-through may not have landed yet. A migration's second look (D663).
+	*/
+	mirrorOwnedCaps(deviceId: number): OwnedCaps;
+	/**
+	* Forget a REMOVED device in the mirror: cancel its armed row write, await
+	* one in flight, drop its slices, claims and baseline (D677). Called before
+	* the row is cleared, so no write lands an orphan row after it.
+	*/
+	forgetMirrorDevice(deviceId: number): Promise<void>;
+	/** Reset a stale per-session `feature-probe` timestamp before mirror seeding. */
+	withResetSessionProbe(blob: Record<string, unknown>): Record<string, unknown>;
+	/** The per-field claims index (D663) — `removeDevice` prunes a removed device from it. */
+	readonly fieldClaims: FieldClaimsIndex;
+	/** Resolve a device's real `online` flag from the mirrored device-status slice. */
+	resolveDeviceOnline(deviceId: number, fallbackOnline: boolean): boolean;
+	/** Resolve a device's `probed` flag from the mirrored feature-probe slice. */
+	resolveDeviceProbed(deviceId: number): boolean;
+	/** Wait for a device-provider by addonId, returning null on timeout. */
+	waitDeviceProvider(addonId: string, timeoutMs?: number): Promise<IDeviceProviderCap | null>;
+	/** Require a device-provider by addonId — throws if not found. */
+	requireDeviceProvider(addonId: string): Promise<IDeviceProviderCap>;
+	/** Require a device-adoption provider by addonId — throws if not found. */
+	requireDeviceAdoptionProvider(addonId: string): Promise<IDeviceAdoptionProvider>;
+	/** Background adoption jobs — the deadline-free form of `adoptionAdopt`. */
+	readonly adoptionJobs: AdoptionJobEngine;
 }
 /**
- * Full context the provider-method modules consume. `provider` is a lazy getter
- * for the assembled `IDeviceManagerProvider` so the few methods that self-call
- * sibling cap methods (e.g. `remove` → `removeDevice`, `removeByIntegration` →
- * `remove`, `enable`/`disable` → `setDisabled`) resolve the live implementation
- * without a capture cycle at construction time.
- */
+* Full context the provider-method modules consume. `provider` is a lazy getter
+* for the assembled `IDeviceManagerProvider` so the few methods that self-call
+* sibling cap methods (e.g. `remove` → `removeDevice`, `removeByIntegration` →
+* `remove`, `enable`/`disable` → `setDisabled`) resolve the live implementation
+* without a capture cycle at construction time.
+*/
 export interface ProviderContext {
-    readonly host: ProviderHost;
-    readonly metaStore: DeviceMetaStore;
-    readonly settings: DeviceManagerSettings;
-    /** Hub-process device registry (null when this node owns no registry). */
-    readonly registry: IDeviceRegistry | null;
-    readonly bindingsDeps: BindingsDeps;
-    /** In-flight refusal + completed-swap replay for `migrateDevice` — the
-     *  reason a retried migration can no longer undo the one that ran. */
-    readonly migrationGuard: MigrationGuard;
-    /** Keeps a removed device removed: refuses the `registerDevice` /
-     *  `allocateDeviceId` that a still-live device object issues as its runner
-     *  tears down, which is how a deleted camera came back as a config-less
-     *  shell (D376). */
-    readonly removalFence: RemovalFence;
-    /** The secret config paths each device declared at `registerDevice` (D783). */
-    readonly secretConfigPaths: SecretConfigPathRegistry;
-    /** Resolve the per-device `device-ops` native provider (throws when absent). */
-    requireDeviceOps(deviceId: number): IDeviceOpsProvider;
-    /** Stamp an integration id onto a device's meta row + emit DeviceMetaChanged. */
-    stampIntegrationId(deviceId: number, integrationId: string): Promise<void>;
-    /** The assembled `IDeviceManagerProvider`, resolved lazily so the few methods
-     *  that self-call sibling cap methods (`remove` → `removeDevice`,
-     *  `removeByIntegration` → `remove`, `enable`/`disable` → `setDisabled`,
-     *  `probeStreams`/`getStreamProfileMap` → `getStreamSources`) reach the live
-     *  implementation without a construction-time capture cycle. */
-    readonly provider: IDeviceManagerProvider;
+	readonly host: ProviderHost;
+	readonly metaStore: DeviceMetaStore;
+	readonly settings: DeviceManagerSettings;
+	/** Hub-process device registry (null when this node owns no registry). */
+	readonly registry: IDeviceRegistry | null;
+	readonly bindingsDeps: BindingsDeps;
+	/** In-flight refusal + completed-swap replay for `migrateDevice` — the
+	*  reason a retried migration can no longer undo the one that ran. */
+	readonly migrationGuard: MigrationGuard;
+	/** Keeps a removed device removed: refuses the `registerDevice` /
+	*  `allocateDeviceId` that a still-live device object issues as its runner
+	*  tears down, which is how a deleted camera came back as a config-less
+	*  shell (D376). */
+	readonly removalFence: RemovalFence;
+	/** The secret config paths each device declared at `registerDevice` (D783). */
+	readonly secretConfigPaths: SecretConfigPathRegistry;
+	/** Resolve the per-device `device-ops` native provider (throws when absent). */
+	requireDeviceOps(deviceId: number): IDeviceOpsProvider;
+	/** Stamp an integration id onto a device's meta row + emit DeviceMetaChanged. */
+	stampIntegrationId(deviceId: number, integrationId: string): Promise<void>;
+	/** The assembled `IDeviceManagerProvider`, resolved lazily so the few methods
+	*  that self-call sibling cap methods (`remove` → `removeDevice`,
+	*  `removeByIntegration` → `remove`, `enable`/`disable` → `setDisabled`,
+	*  `probeStreams`/`getStreamProfileMap` → `getStreamSources`) reach the live
+	*  implementation without a construction-time capture cycle. */
+	readonly provider: IDeviceManagerProvider;
 }
 export {};

package/dist/builtins/device-manager/device-queries.d.ts

@@ -1,67 +1,67 @@
-import { deviceManagerCapability, InferProvider } from '@camstack/types';
-import { ProviderContext } from './device-provider-context.js';
+import { deviceManagerCapability, InferProvider } from "@camstack/types";
+import type { ProviderContext } from "./device-provider-context.js";
 type IDeviceManagerProvider = InferProvider<typeof deviceManagerCapability>;
-export declare function listPersistedByAddon(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['listPersistedByAddon']>[0]): ReturnType<IDeviceManagerProvider['listPersistedByAddon']>;
-export declare function listAll(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['listAll']>[0]): ReturnType<IDeviceManagerProvider['listAll']>;
-export declare function getDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getDevice']>[0]): ReturnType<IDeviceManagerProvider['getDevice']>;
-export declare function getChildren(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getChildren']>[0]): ReturnType<IDeviceManagerProvider['getChildren']>;
+export declare function listPersistedByAddon(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["listPersistedByAddon"]>[0]): ReturnType<IDeviceManagerProvider["listPersistedByAddon"]>;
+export declare function listAll(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["listAll"]>[0]): ReturnType<IDeviceManagerProvider["listAll"]>;
+export declare function getDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getDevice"]>[0]): ReturnType<IDeviceManagerProvider["getDevice"]>;
+export declare function getChildren(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getChildren"]>[0]): ReturnType<IDeviceManagerProvider["getChildren"]>;
 /**
- * `getChildren` for a set of parents — THREE store reads for the whole set, not
- * three per parent (and not one per child).
- *
- * The single-parent path costs one `resolvePersistedById` (a primary-key read)
- * plus one `listByParent` (an indexed scan) EACH. Asked once per device at
- * boot that was 1 024 of each, measured on the live hub 2026-08-27 — see the
- * cap method's note. Here the ownership lookup for every parent the live
- * registry does not hold is ONE `getMany`, and the children of every parent
- * are ONE `listByParentMany`. The third read is the settings door, and it is
- * one for the whole batch: `readDeviceConfigs` over every persisted child of
- * every parent. That one was the leftover — the ledger N+1 was removed and a
- * door round trip PER CHILD stayed behind it (896 on the live hub 2026-08-30,
- * all of them forked-owned and therefore all persisted).
- *
- * The live half is indexed once too: `registry.getChildren` is
- * `getAll().filter(…)`, so calling it per parent would trade an RPC N+1 for an
- * in-memory one — 256 full sweeps of the registry per batch. One pass over
- * `getAll()` buckets every live device by its parent instead.
- *
- * A parent with no children at all is ABSENT from the record; so is a parent
- * the fleet does not know. Same contract as `DeviceRowStore.getMany` — the
- * caller asked about it and gets no row, rather than an invented empty one it
- * cannot tell apart from a real childless parent.
- */
-export declare function getChildrenBatch(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getChildrenBatch']>[0]): ReturnType<IDeviceManagerProvider['getChildrenBatch']>;
-export declare function getStreamSources(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getStreamSources']>[0]): ReturnType<IDeviceManagerProvider['getStreamSources']>;
-export declare function getConfigSchema(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getConfigSchema']>[0]): ReturnType<IDeviceManagerProvider['getConfigSchema']>;
-export declare function getSettingsSchema(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getSettingsSchema']>[0]): ReturnType<IDeviceManagerProvider['getSettingsSchema']>;
-export declare function updateConfig(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['updateConfig']>[0]): ReturnType<IDeviceManagerProvider['updateConfig']>;
-export declare function enable(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['enable']>[0]): ReturnType<IDeviceManagerProvider['enable']>;
-export declare function disable(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['disable']>[0]): ReturnType<IDeviceManagerProvider['disable']>;
-export declare function remove(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['remove']>[0]): ReturnType<IDeviceManagerProvider['remove']>;
+* `getChildren` for a set of parents — THREE store reads for the whole set, not
+* three per parent (and not one per child).
+*
+* The single-parent path costs one `resolvePersistedById` (a primary-key read)
+* plus one `listByParent` (an indexed scan) EACH. Asked once per device at
+* boot that was 1 024 of each, measured on the live hub 2026-08-27 — see the
+* cap method's note. Here the ownership lookup for every parent the live
+* registry does not hold is ONE `getMany`, and the children of every parent
+* are ONE `listByParentMany`. The third read is the settings door, and it is
+* one for the whole batch: `readDeviceConfigs` over every persisted child of
+* every parent. That one was the leftover — the ledger N+1 was removed and a
+* door round trip PER CHILD stayed behind it (896 on the live hub 2026-08-30,
+* all of them forked-owned and therefore all persisted).
+*
+* The live half is indexed once too: `registry.getChildren` is
+* `getAll().filter(…)`, so calling it per parent would trade an RPC N+1 for an
+* in-memory one — 256 full sweeps of the registry per batch. One pass over
+* `getAll()` buckets every live device by its parent instead.
+*
+* A parent with no children at all is ABSENT from the record; so is a parent
+* the fleet does not know. Same contract as `DeviceRowStore.getMany` — the
+* caller asked about it and gets no row, rather than an invented empty one it
+* cannot tell apart from a real childless parent.
+*/
+export declare function getChildrenBatch(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getChildrenBatch"]>[0]): ReturnType<IDeviceManagerProvider["getChildrenBatch"]>;
+export declare function getStreamSources(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getStreamSources"]>[0]): ReturnType<IDeviceManagerProvider["getStreamSources"]>;
+export declare function getConfigSchema(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getConfigSchema"]>[0]): ReturnType<IDeviceManagerProvider["getConfigSchema"]>;
+export declare function getSettingsSchema(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getSettingsSchema"]>[0]): ReturnType<IDeviceManagerProvider["getSettingsSchema"]>;
+export declare function updateConfig(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["updateConfig"]>[0]): ReturnType<IDeviceManagerProvider["updateConfig"]>;
+export declare function enable(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["enable"]>[0]): ReturnType<IDeviceManagerProvider["enable"]>;
+export declare function disable(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["disable"]>[0]): ReturnType<IDeviceManagerProvider["disable"]>;
+export declare function remove(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["remove"]>[0]): ReturnType<IDeviceManagerProvider["remove"]>;
 /**
- * Cascade-delete every top-level device whose `integrationId`
- * matches. Enumerates a SNAPSHOT of the meta map so concurrent
- * removals don't clobber each other. Only top-level parents are
- * enumerated — children cascade via the per-parent `removeCascade`
- * inside the delegated `remove` call. Idempotent: devices with no
- * `integrationId` never match.
- */
-export declare function removeByIntegration(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['removeByIntegration']>[0]): ReturnType<IDeviceManagerProvider['removeByIntegration']>;
-export declare function getStreamProfileMap(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getStreamProfileMap']>[0]): ReturnType<IDeviceManagerProvider['getStreamProfileMap']>;
-export declare function setStreamProfileMap(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setStreamProfileMap']>[0]): ReturnType<IDeviceManagerProvider['setStreamProfileMap']>;
-export declare function probeStreams(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['probeStreams']>[0]): ReturnType<IDeviceManagerProvider['probeStreams']>;
-export declare function discoverDevices(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['discoverDevices']>[0]): ReturnType<IDeviceManagerProvider['discoverDevices']>;
-export declare function adoptDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptDevice']>[0]): ReturnType<IDeviceManagerProvider['adoptDevice']>;
-export declare function getCreationSchema(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['getCreationSchema']>[0]): ReturnType<IDeviceManagerProvider['getCreationSchema']>;
-export declare function createDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['createDevice']>[0]): ReturnType<IDeviceManagerProvider['createDevice']>;
-export declare function testCreationField(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['testCreationField']>[0]): ReturnType<IDeviceManagerProvider['testCreationField']>;
-export declare function adoptionListCandidates(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionListCandidates']>[0]): ReturnType<IDeviceManagerProvider['adoptionListCandidates']>;
-export declare function adoptionRefresh(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionRefresh']>[0]): ReturnType<IDeviceManagerProvider['adoptionRefresh']>;
-export declare function adoptionAdopt(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionAdopt']>[0]): ReturnType<IDeviceManagerProvider['adoptionAdopt']>;
-export declare function adoptionRelease(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionRelease']>[0]): ReturnType<IDeviceManagerProvider['adoptionRelease']>;
-export declare function adoptionStartJob(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionStartJob']>[0]): ReturnType<IDeviceManagerProvider['adoptionStartJob']>;
-export declare function adoptionListJobs(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionListJobs']>[0]): ReturnType<IDeviceManagerProvider['adoptionListJobs']>;
-export declare function adoptionCancelJob(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionCancelJob']>[0]): ReturnType<IDeviceManagerProvider['adoptionCancelJob']>;
-export declare function adoptionResync(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['adoptionResync']>[0]): ReturnType<IDeviceManagerProvider['adoptionResync']>;
-export declare function testField(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['testField']>[0]): ReturnType<IDeviceManagerProvider['testField']>;
+* Cascade-delete every top-level device whose `integrationId`
+* matches. Enumerates a SNAPSHOT of the meta map so concurrent
+* removals don't clobber each other. Only top-level parents are
+* enumerated — children cascade via the per-parent `removeCascade`
+* inside the delegated `remove` call. Idempotent: devices with no
+* `integrationId` never match.
+*/
+export declare function removeByIntegration(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["removeByIntegration"]>[0]): ReturnType<IDeviceManagerProvider["removeByIntegration"]>;
+export declare function getStreamProfileMap(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getStreamProfileMap"]>[0]): ReturnType<IDeviceManagerProvider["getStreamProfileMap"]>;
+export declare function setStreamProfileMap(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setStreamProfileMap"]>[0]): ReturnType<IDeviceManagerProvider["setStreamProfileMap"]>;
+export declare function probeStreams(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["probeStreams"]>[0]): ReturnType<IDeviceManagerProvider["probeStreams"]>;
+export declare function discoverDevices(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["discoverDevices"]>[0]): ReturnType<IDeviceManagerProvider["discoverDevices"]>;
+export declare function adoptDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptDevice"]>[0]): ReturnType<IDeviceManagerProvider["adoptDevice"]>;
+export declare function getCreationSchema(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["getCreationSchema"]>[0]): ReturnType<IDeviceManagerProvider["getCreationSchema"]>;
+export declare function createDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["createDevice"]>[0]): ReturnType<IDeviceManagerProvider["createDevice"]>;
+export declare function testCreationField(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["testCreationField"]>[0]): ReturnType<IDeviceManagerProvider["testCreationField"]>;
+export declare function adoptionListCandidates(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionListCandidates"]>[0]): ReturnType<IDeviceManagerProvider["adoptionListCandidates"]>;
+export declare function adoptionRefresh(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionRefresh"]>[0]): ReturnType<IDeviceManagerProvider["adoptionRefresh"]>;
+export declare function adoptionAdopt(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionAdopt"]>[0]): ReturnType<IDeviceManagerProvider["adoptionAdopt"]>;
+export declare function adoptionRelease(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionRelease"]>[0]): ReturnType<IDeviceManagerProvider["adoptionRelease"]>;
+export declare function adoptionStartJob(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionStartJob"]>[0]): ReturnType<IDeviceManagerProvider["adoptionStartJob"]>;
+export declare function adoptionListJobs(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionListJobs"]>[0]): ReturnType<IDeviceManagerProvider["adoptionListJobs"]>;
+export declare function adoptionCancelJob(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionCancelJob"]>[0]): ReturnType<IDeviceManagerProvider["adoptionCancelJob"]>;
+export declare function adoptionResync(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["adoptionResync"]>[0]): ReturnType<IDeviceManagerProvider["adoptionResync"]>;
+export declare function testField(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["testField"]>[0]): ReturnType<IDeviceManagerProvider["testField"]>;
 export {};