@camstack/types 1.2.247 → 1.2.249

package/dist/capabilities/osd-manager.cap.d.ts

@@ -168,6 +168,10 @@ export declare const OsdSlotBindingSchema: z.ZodObject<{
                 "alarm-disarmed": "alarm-disarmed";
                 "alarm-arming": "alarm-arming";
                 "alarm-arm-refused": "alarm-arm-refused";
+                "alarm-pending": "alarm-pending";
+                "alarm-rearmed": "alarm-rearmed";
+                "alarm-sensor-bypass": "alarm-sensor-bypass";
+                "alarm-check-failed": "alarm-check-failed";
                 "addon-updated": "addon-updated";
                 "server-updated": "server-updated";
                 "export-completed": "export-completed";
@@ -339,6 +343,10 @@ export declare const OsdSlotViewSchema: z.ZodObject<{
                     "alarm-disarmed": "alarm-disarmed";
                     "alarm-arming": "alarm-arming";
                     "alarm-arm-refused": "alarm-arm-refused";
+                    "alarm-pending": "alarm-pending";
+                    "alarm-rearmed": "alarm-rearmed";
+                    "alarm-sensor-bypass": "alarm-sensor-bypass";
+                    "alarm-check-failed": "alarm-check-failed";
                     "addon-updated": "addon-updated";
                     "server-updated": "server-updated";
                     "export-completed": "export-completed";
@@ -582,6 +590,10 @@ export declare const osdManagerCapability: {
                                 "alarm-disarmed": "alarm-disarmed";
                                 "alarm-arming": "alarm-arming";
                                 "alarm-arm-refused": "alarm-arm-refused";
+                                "alarm-pending": "alarm-pending";
+                                "alarm-rearmed": "alarm-rearmed";
+                                "alarm-sensor-bypass": "alarm-sensor-bypass";
+                                "alarm-check-failed": "alarm-check-failed";
                                 "addon-updated": "addon-updated";
                                 "server-updated": "server-updated";
                                 "export-completed": "export-completed";
@@ -842,6 +854,10 @@ export declare const osdManagerCapability: {
                             "alarm-disarmed": "alarm-disarmed";
                             "alarm-arming": "alarm-arming";
                             "alarm-arm-refused": "alarm-arm-refused";
+                            "alarm-pending": "alarm-pending";
+                            "alarm-rearmed": "alarm-rearmed";
+                            "alarm-sensor-bypass": "alarm-sensor-bypass";
+                            "alarm-check-failed": "alarm-check-failed";
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";
@@ -1012,6 +1028,10 @@ export declare const osdManagerCapability: {
                                 "alarm-disarmed": "alarm-disarmed";
                                 "alarm-arming": "alarm-arming";
                                 "alarm-arm-refused": "alarm-arm-refused";
+                                "alarm-pending": "alarm-pending";
+                                "alarm-rearmed": "alarm-rearmed";
+                                "alarm-sensor-bypass": "alarm-sensor-bypass";
+                                "alarm-check-failed": "alarm-check-failed";
                                 "addon-updated": "addon-updated";
                                 "server-updated": "server-updated";
                                 "export-completed": "export-completed";
@@ -1214,6 +1234,10 @@ export declare const osdManagerCapability: {
                             "alarm-disarmed": "alarm-disarmed";
                             "alarm-arming": "alarm-arming";
                             "alarm-arm-refused": "alarm-arm-refused";
+                            "alarm-pending": "alarm-pending";
+                            "alarm-rearmed": "alarm-rearmed";
+                            "alarm-sensor-bypass": "alarm-sensor-bypass";
+                            "alarm-check-failed": "alarm-check-failed";
                             "addon-updated": "addon-updated";
                             "server-updated": "server-updated";
                             "export-completed": "export-completed";

package/dist/device/linked-device-resolve.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Which devices a camera's LINKED set resolves to — the pure rules, with no
+ * store and no provider context.
+ *
+ * They live in `@camstack/types` rather than in the device-manager builtin
+ * because two surfaces need the SAME answer and a second copy would be a
+ * second definition of what a room contains: the hub's boot backfill, and the
+ * admin UI's per-room rebuild. Moving them here also keeps that button a
+ * framework-free change — a new cap method would only reach a node through a
+ * published `@camstack/server` and a restart (D16), which is not what a
+ * convenience button is worth.
+ */
+import { DeviceType } from './device-type.js';
+/** The device fields the pure resolver consumes (subset of `DeviceInfo`). */
+export interface LinkCandidate {
+    readonly id: number;
+    readonly parentDeviceId: number | null;
+    readonly location: string | null;
+    readonly type: DeviceType;
+    /**
+     * The child identity a container's stored pick is matched against. A NOT
+     * NULL column, so `slim` carries it — which is the whole reason the pick is
+     * keyed on it (see `ContainerChildRef.stableId`).
+     */
+    readonly stableId: string;
+    /** The container's own operator pick, when one was made. */
+    readonly primaryChildEntityId?: string | null;
+    /**
+     * The child's `DeviceRole`. Ranked ABOVE `type` when a container picks the
+     * child it stands for, because `DeviceType` cannot tell a door contact from a
+     * battery reading — Home Assistant maps both to `Sensor`. A first-class meta
+     * column, so `slim` carries it.
+     */
+    readonly role?: string | null | undefined;
+    /** Operator-facing name — used for the namesake tiebreak. Also a column. */
+    readonly name?: string;
+}
+/**
+ * Resolve one candidate id to the ids it should actually contribute to a
+ * linked set: itself, unless it is a CONTAINER, in which case its own
+ * children (recursively expanded the same way — a container-of-containers
+ * is vanishingly unlikely per `DeviceType.Container`'s contract, but this
+ * costs nothing to handle). `visited` guards a pathological parent-cycle in
+ * persisted data from recursing forever; a candidate already on the current
+ * expansion path is dropped rather than re-expanded.
+ *
+ * This is the STRUCTURAL, location-independent way a container's child
+ * becomes reachable: the device-tree "children of the camera" rule and a
+ * persisted manual pick are parentDeviceId chains, never location-based —
+ * a container named there is excluded by expanding into whatever it
+ * actually contains, regardless of what its (or its children's) `location`
+ * column holds.
+ */
+export declare function expandContainer(id: number, byId: ReadonlyMap<number, LinkCandidate>, byParent: ReadonlyMap<number, readonly LinkCandidate[]>, visited: ReadonlySet<number>, out: Set<number>): void;
+/**
+ * What the retired `auto` mode (pre-D356) added beyond the device-tree
+ * children: every non-container candidate sharing the camera's location, a
+ * container child standing in for its container's PRIMARY child.
+ *
+ * Two callers, both WRITERS, never the read path: the one-shot boot backfill
+ * that materialises it into the manual list
+ * (`linked-devices-manual-backfill.ts`), and the admin UI's per-room rebuild.
+ * Both ask "what does this room contain", and a second copy of the answer is
+ * how two surfaces start disagreeing about a room.
+ *
+ * A camera with NO location answers `[]`. A caller that would WRITE that must
+ * refuse instead: emptying a list because nobody set the room is the silent
+ * drop D391 names.
+ */
+export declare function legacyAutoLinkIds(params: {
+    readonly selfId: number;
+    readonly selfLocation: string | null;
+    readonly candidates: readonly LinkCandidate[];
+}): readonly number[];

package/dist/generated/addon-api.d.ts

@@ -4875,6 +4875,20 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof notificationRulesCapability.methods.getConditionCatalog.output>;
             meta: object;
         }>;
+        getTemplateCatalog: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof notificationRulesCapability.methods.getTemplateCatalog.input>;
+            output: z.infer<typeof notificationRulesCapability.methods.getTemplateCatalog.output>;
+            meta: object;
+        }>;
+        previewTemplate: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof notificationRulesCapability.methods.previewTemplate.input>;
+            output: z.infer<typeof notificationRulesCapability.methods.previewTemplate.output>;
+            meta: object;
+        }>;
         getHistory: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;

package/dist/generated/collection-array-methods.d.ts

@@ -17,3 +17,21 @@ export declare const COLLECTION_ARRAY_METHODS: Readonly<Record<string, readonly
  * `isCollectionArrayMethod(capDefsByName.get(capName), method)`.
  */
 export declare function isCollectionArrayMethodName(capName: string, method: string): boolean;
+/**
+ * Per capability, the methods declared `optionalMethod` — the ones whose
+ * ABSENCE on a provider is a fact about that provider, not a bug.
+ *
+ * Coverage: 1 caps, 4 methods.
+ */
+export declare const PROVIDER_OPTIONAL_METHODS: Readonly<Record<string, readonly string[]>>;
+/**
+ * True when `method` on cap `capName` is declared `optionalMethod`.
+ *
+ * `providerOptional` used to be a TYPE-only flag: it made the method optional
+ * on `InferProvider` and nothing read it at runtime, so a source that
+ * honestly did not implement one produced `INTERNAL_SERVER_ERROR` — the same
+ * signature as a method somebody forgot. Measured on the live hub 2026-09-24:
+ * `videoclips.getPlaybackOptions` at the recorder's `analytics` source, a
+ * time WINDOW with no file behind it, threw on every player open.
+ */
+export declare function isProviderOptionalMethodName(capName: string, method: string): boolean;

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: 1170 method paths across 160 capabilities.
+ * Coverage: 1172 method paths across 160 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/index.d.ts

@@ -157,6 +157,7 @@ export type { BatteryPresence, BatteryPresenceInput } from './device/battery-pre
 export { BATTERY_UNREACHABLE_AFTER_MS, deriveBatteryPresence, isBatteryPresenceFault, } from './device/battery-presence.js';
 export type { ICameraDevice, StreamSourceEntry } from './device/camera-device.js';
 export { CONTAINER_CHILD_PRIORITY, type ContainerChildRef, resolveContainerPrimaryChild, } from './device/container-primary-child.js';
+export { expandContainer, legacyAutoLinkIds, type LinkCandidate, } from './device/linked-device-resolve.js';
 export type { DeclarationPlacement, DeclaredDeviceOutcome, DeclaredDevicePorts, DeclaredDeviceRow, DeclaredDevicesResult, DeclaredDevicesSpec, DeclaredIntegrationRow, DeviceDeclaration, } from './device/declared-device.js';
 export { DECLARED_DEVICE_SWEEP_LIMIT, DECLARED_INTEGRATION_FIXED_KEY, DeclaredDevices, declarationOwnerNodeId, } from './device/declared-device.js';
 export type { IDevice } from './device/device.js';
@@ -227,6 +228,7 @@ export { type PreparedAction, type PreparedAttachment, type PreparedNotification
 export { htmlToText, markdownToHtmlLite, markdownToText, type NotificationFormat as NotificationBodyFormat, resolveFormat, textToHtml, transcodeBody, } from './notification/format-transcode.js';
 export { conditionExclusionReason, conditionVisibleForKind, defaultDeliveryForSection, droppedConditionsForKind, isAudioRule, isOccupancyRule, isSystemDelivery, NC_AUDIO_SEED, NC_OCCUPANCY_DEFAULTS, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_RULE_SECTIONS, NC_SYSTEM_DELIVERY, type NcDroppedCondition, type NcKindVisibilitySubject, type NcRuleEditorSection, type NcRuleEditorSectionKey, type NcRuleKind, type NcRuleKindSpec, type NcRuleOwningSectionKey, type NcRuleSection, type NcRuleSectionKey, type NcRuleSectionSubject, type NcRuleSeed, parseRuleSection, ruleEditorSectionsForKind, ruleKindOf, ruleKindSpec, ruleMatchesSection, ruleSection, ruleSectionOf, ruleSeedForSection, } from './notification/rule-kinds.js';
 export { isScheduleActive } from './notification/schedule.js';
+export { NC_TEMPLATE_VARS, isKnownTemplateVar, templateVarsFor, } from './notification/template-vars.js';
 export { NC_SYSTEM_EVENT_FILTER_KEYS, type NcSystemEventFilterKey, systemEventFilterApplies, systemEventFilterAppliesToAnyKind, } from './notification/system-event-filters.js';
 export type { TimelapseCadencePair, TimelapsePreviewMode, TimelapseRule, TimelapseRuleInput, TimelapseRulePatch, TimelapseTemplate, } from './notification/timelapse-rule.js';
 export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseGeneratedAt, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, } from './notification/timelapse-rule.js';