@camstack/types 1.2.297 → 1.2.299

package/dist/notification/alarm-membership.d.ts

@@ -10,10 +10,13 @@
  * fires, and the operator was never told. One predicate, so the engine and the
  * warning cannot disagree about which rules are the alarm.
  *
- * Structural inputs (conditions + the enabled `onTrigger` sequences), so the
+ * Structural inputs (conditions + the ENABLED on-match bindings), so the
  * admin's form state and the engine's rule both answer without a cast.
+ * Sequence bindings need {@link NcAlarmMembershipSubject.sequenceActionsOf} —
+ * without it a sequence-ref cannot prove membership (fail closed for the
+ * opening-edge refusal: better a closing notification than a silent open).
  */
-import type { NcConditions, NcRuleActionSequence } from '../capabilities/notification-rules.cap.js';
+import type { NcConditions, NcRuleAction, NcRuleActions } from '../capabilities/notification-rules.cap.js';
 /**
  * The sensor-event kinds that are OPENINGS to the alarm — the keys of the
  * engine's opening table (`alarm-openings.ts`, which is checked against this
@@ -31,14 +34,23 @@ export declare function isAlarmControllableCap(cap: string): cap is NcAlarmContr
 /** What the alarm-membership question reads off a rule. */
 export interface NcAlarmMembershipSubject {
     readonly conditions: Pick<NcConditions, 'deviceState' | 'sensorKinds' | 'sensorTransition'>;
-    readonly onTrigger?: readonly NcRuleActionSequence[];
+    /** The rule's actions block. Absent = no actuation. */
+    readonly actions?: NcRuleActions;
+    /**
+     * Resolve a shared sequence's steps. Required when an `onTrigger` binding is
+     * a sequence ref — without it that binding cannot prove membership.
+     */
+    readonly sequenceActionsOf?: (sequenceId: string) => readonly NcRuleAction[] | undefined;
 }
 /**
  * A rule belongs to the alarm when its `deviceState` gate names ANY device's
- * `armed_*` word, or an ENABLED `onTrigger` sequence pulls the alarm panel's
- * trigger (D630).
+ * `armed_*` word, or an on-match binding pulls the alarm panel's trigger
+ * (D630). Button-only sequences do NOT count — they are not an automatic
+ * escalation.
  */
 export declare function ruleBelongsToAlarm(rule: NcAlarmMembershipSubject): boolean;
+/** Copy the editors show when {@link sensorTransitionNeverFires} is true. */
+export declare const NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING = "This rule belongs to the alarm, and an alarm rule fires only when an opening OPENS. Set to \u201Conly when it clears\u201D, it can never fire.";
 /**
  * An alarm rule over openings only, asking for the CLEAR: the alarm edge
  * refuses every closing, and the chosen edge refuses every opening, so nothing
@@ -46,5 +58,3 @@ export declare function ruleBelongsToAlarm(rule: NcAlarmMembershipSubject): bool
  * can change with an action edit — but every editor must SAY it.
  */
 export declare function sensorTransitionNeverFires(rule: NcAlarmMembershipSubject): boolean;
-/** The warning an editor shows for {@link sensorTransitionNeverFires}. */
-export declare const NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING = "This rule belongs to the alarm, and an alarm rule fires only when an opening OPENS. Set to \u201Conly when it clears\u201D, it can never fire.";

package/dist/notification/alarm-profiles.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Alarm configuration profiles — named snapshots of {@link NcAlarmSettings}.
+ *
+ * One active profile globally (not per arm mode): summer vs winter is a whole
+ * membership set, and arm decisions always read the flat settings the active
+ * profile last applied. Pure functions only — no I/O, no clock.
+ *
+ * Create without a source → system defaults (empty memberships, stock delays).
+ * Create with `cloneFromId` → a copy of that profile's settings.
+ * The Default profile always exists after {@link ensureAlarmProfiles}; it cannot
+ * be deleted. Switching active applies that profile's blob for arm decisions.
+ */
+import type { NcAlarmSettings } from '../capabilities/notification-rules.cap.js';
+/** Stable id of the always-present Default profile (migrated from flat settings). */
+export declare const NC_ALARM_DEFAULT_PROFILE_ID = "default";
+export declare const NC_ALARM_DEFAULT_PROFILE_NAME = "Default";
+/** Stock delays — same numbers the panel shipped with before any editor existed. */
+export declare const NC_ALARM_SYSTEM_DEFAULT_DELAYS: {
+    readonly exitDelaySec: 30;
+    readonly entryDelaySec: 20;
+    readonly triggeredDurationSec: 0;
+};
+/** Empty memberships + stock delays + no announce targets. */
+export declare function ncAlarmSystemDefaultSettings(): NcAlarmSettings;
+export interface NcAlarmProfileRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly settings: NcAlarmSettings;
+}
+export interface NcAlarmProfilesState {
+    readonly activeId: string;
+    readonly profiles: readonly NcAlarmProfileRecord[];
+}
+export type NcAlarmProfileCreateSource = {
+    readonly kind: 'defaults';
+} | {
+    readonly kind: 'clone';
+    readonly fromId: string;
+};
+export type NcAlarmProfilesMutationResult = {
+    readonly kind: 'ok';
+    readonly state: NcAlarmProfilesState;
+} | {
+    readonly kind: 'refused';
+    readonly reason: NcAlarmProfilesRefuseReason;
+    readonly detail?: string;
+};
+export type NcAlarmProfilesRefuseReason = 'not-found' | 'name-empty' | 'name-taken' | 'cannot-delete-default' | 'cannot-rename-default-id' | 'clone-source-missing';
+export declare function isDefaultAlarmProfileId(id: string): boolean;
+/** Deep-enough copy of a settings blob (arrays replaced, never mutated). */
+export declare function cloneAlarmSettings(settings: NcAlarmSettings): NcAlarmSettings;
+/**
+ * Seed Default from the panel's current flat settings when no profiles exist yet
+ * (first boot after this feature, or a wiped profiles key).
+ */
+export declare function ensureAlarmProfiles(state: NcAlarmProfilesState | null | undefined, currentSettings: NcAlarmSettings): NcAlarmProfilesState;
+export declare function createAlarmProfile(state: NcAlarmProfilesState, input: {
+    readonly name: string;
+    readonly id: string;
+    readonly source: NcAlarmProfileCreateSource;
+}): NcAlarmProfilesMutationResult;
+export declare function renameAlarmProfile(state: NcAlarmProfilesState, input: {
+    readonly id: string;
+    readonly name: string;
+}): NcAlarmProfilesMutationResult;
+export declare function deleteAlarmProfile(state: NcAlarmProfilesState, id: string): NcAlarmProfilesMutationResult;
+export declare function activateAlarmProfile(state: NcAlarmProfilesState, id: string): NcAlarmProfilesMutationResult;
+/** Persist the live flat settings into the active profile's blob. */
+export declare function syncActiveAlarmProfileSettings(state: NcAlarmProfilesState, settings: NcAlarmSettings): NcAlarmProfilesState;
+export declare function alarmProfileById(state: NcAlarmProfilesState, id: string): NcAlarmProfileRecord | undefined;

package/package.json

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