@camstack/types 1.2.529 → 1.2.530

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dist/addon.js +1 -1
  3. package/dist/addon.mjs +1 -1
  4. package/dist/capabilities/capability-definition.d.ts +15 -0
  5. package/dist/capabilities/climate-control.cap.d.ts +26 -1
  6. package/dist/capabilities/enum-sensor.cap.d.ts +1 -1
  7. package/dist/capabilities/hero-layout.cap.d.ts +158 -17
  8. package/dist/capabilities/water-heater.cap.d.ts +5 -1
  9. package/dist/device/hero/climate-view.d.ts +45 -0
  10. package/dist/device/hero/hero-contribution-kit.d.ts +27 -0
  11. package/dist/device/hero/hero-contributions-access.d.ts +2 -0
  12. package/dist/device/hero/hero-contributions-actuators.d.ts +2 -0
  13. package/dist/device/hero/hero-contributions-climate.d.ts +3 -0
  14. package/dist/device/hero/hero-contributions-devices.d.ts +2 -0
  15. package/dist/device/hero/hero-contributions-groups.d.ts +2 -0
  16. package/dist/device/hero/hero-contributions-sensors.d.ts +2 -0
  17. package/dist/device/hero/hero-contributions.d.ts +2 -5
  18. package/dist/device/hero/hero-fragment.d.ts +11 -1
  19. package/dist/device/hero/hero-look.d.ts +80 -14
  20. package/dist/device/hero/hero-model.d.ts +224 -34
  21. package/dist/device/hero/hero-row.d.ts +30 -5
  22. package/dist/device/hero/media-player-view.d.ts +6 -0
  23. package/dist/generated/addon-cap-facts.d.ts +1 -1
  24. package/dist/generated/runtime-state-durability.d.ts +6 -1
  25. package/dist/index.js +2488 -216
  26. package/dist/index.mjs +2488 -216
  27. package/dist/{sleep-CqvzKIq2.mjs → sleep-CfYvHNFz.mjs} +16 -0
  28. package/dist/{sleep-DX_umr22.js → sleep-CqsZMKxq.js} +16 -0
  29. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.2.530] - 2026-11-08
11
+
12
+ ### Changed
13
+
14
+ - Device heroes now complete for locks, alarm panels, fans, vacuums, mowers, pet feeders and fountains, groups, automations and scripts: look, status line and controls
15
+ - Device heroes now read their own state for lights, covers, valves, humidifiers, alarm and motion sensors, doorbells, weather, updates and buttons instead of a generic power state
16
+ - Climate, thermostat, water-heater, heating-valve and sensor devices now carry their mode, setpoint, measured values, readings and controls in the device hero instead of showing an unknown state
17
+ - Climate and water-heater state now remembers the last mode the device ran (lastActiveMode), and climate, sensor and water-heater heroes get their own icon, tone and headline
18
+ - Capability definitions can name restoredStateFields, so a restored capability persists only those fields of its state.
19
+ - Enum sensors no longer persist a restore only because the timestamp flag changed
20
+ - Device heroes: a channel row for media players and IR TVs, light colour presets, and a value slider or picker for generic controls
21
+
10
22
  ## [1.2.529] - 2026-11-08
11
23
 
12
24
  ### Changed
package/dist/addon.js CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_sleep = require("./sleep-DX_umr22.js");
2
+ const require_sleep = require("./sleep-CqsZMKxq.js");
3
3
  const require_event_category = require("./event-category-BC4RRerT.js");
4
4
  const require_device_type = require("./device-type-BaYa0UGS.js");
5
5
  //#region src/generated/cap-input-defaults.ts
package/dist/addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as PipelineRunResultBridge, $r as RECORD_MAX_DATA_BYTES, A as isCommand, Ai as RevConflictError, An as PEER_BYTES_STALL_MS, B as withoutCallerStamp, Bn as RecordFieldPathSchema, Br as mapSecretLeaves, C as addonSliceHandleApi, Ci as PlaintextSecretError, Cn as forgetKnownSecret, Di as RecordTooLargeError, Dn as shortSecretRefHash, Dr as resolveDeviceSettings, Ei as RecordSecretUnavailableError, En as scrubKnownSecrets, Er as nodeIdOfScopedKey, F as CAP_ADVANCE_FIELDS, Fi as recordsErrorFromMessage, Gi as createEvent, Gn as StoredRecordKindDeclarationSchema, Gr as secretArrayPrefixes, H as defineCustomActions, Hn as RecordKindDeclarationSchema, Hr as recordArrayItemPath, I as CAP_METHOD_TIMEOUTS_MS, In as DisposerChain, J as nodePin, Jn as defineRecordKinds, Jr as RECORD_CLASSES, Ki as emitReadiness, Kn as assertValidDeclaration, Kr as RECORD_BATCH_MAX, Ln as defineEntryKind, Lr as secretViewsOf, Mi as UnindexedFilterError, N as HF_REPO, Ni as UnknownRecordKindError, Nn as CALLER_USERNAME_HEADER, Oi as RecordUniqueViolationError, On as PEER_BYTES_CHUNK_BYTES, Or as resolvedValues, Ot as createDebugEmitter, Pi as asRecordsError, Pn as DATAPLANE_SECRET_HEADER, Q as viewerUiCapability, Qr as RECORD_ID_MAX_LENGTH, R as CAP_STATE_LEAVES, Rn as entryBody, Rr as REMOVE_LEAF, Si as NoCallerError, Sn as clearKnownSecrets, Ti as RecordNotFoundError, Tn as registerKnownSecret, Tr as SCOPED_SETTINGS_SCOPES, U as describeCustomActions, Un as RecordKindNameSchema, Ur as recordSecretCollection, V as customAction, Vn as RecordIndexSchema, Vr as parseSecretPath, Wn as RecordRetentionSchema, Wr as recordSecretRef, X as readNodePin, Xn as collectZodSecretPaths, Xr as RECORD_DEFAULT_MAX_DATA_BYTES, Y as readCommandOrigin, Yr as RECORD_DATABASES, Zn as isZodSecret, Zr as RECORD_DELETE_BATCH, _ as readErrorI18n, _a as AddonMigrationsBlockedError, _i as BatchTooLargeError, _n as assertTransactScope, _t as ReadinessTimeoutError, aa as isSecretFieldView, ai as RECORD_SWEEP_INTERVAL_MS, ar as expandCapMethods, at as adminUiCapability, b as isDeviceScopedCap, bi as ForeignSecretMarkerError, bn as createSecretsAccess, bt as scopeKey, c as asString, ca as makeSecretMarker, ci as buildSecretRef, d as parseJsonUnknown, di as isSecretRef, ei as RECORD_MAX_INDEXES, et as PipelineStepInputSchema, f as hfModelUrl, fi as normalizeSecretOwner, fr as BaseAddon, g as ErrorI18nPayloadSchema, gn as createRecordsAccess, gt as ReadinessRegistry, hn as makeInMemoryRecords, hr as normalizeAddonInitResult, ht as MODEL_FORMATS, ia as isSecretClear, ii as RECORD_SETTINGS_MAX_ROWS, it as DEVICE_CHILDREN_BATCH_MAX, ji as TransactRefusedError, jn as PEER_BYTES_TICKET_TTL_MS, ki as RecordsError, kn as PEER_BYTES_MAX_OUTSTANDING, la as toSecretFieldView, li as formatSecretScope, mn as CommandOriginClaimSchema, na as SECRET_CLEAR, ni as RECORD_QUERY_MAX, o as asJsonObject, oa as isSecretMarker, oi as SECRET_REF_SCHEME, p as BOOT_RECOVERY_BACKOFF_MS, pi as parseSecretRef, q as commandOrigin, qn as declarationsOf, qr as RECORD_BATCH_MAX_BYTES, r as maskUrlCredentials, ra as classifySecretWrite, ri as RECORD_SECRET_COLLECTION_PREFIX, rt as deviceOpsCapability, sa as isSecretMarkerLike, si as arrayItemFieldPath, st as addonPagesSourceCapability, t as sleep, ti as RECORD_MAX_INDEX_FIELDS, tt as MIGRATION_API_VERSION, ui as globalSecretScope, va as findMigrationsBlocked, vi as DeclarationRefusedError, vn as resolveSecretViewsIn, w as createEventBusSliceSource, wi as RECORDS_ERROR_CODES, wn as knownSecretCount, x as createDeviceProxy, xi as InvalidRecordError, xn as MIN_SCRUBBED_LENGTH, y as DEVICE_SCOPED_CAPS, yi as FilterRequiredError, yn as REVALIDATE_AFTER_MS, z as CALLER_STAMPED_CAPABILITIES, zn as EntryDescriptorSchema, zr as collectSecretLeaves } from "./sleep-CqvzKIq2.mjs";
1
+ import { $ as PipelineRunResultBridge, $r as RECORD_MAX_DATA_BYTES, A as isCommand, Ai as RevConflictError, An as PEER_BYTES_STALL_MS, B as withoutCallerStamp, Bn as RecordFieldPathSchema, Br as mapSecretLeaves, C as addonSliceHandleApi, Ci as PlaintextSecretError, Cn as forgetKnownSecret, Di as RecordTooLargeError, Dn as shortSecretRefHash, Dr as resolveDeviceSettings, Ei as RecordSecretUnavailableError, En as scrubKnownSecrets, Er as nodeIdOfScopedKey, F as CAP_ADVANCE_FIELDS, Fi as recordsErrorFromMessage, Gi as createEvent, Gn as StoredRecordKindDeclarationSchema, Gr as secretArrayPrefixes, H as defineCustomActions, Hn as RecordKindDeclarationSchema, Hr as recordArrayItemPath, I as CAP_METHOD_TIMEOUTS_MS, In as DisposerChain, J as nodePin, Jn as defineRecordKinds, Jr as RECORD_CLASSES, Ki as emitReadiness, Kn as assertValidDeclaration, Kr as RECORD_BATCH_MAX, Ln as defineEntryKind, Lr as secretViewsOf, Mi as UnindexedFilterError, N as HF_REPO, Ni as UnknownRecordKindError, Nn as CALLER_USERNAME_HEADER, Oi as RecordUniqueViolationError, On as PEER_BYTES_CHUNK_BYTES, Or as resolvedValues, Ot as createDebugEmitter, Pi as asRecordsError, Pn as DATAPLANE_SECRET_HEADER, Q as viewerUiCapability, Qr as RECORD_ID_MAX_LENGTH, R as CAP_STATE_LEAVES, Rn as entryBody, Rr as REMOVE_LEAF, Si as NoCallerError, Sn as clearKnownSecrets, Ti as RecordNotFoundError, Tn as registerKnownSecret, Tr as SCOPED_SETTINGS_SCOPES, U as describeCustomActions, Un as RecordKindNameSchema, Ur as recordSecretCollection, V as customAction, Vn as RecordIndexSchema, Vr as parseSecretPath, Wn as RecordRetentionSchema, Wr as recordSecretRef, X as readNodePin, Xn as collectZodSecretPaths, Xr as RECORD_DEFAULT_MAX_DATA_BYTES, Y as readCommandOrigin, Yr as RECORD_DATABASES, Zn as isZodSecret, Zr as RECORD_DELETE_BATCH, _ as readErrorI18n, _a as AddonMigrationsBlockedError, _i as BatchTooLargeError, _n as assertTransactScope, _t as ReadinessTimeoutError, aa as isSecretFieldView, ai as RECORD_SWEEP_INTERVAL_MS, ar as expandCapMethods, at as adminUiCapability, b as isDeviceScopedCap, bi as ForeignSecretMarkerError, bn as createSecretsAccess, bt as scopeKey, c as asString, ca as makeSecretMarker, ci as buildSecretRef, d as parseJsonUnknown, di as isSecretRef, ei as RECORD_MAX_INDEXES, et as PipelineStepInputSchema, f as hfModelUrl, fi as normalizeSecretOwner, fr as BaseAddon, g as ErrorI18nPayloadSchema, gn as createRecordsAccess, gt as ReadinessRegistry, hn as makeInMemoryRecords, hr as normalizeAddonInitResult, ht as MODEL_FORMATS, ia as isSecretClear, ii as RECORD_SETTINGS_MAX_ROWS, it as DEVICE_CHILDREN_BATCH_MAX, ji as TransactRefusedError, jn as PEER_BYTES_TICKET_TTL_MS, ki as RecordsError, kn as PEER_BYTES_MAX_OUTSTANDING, la as toSecretFieldView, li as formatSecretScope, mn as CommandOriginClaimSchema, na as SECRET_CLEAR, ni as RECORD_QUERY_MAX, o as asJsonObject, oa as isSecretMarker, oi as SECRET_REF_SCHEME, p as BOOT_RECOVERY_BACKOFF_MS, pi as parseSecretRef, q as commandOrigin, qn as declarationsOf, qr as RECORD_BATCH_MAX_BYTES, r as maskUrlCredentials, ra as classifySecretWrite, ri as RECORD_SECRET_COLLECTION_PREFIX, rt as deviceOpsCapability, sa as isSecretMarkerLike, si as arrayItemFieldPath, st as addonPagesSourceCapability, t as sleep, ti as RECORD_MAX_INDEX_FIELDS, tt as MIGRATION_API_VERSION, ui as globalSecretScope, va as findMigrationsBlocked, vi as DeclarationRefusedError, vn as resolveSecretViewsIn, w as createEventBusSliceSource, wi as RECORDS_ERROR_CODES, wn as knownSecretCount, x as createDeviceProxy, xi as InvalidRecordError, xn as MIN_SCRUBBED_LENGTH, y as DEVICE_SCOPED_CAPS, yi as FilterRequiredError, yn as REVALIDATE_AFTER_MS, z as CALLER_STAMPED_CAPABILITIES, zn as EntryDescriptorSchema, zr as collectSecretLeaves } from "./sleep-CfYvHNFz.mjs";
2
2
  import { t as EventCategory } from "./event-category-78tcBemo.mjs";
3
3
  import { i as DeviceType, o as errMsg } from "./device-type-CbDhVwFP.mjs";
4
4
  //#region src/generated/cap-input-defaults.ts
@@ -648,6 +648,21 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
648
648
  * trick with `ts` for the two hot caps; this is the same idea, declared.
649
649
  */
650
650
  readonly volatileStateFields?: readonly string[];
651
+ /**
652
+ * The ONLY fields of a `durability: 'restored'` slice that reach disk and are
653
+ * seeded back at boot (D1024). Absent = the whole slice, as for every other
654
+ * restored cap.
655
+ *
656
+ * For a slice that is mostly live reading but carries one thing a provider can
657
+ * never re-report — `climate-control.lastActiveMode`: after a restart the
658
+ * provider says the mode it is in NOW, never the one it ran before it was
659
+ * switched off. Every other field stays a session value, re-read from the
660
+ * provider, so nothing stale is served after a restart.
661
+ *
662
+ * Requires `durability: 'restored'`; every name must be a field of
663
+ * `runtimeState` (`scripts/check-runtime-state-durability.ts`).
664
+ */
665
+ readonly restoredStateFields?: readonly string[];
651
666
  /**
652
667
  * Which `runtimeState` fields are recorded as long-term history series
653
668
  * (D850), or `'none'`. Mandatory for every cap declaring `runtimeState` —
@@ -76,6 +76,14 @@ export declare const ClimateControlStatusSchema: z.ZodObject<{
76
76
  minTemp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
77
77
  maxTemp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
78
78
  tempStep: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
79
+ lastActiveMode: z.ZodOptional<z.ZodEnum<{
80
+ auto: "auto";
81
+ cool: "cool";
82
+ dry: "dry";
83
+ fan_only: "fan_only";
84
+ heat: "heat";
85
+ heat_cool: "heat_cool";
86
+ }>>;
79
87
  lastFetchedAt: z.ZodNumber;
80
88
  }, z.core.$strip>;
81
89
  export type ClimateControlStatus = z.infer<typeof ClimateControlStatusSchema>;
@@ -163,6 +171,14 @@ export declare const climateControlCapability: {
163
171
  minTemp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
164
172
  maxTemp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
165
173
  tempStep: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
174
+ lastActiveMode: z.ZodOptional<z.ZodEnum<{
175
+ auto: "auto";
176
+ cool: "cool";
177
+ dry: "dry";
178
+ fan_only: "fan_only";
179
+ heat: "heat";
180
+ heat_cool: "heat_cool";
181
+ }>>;
166
182
  lastFetchedAt: z.ZodNumber;
167
183
  }, z.core.$strip>;
168
184
  readonly kind: 'push';
@@ -206,6 +222,14 @@ export declare const climateControlCapability: {
206
222
  minTemp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
207
223
  maxTemp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
208
224
  tempStep: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
225
+ lastActiveMode: z.ZodOptional<z.ZodEnum<{
226
+ auto: "auto";
227
+ cool: "cool";
228
+ dry: "dry";
229
+ fan_only: "fan_only";
230
+ heat: "heat";
231
+ heat_cool: "heat_cool";
232
+ }>>;
209
233
  lastFetchedAt: z.ZodNumber;
210
234
  }, z.core.$strip>;
211
235
  /**
@@ -214,7 +238,8 @@ export declare const climateControlCapability: {
214
238
  * See `RuntimeStateDurability`. Enforced by
215
239
  * `scripts/check-runtime-state-durability.ts`.
216
240
  */
217
- readonly durability: 'session';
241
+ readonly durability: 'restored';
242
+ readonly restoredStateFields: readonly ["lastActiveMode"];
218
243
  /**
219
244
  * History (D850): recorded series. Celsius by contract; setpoints keep every change (`minIntervalMs: 0`).
220
245
  */
@@ -66,6 +66,6 @@ export declare const enumSensorCapability: {
66
66
  };
67
67
  /** Clock fields: written, but excluded from the compare that decides
68
68
  * whether persisting is worth a SQLite commit. */
69
- readonly volatileStateFields: readonly ["lastFetchedAt"];
69
+ readonly volatileStateFields: readonly ["lastFetchedAt", "timestamp"];
70
70
  };
71
71
  export type IEnumSensorProvider = InferProvider<typeof enumSensorCapability>;