@camstack/types 1.2.387 → 1.2.388

package/dist/interfaces/logging.d.ts

@@ -1,3 +1,4 @@
+import type { LogReadCapabilities, LogReadQuery, LogReadResult } from '../capabilities/log-destination.cap.js';
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 /**
  * Severity ordering. Declared once here because it had already been re-declared
@@ -75,6 +76,13 @@ export interface LogTags {
     readonly [key: string]: string | number | undefined;
 }
 export interface LogEntry {
+    /**
+     * `<bootId>.<seq>`, minted by the LogManager that FIRST accepted the line
+     * on this process (D898). Identical in the in-memory tail, the live
+     * subscription and the rotated file, so a page read from disk and a line
+     * pushed live dedupe exactly. Absent only on an entry built by hand.
+     */
+    id?: string;
     timestamp: Date;
     level: LogLevel;
     /** Single free-form label (e.g. 'EventPersistence', 'rtsp', 'AddonRegistry').
@@ -98,7 +106,14 @@ export interface ILogDestination {
     initialize(): Promise<void>;
     shutdown(): Promise<void>;
     write(entry: LogEntry): void;
-    query?(filter: LogFilter): Promise<readonly LogEntry[]>;
+    /** Absent ⇒ this destination only ships lines (D898). */
+    describeRead?(): Promise<LogReadCapabilities>;
+    read?(query: LogReadQuery): Promise<LogReadResult>;
+    cancelRead?(input: {
+        readonly requestId: string;
+    }): Promise<{
+        readonly cancelled: boolean;
+    }>;
 }
 /**
  * Inline, per-call extras passed to every `IScopedLogger` method.

package/dist/notification/media-image.d.ts

@@ -0,0 +1,67 @@
+/**
+ * media-image — the ONE media choice of a notification rule (D897).
+ *
+ * A rule used to state its picture as three fields — `attach` (which stored
+ * kind to look for), `frame` (cropped / full / boxed) and `zoneCrop` — and the
+ * ladders those fed picked a STORED kind, so one rule shipped a subject crop on
+ * one event and a boxed scene on the next depending on what had landed. The
+ * picture is now rendered at send time from a clean frame, and the rule says
+ * only what it wants to SEE: `image` (`scene-boxes` | `crop` | `clean` |
+ * `none`) plus `showTriggerZone`.
+ *
+ * This module is the only reader of the legacy triple. The rule store applies
+ * {@link normalizeNcMediaPolicy} on load (a READ projection, like the retired
+ * delivery fields of D692) and on every write, so a stored rule converges on
+ * `image` the first time it is saved, and an editor that still sends the
+ * triple (the viewer, until it follows) is folded on the way in.
+ */
+import type { NcConditions, NcMediaImage, NcMediaPolicy } from '../capabilities/notification-rules.cap.js';
+import { type NcRuleKind, type NcRuleSectionSubject } from './rule-kinds.js';
+/** Every mode, in the order an editor offers them. */
+export declare const NC_MEDIA_IMAGE_MODES: readonly NcMediaImage[];
+/**
+ * The modes a rule of this kind can honour. A kind that carries no media gets
+ * none (its row ships text, or — an alarm — its SOURCE rule's picture); a kind
+ * whose subject has no region of the frame (a sound) is never offered `crop`.
+ */
+export declare function imageModesForKind(kind: NcRuleKind): readonly NcMediaImage[];
+/**
+ * The zone ids that FIRE a rule: its `zones` condition, or an occupancy rule's
+ * own scoped zone. Empty when the trigger is not a zone — and then
+ * `showTriggerZone` has nothing to draw and is refused on save.
+ */
+export declare function ruleTriggerZoneIds(conditions: NcConditions): readonly string[];
+/**
+ * What the legacy triple MEANT, as a mode. `zoneCrop` forced the clean
+ * keyFrame ladder and dropped `frame`, so it is `clean` whatever else was set;
+ * `frame` decided over `attach` when present; `keyFrame` was the clean scene;
+ * every other still (`best`, `best-matching`, the default) was the subject.
+ */
+export declare function legacyImageMode(media: NcMediaPolicy): NcMediaImage;
+/**
+ * The mode a rule's picture is rendered in. `image` when stored; else what the
+ * legacy triple meant — and, for a SENSOR rule written before D897, `clean`
+ * whatever it stored (even `attach: 'none'`), because its stored triple was
+ * ignored and one plain snapshot always shipped (operator ruling, 2026-10-01):
+ * the migration keeps what the rule actually DID. Clamped to what the kind can
+ * honour.
+ */
+export declare function resolveNcMediaImage(media: NcMediaPolicy, kind: NcRuleKind): NcMediaImage;
+/** The rule fields the normalisation reads. */
+export interface NcMediaRuleSubject extends NcRuleSectionSubject {
+    readonly conditions: NcConditions;
+}
+/**
+ * The stored shape of a media policy: `image` set, the legacy triple gone.
+ * `showTriggerZone` survives only where it can be drawn — a zone trigger and a
+ * mode other than `crop`/`none`; a legacy `zoneCrop` on a zone rule becomes it.
+ * Every other field (gif, clip, rolls, speed, profile, linked cameras) is
+ * carried through untouched. Pure; never throws.
+ */
+export declare function normalizeNcMediaPolicy(media: NcMediaPolicy, rule: NcMediaRuleSubject): NcMediaPolicy;
+/**
+ * Why a media policy cannot be SAVED on this rule, or null. Server-side and
+ * editor alike: `showTriggerZone` on a rule whose trigger is not a zone, and a
+ * mode the rule's kind cannot honour.
+ */
+export declare function ncMediaPolicyError(media: NcMediaPolicy, rule: NcMediaRuleSubject): string | null;

package/dist/{sleep-yKL5gfrH.mjs → sleep-BSuCCFjf.mjs}

@@ -5402,7 +5402,9 @@ var HISTORY_UNIT_LABELS = {
 	ms: "ms",
 	s: "s",
 	days: "days",
-	bytes: "bytes"
+	bytes: "bytes",
+	kbps: "kbps",
+	fps: "fps"
 };
 /** Capture floor (ms) applied to `gauge` / `counter` series when a field states none. */
 var HISTORY_DEFAULT_MIN_INTERVAL_MS = 1e4;

package/dist/{sleep-6sOPE0EV.js → sleep-DKtoyk6X.js}

@@ -5402,7 +5402,9 @@ var HISTORY_UNIT_LABELS = {
 	ms: "ms",
 	s: "s",
 	days: "days",
-	bytes: "bytes"
+	bytes: "bytes",
+	kbps: "kbps",
+	fps: "fps"
 };
 /** Capture floor (ms) applied to `gauge` / `counter` series when a field states none. */
 var HISTORY_DEFAULT_MIN_INTERVAL_MS = 1e4;

package/package.json

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