@camstack/types 1.2.280 → 1.2.282

package/dist/notification/rule-kinds.d.ts

@@ -201,6 +201,59 @@ export interface NcRuleSectionSubject {
     readonly delivery: string;
     readonly conditions: NcRuleConditionsSubject;
 }
+/**
+ * Which capability a device must carry to be OFFERED on a rule of this kind's
+ * device-scope picker (operator ruling, 2026-10-01). `null` means "no
+ * capability filter for this kind" — either every device applies (the system
+ * families, each already a separate concern; see
+ * `docs/architecture/notifications.md`'s D637 `deviceIds` table) or `mixed`,
+ * which authors nothing.
+ *
+ * DERIVED, never a hand-picked list:
+ *  - `sensor` reads `EVENTFUL_CAP_NAMES` — the SAME cap table the engine
+ *    itself turns a linked device's bound caps into sensor event kinds with
+ *    (`EVENT_KIND_BY_CAP`). A device this picker offers for a sensor rule is
+ *    exactly a device the rule's `sensorKinds` condition could ever name.
+ *  - `detection` (which a package-event rule is — there is no separate
+ *    `package` kind, D637) / `occupancy` read the one pipeline cap a camera
+ *    needs to produce the detections / counts / parcels those kinds match on.
+ *  - `sound` reads the one cap a device needs to produce the audio metrics a
+ *    sound rule's sampling window is built from.
+ *  - `device-events` / `system` / `alarm` / `mixed` are `null`: a device
+ *    event rule's `deviceIds` legitimately spans every device type (liveness,
+ *    battery, consumable, `detection-blind`), a system rule has no device
+ *    scope at all (dropped from the editor's tabs), and `alarm`'s `deviceIds`
+ *    is a reference to whichever camera's rule set it off — not a scope this
+ *    picker authors.
+ *
+ * Callers resolve the ids via `deviceManager.listDeviceIdsByCaps` (max 16
+ * names — `EVENTFUL_CAP_NAMES` is exactly 16) and must treat an unanswered
+ * read as "unknown", never as "no devices" (D315): this function only names
+ * WHICH caps to ask for, not what to show while the answer is pending.
+ */
+export declare function ruleDeviceCompatCapNames(kind: NcRuleKind): readonly string[] | null;
+/**
+ * The capability every CAMERA carries: `camera-streams` is a `defaultActive`
+ * wrapper bound to every `Camera`-type device (`camera-streams.cap.ts`).
+ * Named once, because a sensor rule's compatible set needs it (below).
+ */
+export declare const NC_CAMERA_SCOPE_CAP_NAME = "camera-streams";
+/**
+ * Every capability QUERY whose union is the set of devices a rule of this kind
+ * may be SCOPED to (`conditions.devices`) — what the save-time guard and the
+ * admin's Devices tab ask `deviceManager.listDeviceIdsByCaps`, one call per
+ * entry. `null` exactly where {@link ruleDeviceCompatCapNames} is `null`.
+ *
+ * Several queries rather than one list because `listDeviceIdsByCaps` takes at
+ * most 16 names and `EVENTFUL_CAP_NAMES` is already exactly 16.
+ *
+ * A `sensor` rule's set is the eventful devices PLUS every camera (fix round
+ * 1, 2026-10-01): the engine matches a sensor rule scoped to a CAMERA — a
+ * per-camera row carries the camera's id, and a linked set matches on
+ * `rowCameraIds` (D630 §6) — so a camera-scoped sensor rule is legitimate and
+ * a guard that refused it would make every such stored rule un-editable.
+ */
+export declare function ruleDeviceCompatCapQueries(kind: NcRuleKind): readonly (readonly string[])[] | null;
 /**
  * Which kind of rule is this?
  *
@@ -279,7 +332,7 @@ export declare function droppedConditionsForKind(conditions: NcAuthoredCondition
  * the stored system rules that span families. `mixed` is a real, owning section
  * (a rule must be listed somewhere) that nothing can CREATE into.
  */
-export type NcRuleSectionKey = 'all' | 'detection' | 'audio' | 'occupancy' | 'device-events' | 'system' | 'alarm' | 'mixed';
+export type NcRuleSectionKey = 'all' | 'detection' | 'sensor' | 'audio' | 'occupancy' | 'device-events' | 'system' | 'alarm' | 'mixed';
 export interface NcRuleSection {
     readonly key: NcRuleSectionKey;
     /** English fallback; the viewer maps `key` onto an i18n key. */
@@ -308,15 +361,20 @@ export declare function isOccupancyRule(subject: NcRuleSectionSubject): boolean;
  * `all` always matches — a section that hides a rule is how an operator
  * concludes it was deleted. The others PARTITION the list: sound and
  * occupancy are claimed by their condition, a system-event rule by its trigger
- * and then by the family of its event kinds (or `mixed`, D637), and
- * everything left over — including a trigger this build has never heard of —
- * counts as a detection rule so it stays visible somewhere.
- *
- * Keyed on the CONDITION for two of them, because the trigger alone cannot
- * answer: a sound rule is `immediate` and an occupancy rule is `device-event`,
- * and in each case the condition is the discriminator the engine itself uses.
- * A section keyed on delivery would put both back in the pile they are
- * invisible in.
+ * and then by the family of its event kinds (or `mixed`, D637), `sensor`
+ * claims the `device-event` trigger that occupancy did not (operator ruling,
+ * 2026-10-01 — a doorbell press used to fall into `detection` for want of its
+ * own section, which is the "everything mixed together" the viewer's
+ * `ruleKindOf`-based list had already fixed and the admin's section strip had
+ * not), and everything left over — including a trigger this build has never
+ * heard of — counts as a detection rule so it stays visible somewhere.
+ *
+ * Keyed on the CONDITION for sound and occupancy, because the trigger alone
+ * cannot answer: a sound rule is `immediate` and an occupancy rule is
+ * `device-event`, and in each case the condition is the discriminator the
+ * engine itself uses. `sensor` IS keyed on the trigger, same as `ruleKindOf`'s
+ * `'sensor'` kind — a device-event subject with no occupancy condition is a
+ * sensor rule, full stop.
  */
 export declare function ruleMatchesSection(subject: NcRuleSectionSubject, section: NcRuleSectionKey): boolean;
 /** The ONE real section a rule lives in — `all` holds everything and is not it. */

package/package.json

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