@camstack/system 1.2.144 → 1.2.146

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

@@ -5,6 +5,28 @@ export declare function listPersistedByAddon(pctx: ProviderContext, input: Param
 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 — TWO store reads for the whole set, not
+ * two per parent.
+ *
+ * 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 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']>;

package/dist/builtins/device-manager/device-row-store.d.ts

@@ -296,6 +296,24 @@ export declare class DeviceRowStore {
     listByIntegration(integrationId: string): Promise<readonly DeviceRow[]>;
     /** Direct children of one device, ordered by numeric id. */
     listByParent(parentDeviceId: number): Promise<readonly DeviceRow[]>;
+    /**
+     * Direct children of MANY devices, in ONE query.
+     *
+     * `listByParent` called once per parent is the same shape `get` was before
+     * {@link getMany}: an indexed lookup this store makes cheap, repeated until
+     * it isn't. Measured on the live hub 2026-08-27, 120-second boot window:
+     * `DeviceRowStore.list < DeviceRowStore.listByParent < getChildren` at
+     * **1 024 calls** — one per device — for 919 rows in total. The BFS in
+     * `device-meta-actions.ts#collectDescendants` walked a container tree the
+     * same way, one query per node.
+     *
+     * `whereIn` on the indexed `parentDeviceId` column collapses a level of that
+     * walk into a single statement. Contract, verbatim from {@link getMany}: an
+     * EMPTY `parentDeviceIds` reads nothing at all rather than degrading to
+     * "everything", and a parent with no children — or one the fleet does not
+     * know — is simply ABSENT from the map, never an invented empty row.
+     */
+    listByParentMany(parentDeviceIds: readonly number[]): Promise<ReadonlyMap<number, readonly DeviceRow[]>>;
     /** How many devices the fleet holds. Used to tell "empty store" from "gone device". */
     count(): Promise<number>;
     private list;

package/dist/builtins/doorbell/virtual-doorbell.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/doorbell/virtual-doorbell.addon.mjs

@@ -1,4 +1,4 @@
-import { B as doorbellCapability, Et as BaseAddon, Mt as DeviceType, O as bareAddonId, Qt as EventCategory, Tt as errMsg, W as evaluateSensorEdge, X as isSameAddonId, Z as isSourceCap, g as SOURCE_DEVICE_TYPES, h as SOURCE_CAPS, zt as createEvent } from "../../dist-6rM7chzb.mjs";
+import { B as doorbellCapability, Et as BaseAddon, Mt as DeviceType, O as bareAddonId, Qt as EventCategory, Tt as errMsg, W as evaluateSensorEdge, X as isSameAddonId, Z as isSourceCap, g as SOURCE_DEVICE_TYPES, h as SOURCE_CAPS, zt as createEvent } from "../../dist-CG7kwIZp.mjs";
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, nt as logDestinationCapability } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, nt as logDestinationCapability } from "../../dist-CG7kwIZp.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/liveness-monitor/liveness-monitor.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/liveness-monitor/liveness-monitor.addon.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, Qt as EventCategory, Tt as errMsg, zt as createEvent } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, Qt as EventCategory, Tt as errMsg, zt as createEvent } from "../../dist-CG7kwIZp.mjs";
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/local-auth/local-auth.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let crypto$1 = require("crypto");

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -1,5 +1,5 @@
 import { i as __require, o as __toESM, t as __commonJSMin } from "../../chunk-CNf5ZN-e.mjs";
-import { E as authProviderCapability, Et as BaseAddon, St as userManagementCapability, r as ApiKeyRecordSchema, v as ScopedTokenSchema, x as UserRecordSchema } from "../../dist-6rM7chzb.mjs";
+import { E as authProviderCapability, Et as BaseAddon, St as userManagementCapability, r as ApiKeyRecordSchema, v as ScopedTokenSchema, x as UserRecordSchema } from "../../dist-CG7kwIZp.mjs";
 import * as crypto$2 from "node:crypto";
 import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
 import nodeCrypto from "crypto";

package/dist/builtins/local-network/local-network.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 const require_tls = require("../../tls-u8QCJCFE.js");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/local-network/local-network.addon.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, Qt as EventCategory, tt as localNetworkCapability } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, Qt as EventCategory, tt as localNetworkCapability } from "../../dist-CG7kwIZp.mjs";
 import { S as readLanHttpState, _ as DEFAULT_LAN_HTTP_PORT, a as writeTlsMode, i as writeExtraSans, l as reissueTlsLeaf, n as readTlsAccessStatus, o as validateUploadedTls, r as readTlsMode, s as ensureTlsCert, t as readExtraSans, y as applyLanHttp } from "../../tls-CQhPGSJm.mjs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";

package/dist/builtins/loki-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/loki-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, nt as logDestinationCapability } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, nt as logDestinationCapability } from "../../dist-CG7kwIZp.mjs";
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/native-metrics/native-metrics.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 let node_os = require("node:os");

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, Qt as EventCategory, at as metricsProviderCapability, zt as createEvent } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, Qt as EventCategory, at as metricsProviderCapability, zt as createEvent } from "../../dist-CG7kwIZp.mjs";
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";

package/dist/builtins/platform-probe/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 let node_os = require("node:os");

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Et as BaseAddon, Qt as EventCategory, Tt as errMsg, V as enumerateInferenceDevices, Vt as emitReadiness, ht as scoreRuntimes, lt as platformProbeCapability } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, Qt as EventCategory, Tt as errMsg, V as enumerateInferenceDevices, Vt as emitReadiness, ht as scoreRuntimes, lt as platformProbeCapability } from "../../dist-CG7kwIZp.mjs";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, Qt as EventCategory } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, Qt as EventCategory } from "../../dist-CG7kwIZp.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { At as DeviceFeature, Et as BaseAddon, Gt as nodePin, I as deriveBatteryPresence, Mt as DeviceType, O as bareAddonId, Qt as EventCategory, Tt as errMsg, _t as snapshotCapability, i as BatteryStatusSchema, k as batteryCapability, xt as streamQualityLabel } from "../../dist-6rM7chzb.mjs";
+import { At as DeviceFeature, Et as BaseAddon, Gt as nodePin, I as deriveBatteryPresence, Mt as DeviceType, O as bareAddonId, Qt as EventCategory, Tt as errMsg, _t as snapshotCapability, i as BatteryStatusSchema, k as batteryCapability, xt as streamQualityLabel } from "../../dist-CG7kwIZp.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { signExpiringUrl, verifyExpiringUrl } from "@camstack/types/node";

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, K as filesystemBrowseCapability, bt as storageProviderCapability } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, K as filesystemBrowseCapability, bt as storageProviderCapability } from "../../dist-CG7kwIZp.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/sqlite-storage/sqlite-settings-backend.d.ts

@@ -1,4 +1,4 @@
-import { CollectionColumn, CollectionIndex, DataStoreEngineInfo, HistogramBucket, IScopedLogger, ISettingsBackend, QueryFilter, SettingsCountInput, SettingsDeleteInput, SettingsGetInput, SettingsHistogramInput, SettingsInsertInput, SettingsIsEmptyInput, SettingsQueryInput, SettingsRecord, SettingsSetInput, SettingsUpdateInput } from '@camstack/types';
+import { CollectionColumn, CollectionIndex, DataStoreEngineInfo, HistogramBucket, IScopedLogger, ISettingsBackend, QueryFilter, SettingsCountInput, SettingsDeleteInput, SettingsGetInput, SettingsAggregateInput, SettingsAggregateResult, SettingsHistogramInput, SettingsInsertInput, SettingsIsEmptyInput, SettingsQueryInput, SettingsRecord, SettingsSetInput, SettingsUpdateInput } from '@camstack/types';
 import { default as Database } from 'better-sqlite3';
 import { MutationFilterInput } from './filter-compiler.js';
 import { SqliteOpProfiler } from './query-profiler.js';
@@ -190,6 +190,19 @@ export declare class SqliteSettingsBackend implements ISettingsBackend {
      * `query` is, or the two disagree again for a new reason.
      */
     count({ namespace, collection, filter }: SettingsCountInput): Promise<number>;
+    /**
+     * `COUNT(*)` and one SUM/MIN/MAX per requested field, in ONE statement.
+     *
+     * Result slots are aliased POSITIONALLY (`a0`, `a1`, …) and mapped back by
+     * index: `as` is caller text and must never reach SQL as an identifier, and
+     * the column name is validated through {@link fieldExprFor} exactly like a
+     * projection — an unresolvable field THROWS rather than being dropped, because
+     * a missing aggregate comes back as a number that looks real.
+     *
+     * `select` mode on the filter, so this agrees with `query` and `count` about
+     * which rows it is talking about.
+     */
+    aggregate({ namespace, collection, fields, filter, }: SettingsAggregateInput): Promise<SettingsAggregateResult>;
     histogram({ namespace, collection, field, bucketSize, origin, filter, }: SettingsHistogramInput): Promise<readonly HistogramBucket[]>;
     isEmpty({ namespace, collection }: SettingsIsEmptyInput): Promise<boolean>;
     private queryDeclared;

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -668,6 +668,7 @@ function createDataStoreDispatch(getEngines) {
 		deleteWhere: async (input) => (await engine()).deleteWhere(input),
 		updateWhere: async (input) => (await engine()).updateWhere(input),
 		count: async (input) => (await engine()).count(input),
+		aggregate: async (input) => (await engine()).aggregate(input),
 		histogram: async (input) => (await engine()).histogram(input),
 		isEmpty: async (input) => (await engine()).isEmpty(input),
 		declareCollection: async (input) => (await engine()).declareCollection(input)

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, Kt as parseJsonObject, b as StorageMigrationJobSchema, gt as settingsStoreCapability, vt as storageCapability, y as StorageLocationTypeSchema, yt as storageMigrationCapability } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, Kt as parseJsonObject, b as StorageMigrationJobSchema, gt as settingsStoreCapability, vt as storageCapability, y as StorageLocationTypeSchema, yt as storageMigrationCapability } from "../../dist-CG7kwIZp.mjs";
 import { randomUUID } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path$1 from "node:path";
@@ -661,6 +661,7 @@ function createDataStoreDispatch(getEngines) {
 		deleteWhere: async (input) => (await engine()).deleteWhere(input),
 		updateWhere: async (input) => (await engine()).updateWhere(input),
 		count: async (input) => (await engine()).count(input),
+		aggregate: async (input) => (await engine()).aggregate(input),
 		histogram: async (input) => (await engine()).histogram(input),
 		isEmpty: async (input) => (await engine()).isEmpty(input),
 		declareCollection: async (input) => (await engine()).declareCollection(input)

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, Tt as errMsg, Ut as hydrateSchema } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, Tt as errMsg, Ut as hydrateSchema } from "../../dist-CG7kwIZp.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-D3lqzV40.js");
+const require_dist = require("../../dist-BVU5JADq.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Et as BaseAddon, nt as logDestinationCapability } from "../../dist-6rM7chzb.mjs";
+import { Et as BaseAddon, nt as logDestinationCapability } from "../../dist-CG7kwIZp.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";