@camstack/types 1.2.216 → 1.2.217

package/dist/capabilities/capability-definition.d.ts

@@ -127,6 +127,10 @@ export interface CapabilityEventSchema<TData extends z.ZodType = z.ZodType> {
 }
 export type CapabilityStatusKind = 'push' | 'poll' | 'command-driven';
 /**
+ * ⚠ NO LIVE CALLER since 2026-08-08 — see the note on
+ * {@link CapabilityStatusSchema.empty}. Kept as the shape a future wiring
+ * mechanism would need, not as something that runs today.
+ *
  * Declares that a cap's status is an ITEM-ARRAY wiring target: the status
  * holds an array of keyed items (`consumables.items`) that device-links can
  * populate per item via `DeviceLink.target.itemKey`. Links sharing an
@@ -161,6 +165,19 @@ export interface CapabilityStatusSchema<TStatus extends z.ZodType = z.ZodType> {
      * this cap (no native provider). Required-but-unlinked fields (enums,
      * timestamps) come from here so the synthesized status validates against
      * `schema`. Omit for caps that are never synthesize targets.
+     *
+     * ⚠ NO LIVE CALLER since 2026-08-08. The device-link mechanism this seeds was
+     * deleted that day — 302 devices, 0 links, a month after it shipped — and the
+     * only code that still reads this field is the `includeSynthesizable` branch
+     * of `getWireableFields`, which nothing passes `true` to. Four caps declare
+     * it (`battery`, `consumables`, `network-link`, `recording-signal`).
+     *
+     * KEPT, not deleted, and deliberately: the operator has a live request that
+     * needs exactly this shape (a Dreame's HA sensors presenting as
+     * `consumables`/`battery` on the robot) and has queued the wiring design for
+     * discussion. This marker exists so the field is not mistaken for working
+     * machinery in the meantime — which is the one thing a leftover must never
+     * be allowed to be.
      */
     readonly empty?: z.infer<TStatus>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.216",
+  "version": "1.2.217",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",