@camstack/types 1.2.367 → 1.2.369

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: 1332 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';