@camstack/types 1.2.367 → 1.2.368

package/dist/generated/addon-api.d.ts

@@ -46,6 +46,7 @@ import type { deviceCredentialsCapability } from '../capabilities/device-credent
 import type { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 import type { deviceExportCapability } from '../capabilities/device-export.cap.js';
 import type { deviceExtensionCapability } from '../capabilities/device-extension.cap.js';
+import type { deviceHistoryCapability } from '../capabilities/device-history.cap.js';
 import type { deviceManagerCapability } from '../capabilities/device-manager.cap.js';
 import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
 import type { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
@@ -2353,6 +2354,83 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    deviceHistory: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        listSeries: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.listSeries.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.listSeries.output>;
+            meta: object;
+        }>;
+        listNodeSeries: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.listNodeSeries.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.listNodeSeries.output>;
+            meta: object;
+        }>;
+        query: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.query.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.query.output>;
+            meta: object;
+        }>;
+        queryNode: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.queryNode.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.queryNode.output>;
+            meta: object;
+        }>;
+        declareSeries: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.declareSeries.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.declareSeries.output>;
+            meta: object;
+        }>;
+        record: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.record.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.record.output>;
+            meta: object;
+        }>;
+        recordBuckets: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.recordBuckets.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.recordBuckets.output>;
+            meta: object;
+        }>;
+        getDeviceEnabled: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.getDeviceEnabled.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.getDeviceEnabled.output>;
+            meta: object;
+        }>;
+        setDeviceEnabled: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.setDeviceEnabled.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.setDeviceEnabled.output>;
+            meta: object;
+        }>;
+        getStatus: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceHistoryCapability.methods.getStatus.input>;
+            output: z.infer<typeof deviceHistoryCapability.methods.getStatus.output>;
+            meta: object;
+        }>;
+    }>>;
     deviceManager: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;

package/dist/generated/cap-input-defaults.d.ts

@@ -11,7 +11,7 @@
  * Plain data, zero Zod: a forked runner must not import the schema barrel
  * (~144MB RSS per runner — D28).
  *
- * Coverage: 26 caps, 67 methods with defaults.
+ * Coverage: 27 caps, 69 methods with defaults.
  */
 export declare const CAP_INPUT_DEFAULTS: Readonly<Record<string, Readonly<Record<string, Readonly<Record<string, unknown>>>>>>;
 /**

package/dist/generated/capability-router-map.d.ts

@@ -52,6 +52,7 @@ export { deviceCredentialsCapability } from '../capabilities/device-credentials.
 export { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 export { deviceExportCapability } from '../capabilities/device-export.cap.js';
 export { deviceExtensionCapability } from '../capabilities/device-extension.cap.js';
+export { deviceHistoryCapability } from '../capabilities/device-history.cap.js';
 export { deviceManagerCapability } from '../capabilities/device-manager.cap.js';
 export { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
 export { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
@@ -225,6 +226,7 @@ export declare const CAPABILITY_NAMES: {
     readonly deviceDiscovery: 'device-discovery';
     readonly deviceExport: 'device-export';
     readonly deviceExtension: 'device-extension';
+    readonly deviceHistory: 'device-history';
     readonly deviceManager: 'device-manager';
     readonly deviceOps: 'device-ops';
     readonly deviceProvider: 'device-provider';
@@ -411,6 +413,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly deviceDiscovery: TRouter;
     readonly deviceExport: TRouter;
     readonly deviceExtension: TRouter;
+    readonly deviceHistory: TRouter;
     readonly deviceManager: TRouter;
     readonly deviceOps: TRouter;
     readonly deviceProvider: TRouter;
@@ -530,8 +533,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly zoneRules: TRouter;
     readonly zones: TRouter;
 }
-/** Capability names whose mode is `singleton` (139 caps). */
-export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-adoption', 'device-credentials', 'device-discovery', 'device-manager', 'device-ops', 'device-state', 'device-status', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'metrics-provider', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'oidc-connections', 'osd', 'osd-manager', 'pet-feeder', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'reboot', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'scene-monitor', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
+/** Capability names whose mode is `singleton` (140 caps). */
+export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-adoption', 'device-credentials', 'device-discovery', 'device-history', 'device-manager', 'device-ops', 'device-state', 'device-status', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'metrics-provider', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'oidc-connections', 'osd', 'osd-manager', 'pet-feeder', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'reboot', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'scene-monitor', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
 /** Capability names whose mode is `collection` (33 caps). */

package/dist/generated/device-proxy.d.ts

@@ -94,6 +94,7 @@ import type { addonSettingsCapability } from '../capabilities/addon-settings.cap
 import type { audioAnalyzerCapability } from '../capabilities/audio-analyzer.cap.js';
 import type { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 import type { deviceExportCapability } from '../capabilities/device-export.cap.js';
+import type { deviceHistoryCapability } from '../capabilities/device-history.cap.js';
 import type { deviceManagerCapability } from '../capabilities/device-manager.cap.js';
 import type { deviceStateCapability } from '../capabilities/device-state.cap.js';
 import type { faceGalleryCapability } from '../capabilities/face-gallery.cap.js';
@@ -293,6 +294,7 @@ export interface DeviceProxy {
     readonly audioAnalyzer: Pick<InferDeviceProxyCap<typeof audioAnalyzerCapability>, 'detachDevice'>;
     readonly deviceAdoption: Pick<InferDeviceProxyCap<typeof deviceAdoptionCapability>, 'getStatus'>;
     readonly deviceExport: Pick<InferDeviceProxyCap<typeof deviceExportCapability>, 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
+    readonly deviceHistory: Pick<InferDeviceProxyCap<typeof deviceHistoryCapability>, 'listSeries' | 'query' | 'getDeviceEnabled' | 'setDeviceEnabled'>;
     readonly deviceManager: Pick<InferDeviceProxyCap<typeof deviceManagerCapability>, 'loadConfig' | 'loadRuntimeState' | 'loadMeta' | 'setName' | 'setLocation' | 'setType' | 'setIntegrationId' | 'setLinkDeviceId' | 'setPrimaryChildEntityId' | 'setChildLayout' | 'setDisplay' | 'getWireableFields' | 'setRole' | 'applyInitialMeta' | 'setMetadata' | 'setDisabled' | 'getDevice' | 'getLinkedDevices' | 'getStreamSources' | 'getConfigSchema' | 'getSettingsSchema' | 'updateConfig' | 'enable' | 'disable' | 'remove' | 'getStreamProfileMap' | 'setStreamProfileMap' | 'probeStreams' | 'getBindings' | 'setWrapperActive' | 'getWrapperActivation' | 'getDeviceSettingsAggregate' | 'getDeviceLiveInfoAggregate' | 'getDeviceAggregate' | 'runDeviceAction' | 'updateDeviceField' | 'updateDeviceFieldsBatch' | 'testField' | 'getDeviceStatusAggregate'>;
     readonly deviceState: Pick<InferDeviceProxyCap<typeof deviceStateCapability>, 'getSnapshot' | 'getCapSlice' | 'setCapSlice' | 'claimFields' | 'patchOwnedFields' | 'releaseClaim' | 'getNativeCapSlice'>;
     readonly faceGallery: Pick<InferDeviceProxyCap<typeof faceGalleryCapability>, 'listRecentFaces' | 'getFaceByTrack'>;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1321 method paths across 172 capabilities.
+ * Coverage: 1331 method paths across 173 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,8 +6,8 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 520 methods carry a device reference, of which
- * 165 are on SYSTEM-scope caps.
+ * Coverage: 524 methods carry a device reference, of which
+ * 169 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying
  * a numeric device field (targets[].deviceId) are all mapped; the matcher

package/dist/generated/system-proxy.d.ts

@@ -16,6 +16,7 @@ import type { decoderCapability } from '../capabilities/decoder.cap.js';
 import type { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 import type { deviceCredentialsCapability } from '../capabilities/device-credentials.cap.js';
 import type { deviceExportCapability } from '../capabilities/device-export.cap.js';
+import type { deviceHistoryCapability } from '../capabilities/device-history.cap.js';
 import type { deviceManagerCapability } from '../capabilities/device-manager.cap.js';
 import type { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
 import type { deviceStateCapability } from '../capabilities/device-state.cap.js';
@@ -76,6 +77,7 @@ export interface SystemProxy {
     readonly deviceAdoption: Pick<InferProvider<typeof deviceAdoptionCapability>, 'listCandidateFilters' | 'listCandidates' | 'getCandidate' | 'refresh' | 'adopt' | 'release' | 'resync'>;
     readonly deviceCredentials: Pick<InferProvider<typeof deviceCredentialsCapability>, 'listDeviceCredentials' | 'startEnrollment' | 'revokeDeviceCredential' | 'getDeviceCertificateSettings' | 'setDeviceCertificateSettings' | 'deleteDeviceCredential' | 'getDeviceCaStatus' | 'renameDeviceCredential'>;
     readonly deviceExport: Pick<InferProvider<typeof deviceExportCapability>, 'getStatus' | 'listSupportedDeviceKinds' | 'listExposedDevices' | 'exposeDevice' | 'unexposeDevice'>;
+    readonly deviceHistory: Pick<InferProvider<typeof deviceHistoryCapability>, 'listNodeSeries' | 'queryNode' | 'declareSeries' | 'record' | 'recordBuckets' | 'getStatus'>;
     readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'migrateDevice' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'renameLocation' | 'listLocationIcons' | 'setLocationIcon' | 'listLocationDescriptions' | 'setLocationDescription' | 'listSiteZones' | 'setSiteZone' | 'removeSiteZone' | 'renameSiteZone' | 'setLocationZone' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'getChildrenBatch' | 'getLinkedDevicesBatch' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listDeviceIdsByCaps' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
     readonly deviceProvider: Pick<InferProvider<typeof deviceProviderCapability>, 'start' | 'stop' | 'getStatus' | 'getDevices' | 'reloadDevice' | 'supportsDiscovery' | 'discoverDevices' | 'getDiscoveryParamsSchema' | 'getManualCreationType' | 'adoptDiscoveredDevice' | 'supportsManualCreation' | 'getChildCreationSchema' | 'createDevice' | 'testCreationField'>;
     readonly deviceState: Pick<InferProvider<typeof deviceStateCapability>, 'getAllSnapshots' | 'listClaims'>;

package/dist/history/bucket-accumulator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Producer-side five-minute bucket accumulator (D850, plan §5.4).
+ *
+ * PURE: no I/O, no timers, the clock is a parameter. It lives in
+ * `@camstack/types` because it is bundled with every addon — an addon cannot
+ * import another addon, and an import from `@camstack/system` breaks on an
+ * older server. A producer that samples faster than `record` allows (once per
+ * 10 s per series) aggregates here and sends CLOSED buckets with
+ * `deviceHistory.recordBuckets`.
+ *
+ * The caller owns delivery: `takeClosed` hands buckets over, and a bucket the
+ * caller could not deliver goes back through `requeue`, which keeps at most
+ * {@link MAX_REQUEUED_BUCKETS_PER_SERIES} per series (one hour) and RETURNS what
+ * it had to drop so the caller can say so, with a `deviceId` tag (D58, D391).
+ */
+import type { DeviceHistorySubject } from '../capabilities/device-history.cap.js';
+/** Width of a bucket the history store accepts. */
+export declare const HISTORY_BUCKET_MS: number;
+/** One hour of failed deliveries per series is retried; older buckets are dropped. */
+export declare const MAX_REQUEUED_BUCKETS_PER_SERIES = 12;
+/** A closed bucket, shaped exactly like one `recordBuckets` entry. */
+export interface ClosedHistoryBucket {
+    readonly key: string;
+    readonly subject: DeviceHistorySubject;
+    readonly scope: string;
+    readonly bucketStart: number;
+    readonly samples: number;
+    readonly sum: number;
+    readonly min: number;
+    readonly max: number;
+    readonly last: number | null;
+    readonly lastTs: number | null;
+}
+export declare function bucketStartOf(at: number): number;
+export declare class BucketAccumulator {
+    private readonly open;
+    private readonly requeued;
+    /** Add one observation. A non-finite value or timestamp is ignored (never counted as 0). */
+    note(key: string, subject: DeviceHistorySubject, scope: string, value: number, at: number): void;
+    /**
+     * Buckets whose window ended at or before `now`, oldest first, requeued ones
+     * included. They leave the accumulator: delivery is the caller's.
+     */
+    takeClosed(now: number): readonly ClosedHistoryBucket[];
+    /**
+     * Put undelivered buckets back for the next `takeClosed`. Keeps the newest
+     * {@link MAX_REQUEUED_BUCKETS_PER_SERIES} per series and returns the buckets
+     * it dropped (empty when none).
+     */
+    requeue(buckets: readonly ClosedHistoryBucket[]): readonly ClosedHistoryBucket[];
+    /** Buckets currently held (open plus requeued) — for a gauge in the producer's own status. */
+    pendingBucketCount(): number;
+}

package/dist/index.d.ts

@@ -240,6 +240,7 @@ export { METHOD_DEVICE_SELECTORS, SYSTEM_SCOPE_DEVICE_METHODS, } from './generat
 export { CAP_PROVIDER_KIND_MAP, getCapsByProviderKind, PROVIDER_KIND_CAP_NAMES, } from './generated/provider-kind-map.js';
 export type { RuntimeStatePolicy } from './generated/runtime-state-durability.js';
 export { isRestoredCap, RESTORED_CAP_NAMES, RUNTIME_STATE_POLICY, runtimeStatePolicyFor, } from './generated/runtime-state-durability.js';
+export { BucketAccumulator, bucketStartOf, type ClosedHistoryBucket, HISTORY_BUCKET_MS, MAX_REQUEUED_BUCKETS_PER_SERIES, } from './history/bucket-accumulator.js';
 export { HISTORY_CATALOG, HISTORY_NONE_CAPS, historyFieldsFor, } from './generated/history-catalog.js';
 export type { ScopePresetId, ScopePresetSpec } from './generated/scope-presets.js';
 export { SCOPE_PRESETS } from './generated/scope-presets.js';