@camstack/addon-post-analysis 1.2.84 → 1.2.86

package/dist/{dist-C_mhxTWT.js → dist-Crk9pYee.js}

@@ -29,7 +29,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-//#region ../types/dist/event-category-Bxo5yJjt.mjs
+//#region ../types/dist/event-category-C0lyLd5U.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -46,9 +46,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemRestartCompleted"] = "system.restart-completed";
 	/**
 	* A newer addon or server-root package version was found by the
-	* authoritative registry check. Emitted once per
-	* `(target, packageName, currentVersion, latestVersion)` transition; repeated
-	* polling of the same result is deduplicated by the checker.
+	* authoritative registry check. Emitted once when any observed
+	* `latestVersion` changes (or a package/node first appears behind);
+	* the payload carries the full currently-available list. Repeated
+	* polling of the same latests is silent.
 	*/
 	EventCategory["UpdateAvailable"] = "update.available";
 	/**
@@ -7791,6 +7792,23 @@ var RecordingBandSchema = object({
 	postBufferSec: number().min(0).optional()
 });
 /**
+* Adjacent recorded ranges closer than this belong to the SAME videoclip visit.
+*
+* This is NOT the recorder calendar merge (`RANGE_MERGE_GAP_MS = 5s`). That
+* threshold is for the timeline bar, which must show exact holes — including
+* the ~8s GOP/keyframe rolls measured on events-mode cameras (dispensa 1438,
+* 2026-08-16). A videoclip is the events-mode keep-window (writer session),
+* whose idle bound is `postBufferSec`. Using that default (30s) glues those
+* intra-visit holes without joining visits hours apart.
+*
+* Segments stay the source of truth on disk (`startMs-durMs-bytes.m4s`); a
+* visit is derived, not a second copy of the files.
+*/
+var VISIT_MERGE_GAP_MS = {
+	preBufferSec: 10,
+	postBufferSec: 30
+}.postBufferSec * 1e3;
+/**
 * Per-device retention overrides. Every field is optional; an unset or `0`
 * value inherits the node-wide recorder default. Only footage-lifetime limits
 * live per-camera: `maxAgeDays` and `maxSizeGb`. The disk-occupancy threshold
@@ -14824,6 +14842,9 @@ var NcSystemEventKindSchema = _enum([
 	"alarm-disarmed",
 	"alarm-arming",
 	"alarm-arm-refused",
+	"addon-updated",
+	"server-updated",
+	"export-completed",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -15947,6 +15968,18 @@ var NC_CONDITION_CATALOG = [
 				value: "server-update-available",
 				label: "Server update available"
 			},
+			{
+				value: "addon-updated",
+				label: "Addons updated"
+			},
+			{
+				value: "server-updated",
+				label: "Server updated"
+			},
+			{
+				value: "export-completed",
+				label: "Export completed"
+			},
 			{
 				value: "alarm-arming",
 				label: "Alarm arming (exit delay)"
@@ -17283,13 +17316,19 @@ var RetrainStatusSchema = _enum([
 * "never marked" from "already trained" must read `retrainStatus`.
 *
 * `debug` does NOT pin; it is attention, not durability.
+*
+* `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
+* A favourited track is skipped by retention the same way `staging` is, but
+* it does not enter `none|staging|trained` and has no staging budget.
 */
 var TrackFlagFields = {
 	/** Operator marked this track as training material — i.e. `retrainStatus` is
 	*  `'staging'`. */
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
-	debug: boolean().optional()
+	debug: boolean().optional(),
+	/** Operator favourited this track. Pins it against pruning. */
+	favourited: boolean().optional()
 };
 /**
 * The lifecycle field itself, on the READ surfaces only (`Track`, `KeyEvent`).
@@ -17314,6 +17353,7 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,
 	*  which always knows it — and a surface that has just written needs to render
@@ -18249,7 +18289,7 @@ var pipelineAnalyticsCapability = {
 			auth: "admin"
 		}),
 		/**
-		* Set the per-track operator flags (`markForTrain`, `debug`) on ONE track.
+		* Set the per-track operator flags (`markForTrain`, `debug`, `favourited`) on ONE track.
 		* The patch is PARTIAL — an omitted key is left untouched — because the
 		* three surfaces that write it (admin Events grid, viewer track detail,
 		* viewer cluster detail) each own one toggle and must not clobber the other.
@@ -21429,8 +21469,28 @@ var ClipSchema = object({
 		startMs: number(),
 		endMs: number()
 	}),
-	/** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
-	thumbnail: string().optional()
+	/**
+	* Lazy thumbnail URL, never inlined.
+	*
+	* Recording-derived clips (events-mode keep-window, and the prepared
+	* continuous event+fragment visit) MUST use the snapshot of the **main
+	* event of the interval** — `getEventMedia({ eventId, kind: 'snapshot' })`
+	* of the event that owns `kind` (object > motion > audio). Do not extract
+	* a keyframe from the recorded segments. Other providers (onboard, HKSV)
+	* mint their own stills.
+	*/
+	thumbnail: string().optional(),
+	/** Analytics event ids that overlap this visit. Empty on footage-only clips.
+	*  The default provider's visit grain puts many motion heartbeats on one clip
+	*  instead of minting one clip per marker. */
+	eventIds: array(string()).optional(),
+	/** Intra-visit footage holes (GOP rolls, discarded segments) still shorter
+	*  than `VISIT_MERGE_GAP_MS`. Playback concatenates around them; the timeline
+	*  bar keeps showing them via `recording.getAvailability`. */
+	holes: array(object({
+		startMs: number(),
+		endMs: number()
+	})).optional()
 });
 var ClipPlaybackSchema = object({
 	/** HLS master URL through the hub data-plane (Range + token in path). */
@@ -27790,7 +27850,9 @@ var ExportOptionsSchema = object({
 	includeAudio: boolean(),
 	maxLifeMs: number().int().positive(),
 	deleteAfterDownload: boolean(),
-	title: string().max(200).optional()
+	title: string().max(200).optional(),
+	/** Notification-output target ids to ping when this export becomes ready. */
+	notifyTargetIds: array(string().min(1)).max(20).optional()
 }).superRefine((v, ctx) => {
 	if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
 		code: ZodIssueCode.custom,
@@ -27868,10 +27930,18 @@ var ExportBytesSchema = object({
 });
 method(object({
 	deviceId: number(),
-	profile: string(),
+	/** @deprecated Prefer `profiles`. Kept so timelapse/notifiers keep working. */
+	profile: string().optional(),
+	profiles: array(string()).min(1).optional(),
 	fromMs: number(),
 	toMs: number(),
 	options: ExportOptionsSchema
+}).superRefine((v, ctx) => {
+	if ((v.profiles !== void 0 && v.profiles.length > 0 ? v.profiles : v.profile !== void 0 ? [v.profile] : []).length < 1) ctx.addIssue({
+		code: ZodIssueCode.custom,
+		message: "pass profiles[] (min 1) or legacy profile",
+		path: ["profiles"]
+	});
 }), ExportRecordSchema, {
 	kind: "mutation",
 	auth: "protected"
@@ -39127,6 +39197,12 @@ Object.defineProperty(exports, "TrackSourceSchema", {
 		return TrackSourceSchema;
 	}
 });
+Object.defineProperty(exports, "VISIT_MERGE_GAP_MS", {
+	enumerable: true,
+	get: function() {
+		return VISIT_MERGE_GAP_MS;
+	}
+});
 Object.defineProperty(exports, "__exportAll", {
 	enumerable: true,
 	get: function() {

package/dist/{dist-CJWHkPz8.mjs → dist-CzdBsvoR.mjs}

@@ -1,4 +1,4 @@
-//#region ../types/dist/event-category-Bxo5yJjt.mjs
+//#region ../types/dist/event-category-C0lyLd5U.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -15,9 +15,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemRestartCompleted"] = "system.restart-completed";
 	/**
 	* A newer addon or server-root package version was found by the
-	* authoritative registry check. Emitted once per
-	* `(target, packageName, currentVersion, latestVersion)` transition; repeated
-	* polling of the same result is deduplicated by the checker.
+	* authoritative registry check. Emitted once when any observed
+	* `latestVersion` changes (or a package/node first appears behind);
+	* the payload carries the full currently-available list. Repeated
+	* polling of the same latests is silent.
 	*/
 	EventCategory["UpdateAvailable"] = "update.available";
 	/**
@@ -7760,6 +7761,23 @@ var RecordingBandSchema = object({
 	postBufferSec: number().min(0).optional()
 });
 /**
+* Adjacent recorded ranges closer than this belong to the SAME videoclip visit.
+*
+* This is NOT the recorder calendar merge (`RANGE_MERGE_GAP_MS = 5s`). That
+* threshold is for the timeline bar, which must show exact holes — including
+* the ~8s GOP/keyframe rolls measured on events-mode cameras (dispensa 1438,
+* 2026-08-16). A videoclip is the events-mode keep-window (writer session),
+* whose idle bound is `postBufferSec`. Using that default (30s) glues those
+* intra-visit holes without joining visits hours apart.
+*
+* Segments stay the source of truth on disk (`startMs-durMs-bytes.m4s`); a
+* visit is derived, not a second copy of the files.
+*/
+var VISIT_MERGE_GAP_MS = {
+	preBufferSec: 10,
+	postBufferSec: 30
+}.postBufferSec * 1e3;
+/**
 * Per-device retention overrides. Every field is optional; an unset or `0`
 * value inherits the node-wide recorder default. Only footage-lifetime limits
 * live per-camera: `maxAgeDays` and `maxSizeGb`. The disk-occupancy threshold
@@ -14793,6 +14811,9 @@ var NcSystemEventKindSchema = _enum([
 	"alarm-disarmed",
 	"alarm-arming",
 	"alarm-arm-refused",
+	"addon-updated",
+	"server-updated",
+	"export-completed",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -15916,6 +15937,18 @@ var NC_CONDITION_CATALOG = [
 				value: "server-update-available",
 				label: "Server update available"
 			},
+			{
+				value: "addon-updated",
+				label: "Addons updated"
+			},
+			{
+				value: "server-updated",
+				label: "Server updated"
+			},
+			{
+				value: "export-completed",
+				label: "Export completed"
+			},
 			{
 				value: "alarm-arming",
 				label: "Alarm arming (exit delay)"
@@ -17252,13 +17285,19 @@ var RetrainStatusSchema = _enum([
 * "never marked" from "already trained" must read `retrainStatus`.
 *
 * `debug` does NOT pin; it is attention, not durability.
+*
+* `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
+* A favourited track is skipped by retention the same way `staging` is, but
+* it does not enter `none|staging|trained` and has no staging budget.
 */
 var TrackFlagFields = {
 	/** Operator marked this track as training material — i.e. `retrainStatus` is
 	*  `'staging'`. */
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
-	debug: boolean().optional()
+	debug: boolean().optional(),
+	/** Operator favourited this track. Pins it against pruning. */
+	favourited: boolean().optional()
 };
 /**
 * The lifecycle field itself, on the READ surfaces only (`Track`, `KeyEvent`).
@@ -17283,6 +17322,7 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,
 	*  which always knows it — and a surface that has just written needs to render
@@ -18218,7 +18258,7 @@ var pipelineAnalyticsCapability = {
 			auth: "admin"
 		}),
 		/**
-		* Set the per-track operator flags (`markForTrain`, `debug`) on ONE track.
+		* Set the per-track operator flags (`markForTrain`, `debug`, `favourited`) on ONE track.
 		* The patch is PARTIAL — an omitted key is left untouched — because the
 		* three surfaces that write it (admin Events grid, viewer track detail,
 		* viewer cluster detail) each own one toggle and must not clobber the other.
@@ -21398,8 +21438,28 @@ var ClipSchema = object({
 		startMs: number(),
 		endMs: number()
 	}),
-	/** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
-	thumbnail: string().optional()
+	/**
+	* Lazy thumbnail URL, never inlined.
+	*
+	* Recording-derived clips (events-mode keep-window, and the prepared
+	* continuous event+fragment visit) MUST use the snapshot of the **main
+	* event of the interval** — `getEventMedia({ eventId, kind: 'snapshot' })`
+	* of the event that owns `kind` (object > motion > audio). Do not extract
+	* a keyframe from the recorded segments. Other providers (onboard, HKSV)
+	* mint their own stills.
+	*/
+	thumbnail: string().optional(),
+	/** Analytics event ids that overlap this visit. Empty on footage-only clips.
+	*  The default provider's visit grain puts many motion heartbeats on one clip
+	*  instead of minting one clip per marker. */
+	eventIds: array(string()).optional(),
+	/** Intra-visit footage holes (GOP rolls, discarded segments) still shorter
+	*  than `VISIT_MERGE_GAP_MS`. Playback concatenates around them; the timeline
+	*  bar keeps showing them via `recording.getAvailability`. */
+	holes: array(object({
+		startMs: number(),
+		endMs: number()
+	})).optional()
 });
 var ClipPlaybackSchema = object({
 	/** HLS master URL through the hub data-plane (Range + token in path). */
@@ -27759,7 +27819,9 @@ var ExportOptionsSchema = object({
 	includeAudio: boolean(),
 	maxLifeMs: number().int().positive(),
 	deleteAfterDownload: boolean(),
-	title: string().max(200).optional()
+	title: string().max(200).optional(),
+	/** Notification-output target ids to ping when this export becomes ready. */
+	notifyTargetIds: array(string().min(1)).max(20).optional()
 }).superRefine((v, ctx) => {
 	if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
 		code: ZodIssueCode.custom,
@@ -27837,10 +27899,18 @@ var ExportBytesSchema = object({
 });
 method(object({
 	deviceId: number(),
-	profile: string(),
+	/** @deprecated Prefer `profiles`. Kept so timelapse/notifiers keep working. */
+	profile: string().optional(),
+	profiles: array(string()).min(1).optional(),
 	fromMs: number(),
 	toMs: number(),
 	options: ExportOptionsSchema
+}).superRefine((v, ctx) => {
+	if ((v.profiles !== void 0 && v.profiles.length > 0 ? v.profiles : v.profile !== void 0 ? [v.profile] : []).length < 1) ctx.addIssue({
+		code: ZodIssueCode.custom,
+		message: "pass profiles[] (min 1) or legacy profile",
+		path: ["profiles"]
+	});
 }), ExportRecordSchema, {
 	kind: "mutation",
 	auth: "protected"
@@ -38844,4 +38914,4 @@ function vectorDimFromBase64(encoded) {
 	return Math.floor(Buffer.from(encoded, "base64").byteLength / 4);
 }
 //#endregion
-export { hfModelUrl as $, SCENE_CONFIRM_DEFAULT_TIMEOUT_MS as A, string as At, addonWidgetsSourceCapability as B, NcSnoozeSchema as C, boolean as Ct, OpsLogEntrySchema as D, object as Dt, NcTaxonomySchema as E, number as Et, TIMELAPSE_DENSE_FLOOR_SEC as F, buildEventKindDescriptor as G, assertTimelapseCadences as H, TimelapseRuleInputSchema as I, defineCustomActions as J, cosineSimilarity as K, TimelapseRulePatchSchema as L, SCENE_DEFAULT_UNCOVERED_POLICY as M, EventCategory as Mt, SCENE_DIVERGED as N, RECORDING_EXPORT_MAX_READ_BYTES as O, partialRecord as Ot, SceneMonitorSchema as P, faceGalleryCapability as Q, TimelapseRuleSchema as R, NcSnoozeInputSchema as S, array as St, NcSystemEventKindSchema as T, literal as Tt, audioMetricsCapability as U, alarmPanelCapability as V, audioModeOf as W, embeddingEncoderCapability as X, deriveRecordingMode as Y, encodeVectorBase64 as Z, NcRuleInputSchema as _, hydrateSchema as _t, DETECTION_PIPELINE_CAP_NAME as a, plateGalleryCapability as at, NcRuleTargetSchema as b, sleep as bt, EVENT_PAD_MS as c, sceneMonitorCapability as ct, NC_ALARM_SYSTEM_EVENT_KINDS as d, videoclipsCapability as dt, isDetectionMacroClass as et, NC_CONDITION_CATALOG as f, zoneAnalyticsCapability as ft, NcConditionDescriptorSchema as g, createEvent as gt, NC_TAXONOMY as h, DeviceType as ht, DETECTION_MACRO_CLASSES as i, pipelineAnalyticsCapability as it, SCENE_DEFAULT_ANCHOR_THRESHOLD as j, unknown as jt, RetrainStatusSchema as k, record as kt, LabelAttributionSchema as l, subKindsOf as lt, NC_SNOOZE_MAX_MINUTES as m, BaseAddon as mt, DEFAULT_EVENT_COLOR as n, kebabToCamel as nt, DeclaredDevices as o, readDeviceStateFrom as ot, NC_DEFAULT_SNOOZE_MINUTES as p, errMsg as pt, customAction as q, DEFAULT_TIMELAPSE_PREVIEW_TEXT as r, notificationRulesCapability as rt, EVENT_KIND_BY_CAP as s, readTimelapseGeneratedAt as st, BaseDevice as t, isScheduleActive as tt, MACRO_LABELS as u, vectorDimFromBase64 as ut, NcRulePatchSchema as v, isDeviceScopedCap as vt, NcSnoozeSuppressedSchema as w, discriminatedUnion as wt, NcScheduleSchema as x, _enum as xt, NcRuleSchema as y, nodePin as yt, TrackSourceSchema as z };
+export { faceGalleryCapability as $, SCENE_CONFIRM_DEFAULT_TIMEOUT_MS as A, record as At, VISIT_MERGE_GAP_MS as B, NcSnoozeSchema as C, array as Ct, OpsLogEntrySchema as D, number as Dt, NcTaxonomySchema as E, literal as Et, TIMELAPSE_DENSE_FLOOR_SEC as F, audioModeOf as G, alarmPanelCapability as H, TimelapseRuleInputSchema as I, customAction as J, buildEventKindDescriptor as K, TimelapseRulePatchSchema as L, SCENE_DEFAULT_UNCOVERED_POLICY as M, unknown as Mt, SCENE_DIVERGED as N, EventCategory as Nt, RECORDING_EXPORT_MAX_READ_BYTES as O, object as Ot, SceneMonitorSchema as P, encodeVectorBase64 as Q, TimelapseRuleSchema as R, NcSnoozeInputSchema as S, _enum as St, NcSystemEventKindSchema as T, discriminatedUnion as Tt, assertTimelapseCadences as U, addonWidgetsSourceCapability as V, audioMetricsCapability as W, deriveRecordingMode as X, defineCustomActions as Y, embeddingEncoderCapability as Z, NcRuleInputSchema as _, createEvent as _t, DETECTION_PIPELINE_CAP_NAME as a, pipelineAnalyticsCapability as at, NcRuleTargetSchema as b, nodePin as bt, EVENT_PAD_MS as c, readTimelapseGeneratedAt as ct, NC_ALARM_SYSTEM_EVENT_KINDS as d, vectorDimFromBase64 as dt, hfModelUrl as et, NC_CONDITION_CATALOG as f, videoclipsCapability as ft, NcConditionDescriptorSchema as g, DeviceType as gt, NC_TAXONOMY as h, BaseAddon as ht, DETECTION_MACRO_CLASSES as i, notificationRulesCapability as it, SCENE_DEFAULT_ANCHOR_THRESHOLD as j, string as jt, RetrainStatusSchema as k, partialRecord as kt, LabelAttributionSchema as l, sceneMonitorCapability as lt, NC_SNOOZE_MAX_MINUTES as m, errMsg as mt, DEFAULT_EVENT_COLOR as n, isScheduleActive as nt, DeclaredDevices as o, plateGalleryCapability as ot, NC_DEFAULT_SNOOZE_MINUTES as p, zoneAnalyticsCapability as pt, cosineSimilarity as q, DEFAULT_TIMELAPSE_PREVIEW_TEXT as r, kebabToCamel as rt, EVENT_KIND_BY_CAP as s, readDeviceStateFrom as st, BaseDevice as t, isDetectionMacroClass as tt, MACRO_LABELS as u, subKindsOf as ut, NcRulePatchSchema as v, hydrateSchema as vt, NcSnoozeSuppressedSchema as w, boolean as wt, NcScheduleSchema as x, sleep as xt, NcRuleSchema as y, isDeviceScopedCap as yt, TrackSourceSchema as z };

package/dist/embedding-encoder/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-C_mhxTWT.js");
+const require_dist = require("../dist-Crk9pYee.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_dist.__toESM(node_fs, 1);
 node_fs = require_dist.__toESM(node_fs);

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { $ as hfModelUrl, X as embeddingEncoderCapability, mt as BaseAddon } from "../dist-CJWHkPz8.mjs";
+import { Z as embeddingEncoderCapability, et as hfModelUrl, ht as BaseAddon } from "../dist-CzdBsvoR.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import "node:fs";

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-ZD03Wv9i.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-GLqrUCoW.mjs}

@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.82",
+		version: "1.2.83",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-BhW_ys0C.mjs → hostInit-DtD0Fd_e.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.82",
+				version: "1.2.83",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,