@camstack/types 1.2.405 → 1.2.407

package/dist/generated/customize-catalog.d.ts

@@ -0,0 +1,229 @@
+import { DeviceType } from '../device/device-type.js';
+/**
+ * Customize catalog, projected from every `*.cap.ts` `customize` block.
+ * 5 caps. Field keys are `runtimeState` paths. No Zod.
+ */
+export declare const CAP_CUSTOMIZE_CATALOG: {
+    readonly battery: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'percentage';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat];
+            readonly apply: 'add-or-replace';
+            readonly vocabularyCap: 'battery';
+            readonly vocabularyStateField: 'percentage';
+            readonly sources: readonly [{
+                readonly kind: 'field';
+                readonly valueKinds: readonly ["number", "string"];
+                readonly transformKinds: readonly ["identity", "linear"];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'percentage';
+            readonly valueKind: 'number';
+            readonly nullable: true;
+            readonly companions: readonly [{
+                readonly kind: 'constant';
+                readonly path: 'charging';
+                readonly value: 'unknown';
+                readonly when: 'add';
+            }, {
+                readonly kind: 'constant';
+                readonly path: 'sleeping';
+                readonly value: false;
+                readonly when: 'add';
+            }, {
+                readonly kind: 'clock';
+                readonly path: 'lastUpdated';
+                readonly when: 'add';
+            }];
+        }];
+    };
+    readonly consumables: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'items';
+            readonly cardinality: 'keyedArray';
+            readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'consumables';
+            readonly sources: readonly [];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'items';
+            readonly keyField: 'key';
+            readonly labelField: 'label';
+            readonly nativeItems: 'read-only';
+            readonly fields: readonly [{
+                readonly path: 'level';
+                readonly valueKind: 'number';
+                readonly nullable: true;
+                readonly sources: readonly [{
+                    readonly kind: 'numeric';
+                    readonly transformKinds: readonly ["identity", "linear"];
+                }];
+            }, {
+                readonly path: 'remaining.value';
+                readonly valueKind: 'number';
+                readonly nullable: true;
+                readonly sources: readonly [{
+                    readonly kind: 'numeric';
+                    readonly transformKinds: readonly ["identity"];
+                }];
+                readonly literals: readonly [{
+                    readonly path: 'remaining.unit';
+                    readonly values: readonly ["days", "hours", "cycles"];
+                }];
+            }, {
+                readonly path: 'status';
+                readonly valueKind: 'enum';
+                readonly nullable: true;
+                readonly enumValues: readonly ["ok", "low", "empty", "full", "replace"];
+                readonly sources: readonly [{
+                    readonly kind: 'enum';
+                    readonly transformKinds: readonly ["enum-map"];
+                }];
+            }];
+            readonly traits: readonly [{
+                readonly path: 'kind';
+                readonly values: readonly ["wear", "supply", "waste"];
+                readonly defaultValue: 'wear';
+            }, {
+                readonly path: 'form';
+                readonly values: readonly ["part", "tank", "product", "bin"];
+                readonly defaultValue: 'part';
+            }];
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastChangedAt';
+                readonly when: 'add';
+            }, {
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'add';
+            }];
+        }];
+    };
+    readonly doorbell: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'pressed';
+            readonly cardinality: 'event';
+            readonly deviceTypes: readonly [DeviceType.Camera];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'doorbell';
+            readonly vocabularyEvent: 'onPressed';
+            readonly sources: readonly [{
+                readonly kind: 'binary';
+                readonly transformKinds: readonly [];
+            }, {
+                readonly kind: 'switch';
+                readonly transformKinds: readonly [];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly shape: 'pulse';
+            readonly applyAuthority: {
+                readonly kind: 'composition-claim';
+            };
+            readonly eventName: 'onPressed';
+            readonly combine: 'any';
+            readonly edges: readonly ["rising"];
+            readonly timestampPath: 'lastPressedAt';
+            readonly counterPath: 'pressCountSinceStart';
+            readonly highWater: 'composer-advance';
+            readonly debounceMs: 2000;
+        }];
+    };
+    readonly motion: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'detected';
+            readonly cardinality: 'event';
+            readonly deviceTypes: readonly [DeviceType.Camera];
+            readonly apply: 'replace';
+            readonly vocabularyCap: 'motion';
+            readonly vocabularyEvent: 'onMotionChanged';
+            readonly sources: readonly [{
+                readonly kind: 'binary';
+                readonly transformKinds: readonly [];
+            }, {
+                readonly kind: 'switch';
+                readonly transformKinds: readonly [];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: false;
+            readonly shape: 'span';
+            readonly applyAuthority: {
+                readonly kind: 'camera-sensors';
+                readonly timeoutField: 'motionCooldownMs';
+            };
+            readonly eventName: 'onMotionChanged';
+            readonly combine: 'any';
+            readonly start: 'rising-edge';
+            readonly end: 'falling-edge-or-timeout';
+            readonly timeoutMs: 30000;
+            readonly sourceModes: readonly ["in-addition", "confirm", "replace"];
+        }];
+    };
+    readonly 'running-state': {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'running';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder];
+            readonly apply: 'add-or-replace';
+            readonly vocabularyCap: 'running-state';
+            readonly vocabularyStateField: 'running';
+            readonly sources: readonly [{
+                readonly kind: 'switch';
+                readonly transformKinds: readonly ["identity"];
+            }, {
+                readonly kind: 'binary';
+                readonly transformKinds: readonly ["identity", "invert"];
+            }, {
+                readonly kind: 'numeric';
+                readonly requiredUnit: 'W';
+                readonly transformKinds: readonly ["threshold"];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+                readonly runtimeField: 'source';
+                readonly nativeValue: 'native';
+                readonly assignedValue: 'assigned';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'running';
+            readonly valueKind: 'boolean';
+            readonly nullable: true;
+            readonly companions: readonly [{
+                readonly kind: 'constant';
+                readonly path: 'source';
+                readonly value: 'assigned';
+                readonly when: 'always';
+            }, {
+                readonly kind: 'constant';
+                readonly path: 'phase';
+                readonly value: null;
+                readonly when: 'always';
+            }, {
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }, {
+                readonly kind: 'transition-time';
+                readonly path: 'since';
+                readonly sourceChangedAt: 'prefer';
+            }];
+        }];
+    };
+};

package/dist/generated/device-local-state.d.ts

@@ -52,6 +52,7 @@ import { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js';
 import { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 import { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
+import { runningStateCapability } from '../capabilities/running-state.cap.js';
 import { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 import { smokeCapability } from '../capabilities/smoke.cap.js';
@@ -135,6 +136,7 @@ export interface DeviceLocalState {
     ptzAutotrack: InferRuntimeState<typeof ptzAutotrackCapability>;
     recordingOnboard: InferRuntimeState<typeof recordingOnboardCapability>;
     recordingSignal: InferRuntimeState<typeof recordingSignalCapability>;
+    runningState: InferRuntimeState<typeof runningStateCapability>;
     sceneMonitor: InferRuntimeState<typeof sceneMonitorCapability>;
     scriptRunner: InferRuntimeState<typeof scriptRunnerCapability>;
     smoke: InferRuntimeState<typeof smokeCapability>;
@@ -228,6 +230,7 @@ export interface CapNameToRuntimeStateMap {
     'ptz-autotrack': InferRuntimeState<typeof ptzAutotrackCapability>;
     'recording-onboard': InferRuntimeState<typeof recordingOnboardCapability>;
     'recording-signal': InferRuntimeState<typeof recordingSignalCapability>;
+    'running-state': InferRuntimeState<typeof runningStateCapability>;
     'scene-monitor': InferRuntimeState<typeof sceneMonitorCapability>;
     'script-runner': InferRuntimeState<typeof scriptRunnerCapability>;
     'smoke': InferRuntimeState<typeof smokeCapability>;

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

@@ -71,6 +71,7 @@ import type { rebootCapability } from '../capabilities/reboot.cap.js';
 import type { recordingCapability } from '../capabilities/recording.cap.js';
 import type { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
+import type { runningStateCapability } from '../capabilities/running-state.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import type { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 import type { smokeCapability } from '../capabilities/smoke.cap.js';
@@ -169,6 +170,7 @@ export interface DeviceProxyState {
     readonly ptzAutotrack: SliceHandle<InferRuntimeState<typeof ptzAutotrackCapability>>;
     readonly recordingOnboard: SliceHandle<InferRuntimeState<typeof recordingOnboardCapability>>;
     readonly recordingSignal: SliceHandle<InferRuntimeState<typeof recordingSignalCapability>>;
+    readonly runningState: SliceHandle<InferRuntimeState<typeof runningStateCapability>>;
     readonly sceneMonitor: SliceHandle<InferRuntimeState<typeof sceneMonitorCapability>>;
     readonly scriptRunner: SliceHandle<InferRuntimeState<typeof scriptRunnerCapability>>;
     readonly smoke: SliceHandle<InferRuntimeState<typeof smokeCapability>>;
@@ -275,6 +277,7 @@ export interface DeviceProxy {
     readonly recording?: InferDeviceProxyCap<typeof recordingCapability>;
     readonly recordingOnboard?: InferDeviceProxyCap<typeof recordingOnboardCapability>;
     readonly recordingSignal?: InferDeviceProxyCap<typeof recordingSignalCapability>;
+    readonly runningState?: InferDeviceProxyCap<typeof runningStateCapability>;
     readonly sceneMonitor?: InferDeviceProxyCap<typeof sceneMonitorCapability>;
     readonly scriptRunner?: InferDeviceProxyCap<typeof scriptRunnerCapability>;
     readonly smoke?: InferDeviceProxyCap<typeof smokeCapability>;

package/dist/generated/device-scoped-caps.d.ts

@@ -5,7 +5,7 @@
  * can answer "may a rule actuate this?" without importing the schema barrel
  * (~144MB RSS per runner, D28).
  *
- * Coverage: 90 device-scoped capabilities.
+ * Coverage: 91 device-scoped capabilities.
  */
 export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
 /**

package/dist/generated/history-catalog.d.ts

@@ -1,7 +1,7 @@
 import type { CapabilityHistoryField, CapabilityHistoryItems } from '../capabilities/capability-definition.js';
 /**
  * Cap history catalog, projected from every `*.cap.ts` `history` block.
- * 40 caps with series (73 series), 30 caps answered `'none'`.
+ * 41 caps with series (74 series), 30 caps answered `'none'`.
  * Field keys are `runtimeState` paths (`a.b` into fixed objects only).
  */
 export declare const HISTORY_CATALOG: Readonly<Record<string, Readonly<Record<string, CapabilityHistoryField>>>>;

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: 1378 method paths across 179 capabilities.
+ * Coverage: 1379 method paths across 180 capabilities.
  */
 import type { MethodRole } from '../auth/viewer-access.js';
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';

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

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 545 methods carry a device reference, of which
+ * Coverage: 546 methods carry a device reference, of which
  * 174 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/runtime-state-durability.d.ts

@@ -11,7 +11,7 @@ export interface RuntimeStatePolicy {
 }
 /**
  * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
- * `runtimeState`. 71 caps: 37 `restored`, 34 `session`.
+ * `runtimeState`. 72 caps: 38 `restored`, 34 `session`.
  *
  * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
  * with `durability: 'session'` has one and has decided not to keep it.

package/dist/index.d.ts

@@ -164,6 +164,8 @@ export type { AutomationAction, AutomationCondition, AutomationConditionAll, Aut
 export { AutomationActionSchema, AutomationConditionOperatorSchema, AutomationConditionSchema, AutomationRecipeSchema, AutomationTriggerSchema, conditionDepth, countConditionLeaves, generateAutomationBlock, MAX_CONDITION_DEPTH, MAX_CONDITION_LEAVES, validateRecipeBounds, } from './automation/index.js';
 export * from './cap-call-context.js';
 export * from './capabilities/index.js';
+export * from './running-state/defaults.js';
+export * from './running-state/from-operation.js';
 export * from './clips/clip-event-labels.js';
 export * from './device-extension/index.js';
 export * from './composition/index.js';
@@ -252,6 +254,20 @@ 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_ITEM_CATALOG, HISTORY_NONE_CAPS, historyFieldsFor, } from './generated/history-catalog.js';
+export { CAP_CUSTOMIZE_CATALOG } from './generated/customize-catalog.js';
+export type { CustomizeCatalog, CustomizeCatalogField, CustomizeCatalogSource, CustomizeCatalogTarget, } from './capabilities/customize-catalog.js';
+export type { CapabilityCustomizeSpec, CapabilityCustomizeTarget, CustomizeCardinality, EventCustomizeTarget, PulseEventCustomizeTarget, SpanEventCustomizeTarget, } from './capabilities/customize-spec.js';
+export { CustomizeAssignmentStatusSchema, OverrideDraftSchema, type CustomizeAssignmentStatus, type OverrideDraft, } from './composition/customize/override-draft.js';
+export { compileScalarOverride, type ScalarCompileInput, type ScalarValueKind, } from './composition/customize/scalar-compile.js';
+export { decodeScalarOverride, type ScalarDecoded, type ScalarDecodeInput, } from './composition/customize/scalar-decode.js';
+export { projectScalarAssignment, type ScalarAssignmentProjection, type ScalarRead, type ScalarSourcePresence, type ScalarStatusInput, } from './composition/customize/scalar-status.js';
+export { compilePulseOverride, compileSpanOverride, type PulseCompileInput, type SpanCompileInput, type SpanCompiled, } from './composition/customize/event-compile.js';
+export { decodePulseOverride, type PulseDecodeInput, type PulseDecoded, } from './composition/customize/event-decode.js';
+export { INITIAL_PULSE, INITIAL_SPAN, stepPulse, stepSpan, type LevelSample, type PulseState, type SpanState, type SpanTiming, } from './composition/customize/event-eval.js';
+export { projectPulseAssignment, projectSpanAssignment, type PulseAssignmentProjection, type PulseStatusInput, type SpanAssignmentProjection, type SpanRead, type SpanSensorRow, } from './composition/customize/event-status.js';
+export { compileKeyedArrayOverride, mergeKeyedArrayItem, withoutKeyedArrayItem, type KeyedArrayCompileInput, type KeyedArrayItemCompile, type KeyedArrayLiteral, type KeyedSourceValueKind, } from './composition/customize/keyed-array-compile.js';
+export { decodeKeyedArrayOverride, readKeyedArrayItems, type KeyedArrayItemView, type KeyedArrayRead, } from './composition/customize/keyed-array-decode.js';
+export { projectKeyedArrayAssignment, type KeyedArrayAssignmentProjection, type KeyedArrayStatusInput, } from './composition/customize/keyed-array-status.js';
 export type { ScopePresetId, ScopePresetSpec } from './generated/scope-presets.js';
 export { SCOPE_PRESETS } from './generated/scope-presets.js';
 export type { SystemProxy } from './generated/system-proxy.js';