@camstack/addon-provider-hikvision 1.2.89 → 1.2.91

package/dist/addon.js

@@ -12339,6 +12339,9 @@ var QueryFilterSchema = object({
 	whereBetween: record(string(), tuple([unknown(), unknown()])).optional(),
 	/** NULL-safe exclusion: matches rows whose field is NULL OR != the value. */
 	whereNot: record(string(), unknown()).optional(),
+	/** NULL-safe exclusion of a SET — `whereNot` for more than one value. An
+	*  empty list excludes nothing. See `QueryFilter.whereNotIn`. */
+	whereNotIn: record(string(), array(unknown())).optional(),
 	orderBy: object({
 		field: string(),
 		direction: _enum(["asc", "desc"])
@@ -12359,7 +12362,8 @@ var MutationFilterSchema = object({
 	where: record(string(), unknown()).optional(),
 	whereIn: record(string(), array(unknown())).optional(),
 	whereBetween: record(string(), tuple([unknown(), unknown()])).optional(),
-	whereNot: record(string(), unknown()).optional()
+	whereNot: record(string(), unknown()).optional(),
+	whereNotIn: record(string(), array(unknown())).optional()
 });
 /**
 * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -19134,10 +19138,12 @@ var TrackSourceSchema = _enum([
 *    Terminal for the plain `markForTrain` toggle: returning it to `staging` is
 *    a deliberate action of the retrain page, not a side effect of a checkbox.
 *
-* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` because
-* the store's filter language has only positive equality and `whereIn` — no
-* negation, no IS NULL — so a NULL would be unselectable by ANY predicate and
-* would make the entire pre-column history immortal in one deploy.
+* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` so that
+* every row is selectable by a positive predicate. (The filter language has
+* since grown the NULL-safe `whereNot` / `whereNotIn` and an `IS NULL` reading
+* of `where: { f: null }`, which is how {@link TrackSourceSchema} can be
+* filtered on a NULLABLE column — see `excludeSources`. It did not when this
+* column was designed, and a NOT NULL column is still the better shape.)
 */
 var RetrainStatusSchema = _enum([
 	"none",
@@ -19873,7 +19879,9 @@ var RecentTracksQueryInput = object({
 	* whose class list is unreadable are kept, and the client's rule stays the
 	* exact one.
 	*/
-	classes: array(string()).optional()
+	classes: array(string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: array(TrackSourceSchema).optional()
 });
 /**
 * A Summary (D359): the per-camera session envelope that references tracks.
@@ -20301,7 +20309,9 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	* selected is an operator who has not narrowed anything, and an empty
 	* timeline would read as a camera that saw nothing.
 	*/
-	classes: array(string()).optional()
+	classes: array(string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: array(TrackSourceSchema).optional()
 }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
@@ -29641,8 +29651,27 @@ var PrivacyMaskRegionSchema = object({
 /** Current on-camera privacy state — mask master enable + zones + microphone. */
 var PrivacyMaskStatusSchema = object({
 	enabled: boolean(),
-	/** Active zones (normalized 0..1). Length ≤ maxRegions. */
-	regions: array(PrivacyMaskRegionSchema),
+	/**
+	* Active zones (normalized 0..1). Length ≤ maxRegions.
+	*
+	* `null` means "no answer" — the provider has never reached this camera
+	* (a cold `runtimeState` slice, a battery camera asleep) or the read
+	* failed. A consumer must render it as UNKNOWN and never as "this camera
+	* has no zones": those two look identical to an operator right up to the
+	* moment one of them is acted on, and acting on them differs completely.
+	* The switch group turned an unanswered read into *"nothing is set up for
+	* it to act on"* — an instruction to go and draw a zone that already
+	* exists — and this editor seeded an EMPTY canvas from it, one Save away
+	* from deleting the mask it could not read.
+	*
+	* Empty-and-answered is `[]` and stays a real answer: this camera genuinely
+	* has no zones. The distinction is the same one {@link
+	* PrivacyMaskStatusSchema.shape.audioEnabled} already draws for the
+	* microphone, on the very same payload — both planes come from ONE refresh,
+	* so it was never coherent for one of them to be able to say "unknown"
+	* while the other could not.
+	*/
+	regions: array(PrivacyMaskRegionSchema).nullable(),
 	/**
 	* Is the camera capturing sound right now? Read from the camera, never from
 	* a server-side mirror.
@@ -50071,7 +50100,7 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 			logger: this.ctx.logger,
 			empty: () => ({
 				enabled: false,
-				regions: [],
+				regions: null,
 				audioEnabled: null,
 				lastFetchedAt: 0
 			})

package/dist/addon.mjs

@@ -12340,6 +12340,9 @@ var QueryFilterSchema = object({
 	whereBetween: record(string(), tuple([unknown(), unknown()])).optional(),
 	/** NULL-safe exclusion: matches rows whose field is NULL OR != the value. */
 	whereNot: record(string(), unknown()).optional(),
+	/** NULL-safe exclusion of a SET — `whereNot` for more than one value. An
+	*  empty list excludes nothing. See `QueryFilter.whereNotIn`. */
+	whereNotIn: record(string(), array(unknown())).optional(),
 	orderBy: object({
 		field: string(),
 		direction: _enum(["asc", "desc"])
@@ -12360,7 +12363,8 @@ var MutationFilterSchema = object({
 	where: record(string(), unknown()).optional(),
 	whereIn: record(string(), array(unknown())).optional(),
 	whereBetween: record(string(), tuple([unknown(), unknown()])).optional(),
-	whereNot: record(string(), unknown()).optional()
+	whereNot: record(string(), unknown()).optional(),
+	whereNotIn: record(string(), array(unknown())).optional()
 });
 /**
 * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -19135,10 +19139,12 @@ var TrackSourceSchema = _enum([
 *    Terminal for the plain `markForTrain` toggle: returning it to `staging` is
 *    a deliberate action of the retrain page, not a side effect of a checkbox.
 *
-* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` because
-* the store's filter language has only positive equality and `whereIn` — no
-* negation, no IS NULL — so a NULL would be unselectable by ANY predicate and
-* would make the entire pre-column history immortal in one deploy.
+* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` so that
+* every row is selectable by a positive predicate. (The filter language has
+* since grown the NULL-safe `whereNot` / `whereNotIn` and an `IS NULL` reading
+* of `where: { f: null }`, which is how {@link TrackSourceSchema} can be
+* filtered on a NULLABLE column — see `excludeSources`. It did not when this
+* column was designed, and a NOT NULL column is still the better shape.)
 */
 var RetrainStatusSchema = _enum([
 	"none",
@@ -19874,7 +19880,9 @@ var RecentTracksQueryInput = object({
 	* whose class list is unreadable are kept, and the client's rule stays the
 	* exact one.
 	*/
-	classes: array(string()).optional()
+	classes: array(string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: array(TrackSourceSchema).optional()
 });
 /**
 * A Summary (D359): the per-camera session envelope that references tracks.
@@ -20302,7 +20310,9 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	* selected is an operator who has not narrowed anything, and an empty
 	* timeline would read as a camera that saw nothing.
 	*/
-	classes: array(string()).optional()
+	classes: array(string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: array(TrackSourceSchema).optional()
 }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
@@ -29642,8 +29652,27 @@ var PrivacyMaskRegionSchema = object({
 /** Current on-camera privacy state — mask master enable + zones + microphone. */
 var PrivacyMaskStatusSchema = object({
 	enabled: boolean(),
-	/** Active zones (normalized 0..1). Length ≤ maxRegions. */
-	regions: array(PrivacyMaskRegionSchema),
+	/**
+	* Active zones (normalized 0..1). Length ≤ maxRegions.
+	*
+	* `null` means "no answer" — the provider has never reached this camera
+	* (a cold `runtimeState` slice, a battery camera asleep) or the read
+	* failed. A consumer must render it as UNKNOWN and never as "this camera
+	* has no zones": those two look identical to an operator right up to the
+	* moment one of them is acted on, and acting on them differs completely.
+	* The switch group turned an unanswered read into *"nothing is set up for
+	* it to act on"* — an instruction to go and draw a zone that already
+	* exists — and this editor seeded an EMPTY canvas from it, one Save away
+	* from deleting the mask it could not read.
+	*
+	* Empty-and-answered is `[]` and stays a real answer: this camera genuinely
+	* has no zones. The distinction is the same one {@link
+	* PrivacyMaskStatusSchema.shape.audioEnabled} already draws for the
+	* microphone, on the very same payload — both planes come from ONE refresh,
+	* so it was never coherent for one of them to be able to say "unknown"
+	* while the other could not.
+	*/
+	regions: array(PrivacyMaskRegionSchema).nullable(),
 	/**
 	* Is the camera capturing sound right now? Read from the camera, never from
 	* a server-side mirror.
@@ -50072,7 +50101,7 @@ var HikvisionCamera = class HikvisionCamera extends BaseDevice {
 			logger: this.ctx.logger,
 			empty: () => ({
 				enabled: false,
-				regions: [],
+				regions: null,
 				audioEnabled: null,
 				lastFetchedAt: 0
 			})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-hikvision",
-  "version": "1.2.89",
+  "version": "1.2.91",
   "description": "Hikvision camera device provider addon for CamStack — ISAPI over HTTP(S) with digest auth (snapshot, alarm stream, RTSP discovery)",
   "keywords": [
     "camstack",