@camstack/types 1.2.267 → 1.2.268

package/dist/addon.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-8K9gue-H.js");
-const require_event_category = require("./event-category-BVfsrBYA.js");
-const require_err_msg = require("./err-msg-COpsHMw2.js");
+const require_sleep = require("./sleep-BSzia-xT.js");
+const require_event_category = require("./event-category-MbnB-6AN.js");
+const require_err_msg = require("./err-msg-Dx2Kor0g.js");
 //#region src/generated/cap-input-defaults.ts
 /**
 * AUTO-GENERATED by scripts/generate-cap-input-defaults.ts — DO NOT EDIT.
@@ -388,7 +388,7 @@ exports.COLLECTION_ARRAY_METHODS = COLLECTION_ARRAY_METHODS;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;
 exports.DEVICE_CHILDREN_BATCH_MAX = require_sleep.DEVICE_CHILDREN_BATCH_MAX;
 exports.DEVICE_SCOPED_CAPS = require_sleep.DEVICE_SCOPED_CAPS;
-exports.DeviceType = require_sleep.DeviceType;
+exports.DeviceType = require_err_msg.DeviceType;
 exports.DisposerChain = require_sleep.DisposerChain;
 exports.EventCategory = require_event_category.EventCategory;
 exports.PEER_BYTES_CHUNK_BYTES = require_sleep.PEER_BYTES_CHUNK_BYTES;

package/dist/addon.mjs

@@ -1,6 +1,6 @@
-import { A as DeviceType, At as DATAPLANE_SECRET_HEADER, Dt as PEER_BYTES_STALL_MS, Et as PEER_BYTES_MAX_OUTSTANDING, G as readNodePin, J as ReadinessTimeoutError, L as expandCapMethods, Mt as DisposerChain, Nt as BaseAddon, Ot as PEER_BYTES_TICKET_TTL_MS, Pt as normalizeAddonInitResult, Rt as emitReadiness, S as DEVICE_CHILDREN_BATCH_MAX, T as describeCustomActions, Tt as PEER_BYTES_CHUNK_BYTES, W as nodePin, Z as scopeKey, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, j as adminUiCapability, m as createDeviceProxy, p as isDeviceScopedCap, q as ReadinessRegistry, s as asString, t as sleep, u as parseJsonUnknown, x as viewerUiCapability } from "./sleep-DC-wdyeS.mjs";
-import { t as EventCategory } from "./event-category-BVDXG4tB.mjs";
-import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
+import { At as normalizeAddonInitResult, B as nodePin, Ct as PEER_BYTES_STALL_MS, D as adminUiCapability, Et as DATAPLANE_SECRET_HEADER, N as expandCapMethods, Ot as DisposerChain, Pt as emitReadiness, S as DEVICE_CHILDREN_BATCH_MAX, St as PEER_BYTES_MAX_OUTSTANDING, T as describeCustomActions, U as ReadinessRegistry, V as readNodePin, W as ReadinessTimeoutError, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, kt as BaseAddon, m as createDeviceProxy, p as isDeviceScopedCap, q as scopeKey, s as asString, t as sleep, u as parseJsonUnknown, wt as PEER_BYTES_TICKET_TTL_MS, x as viewerUiCapability, xt as PEER_BYTES_CHUNK_BYTES } from "./sleep-jkRQgtSc.mjs";
+import { t as EventCategory } from "./event-category-C5xZWqz6.mjs";
+import { a as DeviceType, t as errMsg } from "./err-msg-DX6i_MY4.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**
 * AUTO-GENERATED by scripts/generate-cap-input-defaults.ts — DO NOT EDIT.

package/dist/capabilities/battery.cap.d.ts

@@ -27,7 +27,7 @@ export declare const batteryCapability: {
     readonly scope: "device";
     readonly deviceNative: true;
     readonly mode: "singleton";
-    readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch];
+    readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container];
     readonly methods: {
         /**
          * Explicitly wake the camera from low-power sleep ahead of a
@@ -53,6 +53,21 @@ export declare const batteryCapability: {
             durationMs: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
     };
+    /**
+     * A composed provider (battery ADDED to a pet feeder or container that has
+     * no wake surface) answers `wakeForStream` with the same "unavailable"
+     * result the contract already defines above: "Returns `awoke: false` when
+     * … the cap surface is unavailable." (D663).
+     */
+    readonly composedMethods: {
+        readonly wakeForStream: {
+            readonly kind: "answer";
+            readonly value: {
+                readonly awoke: false;
+                readonly durationMs: 0;
+            };
+        };
+    };
     readonly events: {
         /**
          * Emitted whenever the cached status changes (firmware push OR
@@ -95,7 +110,7 @@ export declare const batteryCapability: {
         }, z.core.$strip>;
         readonly kind: "push";
         readonly empty: {
-            readonly percentage: 0;
+            readonly percentage: null;
             readonly charging: "unknown";
             readonly sleeping: false;
             readonly lastUpdated: 0;

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

@@ -370,6 +370,20 @@ export interface DeviceConfigSpec {
 export type RuntimeStateDurability = 'session' | 'restored';
 /** The default applied to a `runtimeState` cap that declares no `durability`. */
 export declare const DEFAULT_RUNTIME_STATE_DURABILITY: RuntimeStateDurability;
+/**
+ * How a COMPOSED provider answers a method it cannot forward yet (D663). A
+ * composition that ADDS a cap to a device serves this cap's methods from here
+ * until `forward` arrives (slice 3). A cap with a served method that is NOT
+ * listed stays uncomposable (`has-commands`). Only an answer the cap's own
+ * contract already defines as "not available" belongs here.
+ */
+export type ComposedMethodAnswer = {
+    readonly kind: 'refuse';
+    readonly reason: string;
+} | {
+    readonly kind: 'answer';
+    readonly value: unknown;
+};
 /**
  * Full definition of a capability — the single source of truth for the
  * functional contract (methods + events).
@@ -426,6 +440,14 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
      *  from `scope:'device'` SYSTEM caps (zones/recording/motion/events) whose
      *  single provider dispatches on deviceId internally. Default: undefined/false. */
     readonly deviceNative?: boolean;
+    /**
+     * How a COMPOSED provider answers a method it cannot forward yet (D663). A
+     * composition that ADDS a cap to a device serves this cap's methods from
+     * here until `forward` arrives (slice 3). A cap with a served method that
+     * is NOT listed stays uncomposable (`has-commands`). Only an answer the
+     * cap's own contract already defines as "not available" belongs here.
+     */
+    readonly composedMethods?: Readonly<Record<string, ComposedMethodAnswer>>;
     /** Method definitions: name → { input, output } Zod schemas */
     readonly methods: TMethods;
     /** Event definitions: name → { data } Zod schema (optional) */

package/dist/capabilities/composer.cap.d.ts

@@ -56,6 +56,36 @@ export declare const ComposerBlockSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"code">;
                 code: z.ZodString;
             }, z.core.$strip>], "kind">>;
+            items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                label: z.ZodString;
+                fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    source: z.ZodObject<{
+                        addonId: z.ZodString;
+                        stableId: z.ZodString;
+                    }, z.core.$strip>;
+                    cap: z.ZodString;
+                    fieldPath: z.ZodString;
+                    kind: z.ZodLiteral<"from">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"expression">;
+                    expr: z.ZodString;
+                    bindings: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        source: z.ZodObject<{
+                            addonId: z.ZodString;
+                            stableId: z.ZodString;
+                        }, z.core.$strip>;
+                        cap: z.ZodString;
+                        fieldPath: z.ZodString;
+                        kind: z.ZodLiteral<"from">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        kind: z.ZodLiteral<"literal">;
+                        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+                    }, z.core.$strip>], "kind">>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"code">;
+                    code: z.ZodString;
+                }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>>>;
             commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"forward">;
                 source: z.ZodObject<{
@@ -141,6 +171,36 @@ export declare const ComposerApplyInputSchema: z.ZodObject<{
                     kind: z.ZodLiteral<"code">;
                     code: z.ZodString;
                 }, z.core.$strip>], "kind">>;
+                items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    label: z.ZodString;
+                    fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        source: z.ZodObject<{
+                            addonId: z.ZodString;
+                            stableId: z.ZodString;
+                        }, z.core.$strip>;
+                        cap: z.ZodString;
+                        fieldPath: z.ZodString;
+                        kind: z.ZodLiteral<"from">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        kind: z.ZodLiteral<"expression">;
+                        expr: z.ZodString;
+                        bindings: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            source: z.ZodObject<{
+                                addonId: z.ZodString;
+                                stableId: z.ZodString;
+                            }, z.core.$strip>;
+                            cap: z.ZodString;
+                            fieldPath: z.ZodString;
+                            kind: z.ZodLiteral<"from">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            kind: z.ZodLiteral<"literal">;
+                            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+                        }, z.core.$strip>], "kind">>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        kind: z.ZodLiteral<"code">;
+                        code: z.ZodString;
+                    }, z.core.$strip>], "kind">>;
+                }, z.core.$strip>>>;
                 commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"forward">;
                     source: z.ZodObject<{
@@ -178,6 +238,7 @@ export declare const ComposerBlockVerdictSchema: z.ZodObject<{
         failed: "failed";
         stopped: "stopped";
         starting: "starting";
+        degraded: "degraded";
     }>;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -190,6 +251,7 @@ export declare const ComposerApplyResultSchema: z.ZodObject<{
             failed: "failed";
             stopped: "stopped";
             starting: "starting";
+            degraded: "degraded";
         }>;
         reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
@@ -256,6 +318,36 @@ export declare const composerCapability: {
                             kind: z.ZodLiteral<"code">;
                             code: z.ZodString;
                         }, z.core.$strip>], "kind">>;
+                        items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                            label: z.ZodString;
+                            fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                source: z.ZodObject<{
+                                    addonId: z.ZodString;
+                                    stableId: z.ZodString;
+                                }, z.core.$strip>;
+                                cap: z.ZodString;
+                                fieldPath: z.ZodString;
+                                kind: z.ZodLiteral<"from">;
+                            }, z.core.$strip>, z.ZodObject<{
+                                kind: z.ZodLiteral<"expression">;
+                                expr: z.ZodString;
+                                bindings: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                    source: z.ZodObject<{
+                                        addonId: z.ZodString;
+                                        stableId: z.ZodString;
+                                    }, z.core.$strip>;
+                                    cap: z.ZodString;
+                                    fieldPath: z.ZodString;
+                                    kind: z.ZodLiteral<"from">;
+                                }, z.core.$strip>, z.ZodObject<{
+                                    kind: z.ZodLiteral<"literal">;
+                                    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+                                }, z.core.$strip>], "kind">>;
+                            }, z.core.$strip>, z.ZodObject<{
+                                kind: z.ZodLiteral<"code">;
+                                code: z.ZodString;
+                            }, z.core.$strip>], "kind">>;
+                        }, z.core.$strip>>>;
                         commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
                             kind: z.ZodLiteral<"forward">;
                             source: z.ZodObject<{
@@ -292,6 +384,7 @@ export declare const composerCapability: {
                     failed: "failed";
                     stopped: "stopped";
                     starting: "starting";
+                    degraded: "degraded";
                 }>;
                 reason: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
@@ -308,11 +401,17 @@ export declare const composerCapability: {
                     failed: "failed";
                     stopped: "stopped";
                     starting: "starting";
+                    degraded: "degraded";
                 }>;
                 reason: z.ZodOptional<z.ZodString>;
                 fields: z.ZodArray<z.ZodObject<{
                     cap: z.ZodString;
                     path: z.ZodString;
+                    item: z.ZodOptional<z.ZodObject<{
+                        arrayPath: z.ZodString;
+                        key: z.ZodString;
+                        label: z.ZodString;
+                    }, z.core.$strip>>;
                     state: z.ZodEnum<{
                         unavailable: "unavailable";
                         fresh: "fresh";

package/dist/capabilities/consumables.cap.d.ts

@@ -13,6 +13,25 @@ import { DeviceType } from '../device/device-type.js';
  * provider populates it by guessing (no HA inference). The UI renders a
  * "No consumables reported" placeholder when `items` is empty.
  */
+/** Units a remaining-life counter is reported in. Closed: the panel renders
+ *  each. */
+export declare const ConsumableRemainingUnitSchema: z.ZodEnum<{
+    cycles: "cycles";
+    days: "days";
+    hours: "hours";
+}>;
+export type ConsumableRemainingUnit = z.infer<typeof ConsumableRemainingUnitSchema>;
+/** Remaining life as a COUNT, not a percentage (the PetKit desiccant reports
+ *  days). `value` null = unknown (D393). */
+export declare const ConsumableRemainingSchema: z.ZodObject<{
+    value: z.ZodNullable<z.ZodNumber>;
+    unit: z.ZodEnum<{
+        cycles: "cycles";
+        days: "days";
+        hours: "hours";
+    }>;
+}, z.core.$strip>;
+export type ConsumableRemaining = z.infer<typeof ConsumableRemainingSchema>;
 /** A single consumable item. Either a continuous `level` (remaining
  *  life %) or a discrete `status` may be known — both may be null when a
  *  provider only knows the item exists. `level` and `status` are not
@@ -27,6 +46,14 @@ export declare const ConsumableItemSchema: z.ZodObject<{
     }>>;
     lastResetAt: z.ZodNullable<z.ZodNumber>;
     resettable: z.ZodBoolean;
+    remaining: z.ZodOptional<z.ZodObject<{
+        value: z.ZodNullable<z.ZodNumber>;
+        unit: z.ZodEnum<{
+            cycles: "cycles";
+            days: "days";
+            hours: "hours";
+        }>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const ConsumablesStatusSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
@@ -39,6 +66,14 @@ export declare const ConsumablesStatusSchema: z.ZodObject<{
         }>>;
         lastResetAt: z.ZodNullable<z.ZodNumber>;
         resettable: z.ZodBoolean;
+        remaining: z.ZodOptional<z.ZodObject<{
+            value: z.ZodNullable<z.ZodNumber>;
+            unit: z.ZodEnum<{
+                cycles: "cycles";
+                days: "days";
+                hours: "hours";
+            }>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     lastChangedAt: z.ZodNumber;
 }, z.core.$strip>;
@@ -68,6 +103,18 @@ export declare const consumablesCapability: {
             key: z.ZodString;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
+    /**
+     * A composed consumable (item added to a device with no native consumables
+     * provider) refuses `reset` by name: "Only meaningful when the item's
+     * `resettable` is true" — a composed item is never resettable until
+     * commands (`forward`) arrive in slice 3 (D663).
+     */
+    readonly composedMethods: {
+        readonly reset: {
+            readonly kind: "refuse";
+            readonly reason: "a composed consumable is not resettable until commands (forward) arrive — slice 3";
+        };
+    };
     readonly status: {
         readonly schema: z.ZodObject<{
             items: z.ZodArray<z.ZodObject<{
@@ -80,6 +127,14 @@ export declare const consumablesCapability: {
                 }>>;
                 lastResetAt: z.ZodNullable<z.ZodNumber>;
                 resettable: z.ZodBoolean;
+                remaining: z.ZodOptional<z.ZodObject<{
+                    value: z.ZodNullable<z.ZodNumber>;
+                    unit: z.ZodEnum<{
+                        cycles: "cycles";
+                        days: "days";
+                        hours: "hours";
+                    }>;
+                }, z.core.$strip>>;
             }, z.core.$strip>>;
             lastChangedAt: z.ZodNumber;
         }, z.core.$strip>;
@@ -92,6 +147,10 @@ export declare const consumablesCapability: {
                 status: "replace" | "ok" | null;
                 lastResetAt: number | null;
                 resettable: boolean;
+                remaining?: {
+                    value: number | null;
+                    unit: "cycles" | "days" | "hours";
+                } | undefined;
             }[];
             lastChangedAt: number;
         };
@@ -109,6 +168,14 @@ export declare const consumablesCapability: {
                 }>>;
                 lastResetAt: z.ZodNullable<z.ZodNumber>;
                 resettable: z.ZodBoolean;
+                remaining: z.ZodOptional<z.ZodObject<{
+                    value: z.ZodNullable<z.ZodNumber>;
+                    unit: z.ZodEnum<{
+                        cycles: "cycles";
+                        days: "days";
+                        hours: "hours";
+                    }>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
             readonly emptyItem: {
                 key: string;
@@ -117,6 +184,10 @@ export declare const consumablesCapability: {
                 status: "replace" | "ok" | null;
                 lastResetAt: number | null;
                 resettable: boolean;
+                remaining?: {
+                    value: number | null;
+                    unit: "cycles" | "days" | "hours";
+                } | undefined;
             };
         };
     };
@@ -131,6 +202,14 @@ export declare const consumablesCapability: {
             }>>;
             lastResetAt: z.ZodNullable<z.ZodNumber>;
             resettable: z.ZodBoolean;
+            remaining: z.ZodOptional<z.ZodObject<{
+                value: z.ZodNullable<z.ZodNumber>;
+                unit: z.ZodEnum<{
+                    cycles: "cycles";
+                    days: "days";
+                    hours: "hours";
+                }>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         lastChangedAt: z.ZodNumber;
         lastFetchedAt: z.ZodNumber;