@camstack/types 1.2.296 → 1.2.298

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.296",
+  "version": "1.2.298",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",