@camstack/types 1.2.164 → 1.2.165

package/dist/capabilities/data-store-provider.cap.d.ts

@@ -93,6 +93,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -150,6 +151,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             deleted: z.ZodNumber;
@@ -163,6 +165,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>, z.ZodObject<{
@@ -177,6 +180,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -208,6 +212,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -234,6 +239,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -247,6 +247,44 @@ export declare const TrackSourceSchema: z.ZodEnum<{
     pipeline: "pipeline";
 }>;
 export type TrackSource = z.infer<typeof TrackSourceSchema>;
+/**
+ * The `excludeSources` filter on `listTracks` / `listRecentTracks`: track
+ * SOURCES to leave out. ABSENT or EMPTY excludes nothing.
+ *
+ * ## Why the query needs a source dimension at all
+ *
+ * `classes` cannot express it, and trying made a filter that lies. A synthetic
+ * row carries no accumulated `classes[]`, and `whereJsonArrayAny` is a
+ * deliberate SUPERSET — an unreadable column keeps its row. So on the live hub
+ * every class selection returned every synthetic row: `classes: ['person']`
+ * came back with 66 contact markers and 29 audio markers attached, and a class
+ * that exists nowhere at all still answered 116 rows, all of them synthetic.
+ * "Sensor" and "Audio" selected the identical set, because neither selected
+ * anything — they merely failed to exclude the rows the escape hatch keeps.
+ *
+ * Provenance is `source`, never a class name (D189 put every audio row on
+ * `className: 'audio'` precisely so the audio VOCABULARY could stop colliding
+ * with the detection one). This is the filter that speaks it.
+ *
+ * ## Why EXCLUDE and not an allow-list
+ *
+ * A stored client preference outlives this enum. An allow-list persisted by a
+ * viewer that has never heard of a source added next year would hide it
+ * forever, silently — the same shape as the `!== 'sensor'` check this file
+ * already warns about. An exclusion list can only ever hide what it names.
+ *
+ * ## NULL is `pipeline`
+ *
+ * Pipeline rows carry no `source` at all (the column is nullable and the
+ * completed-track persist omits it), so the provider compiles this as a
+ * NULL-safe `whereNotIn` when `pipeline` is NOT excluded, and as a positive
+ * `whereIn` over the surviving sources when it is. Both are exact; neither
+ * leaves a row's fate to a default.
+ *
+ * It is a REAL query filter, not a post-read drop: paging must tell the truth
+ * about how much is left.
+ */
+export type ExcludeSourcesDoc = readonly TrackSource[];
 /**
  * Where a track sits in the RETRAIN lifecycle (D81).
  *
@@ -261,10 +299,12 @@ export type TrackSource = z.infer<typeof TrackSourceSchema>;
  *    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.)
  */
 export declare const RetrainStatusSchema: z.ZodEnum<{
     none: "none";
@@ -1121,6 +1161,11 @@ declare const RecentTracksQueryInput: z.ZodObject<{
     }>>;
     includeStationary: z.ZodOptional<z.ZodBoolean>;
     classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sensor: "sensor";
+        audio: "audio";
+        pipeline: "pipeline";
+    }>>>;
 }, z.core.$strip>;
 export type RecentTracksQuery = z.infer<typeof RecentTracksQueryInput>;
 /**
@@ -1854,6 +1899,11 @@ export declare const pipelineAnalyticsCapability: {
             }>>;
             includeStationary: z.ZodOptional<z.ZodBoolean>;
             classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                sensor: "sensor";
+                audio: "audio";
+                pipeline: "pipeline";
+            }>>>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             retrainStatus: z.ZodOptional<z.ZodEnum<{
                 none: "none";
@@ -1972,6 +2022,11 @@ export declare const pipelineAnalyticsCapability: {
             }>>;
             includeStationary: z.ZodOptional<z.ZodBoolean>;
             classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                sensor: "sensor";
+                audio: "audio";
+                pipeline: "pipeline";
+            }>>>;
         }, z.core.$strip>, z.ZodObject<{
             tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 retrainStatus: z.ZodOptional<z.ZodEnum<{

package/dist/capabilities/settings-store.cap.d.ts

@@ -8,6 +8,7 @@ declare const QueryFilterSchema: z.ZodObject<{
     whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
     whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
     whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
     orderBy: z.ZodOptional<z.ZodObject<{
         field: z.ZodString;
         direction: z.ZodEnum<{
@@ -32,6 +33,7 @@ declare const MutationFilterSchema: z.ZodObject<{
     whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
     whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
     whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
 }, z.core.$strip>;
 /**
  * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -177,6 +179,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -269,6 +272,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             deleted: z.ZodNumber;
@@ -286,6 +290,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>, z.ZodObject<{
@@ -300,6 +305,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -348,6 +354,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -374,6 +381,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{

package/dist/index.js

@@ -9137,6 +9137,9 @@ var QueryFilterSchema = zod.z.object({
 	whereBetween: zod.z.record(zod.z.string(), zod.z.tuple([zod.z.unknown(), zod.z.unknown()])).optional(),
 	/** NULL-safe exclusion: matches rows whose field is NULL OR != the value. */
 	whereNot: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	/** NULL-safe exclusion of a SET — `whereNot` for more than one value. An
+	*  empty list excludes nothing. See `QueryFilter.whereNotIn`. */
+	whereNotIn: zod.z.record(zod.z.string(), zod.z.array(zod.z.unknown())).optional(),
 	orderBy: zod.z.object({
 		field: zod.z.string(),
 		direction: zod.z.enum(["asc", "desc"])
@@ -9157,7 +9160,8 @@ var MutationFilterSchema = zod.z.object({
 	where: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
 	whereIn: zod.z.record(zod.z.string(), zod.z.array(zod.z.unknown())).optional(),
 	whereBetween: zod.z.record(zod.z.string(), zod.z.tuple([zod.z.unknown(), zod.z.unknown()])).optional(),
-	whereNot: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+	whereNot: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	whereNotIn: zod.z.record(zod.z.string(), zod.z.array(zod.z.unknown())).optional()
 });
 /**
 * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -18649,10 +18653,12 @@ var TrackSourceSchema = zod.z.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 = zod.z.enum([
 	"none",
@@ -19433,7 +19439,9 @@ var RecentTracksQueryInput = zod.z.object({
 	* whose class list is unreadable are kept, and the client's rule stays the
 	* exact one.
 	*/
-	classes: zod.z.array(zod.z.string()).optional()
+	classes: zod.z.array(zod.z.string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: zod.z.array(TrackSourceSchema).optional()
 });
 /**
 * A Summary (D359): the per-camera session envelope that references tracks.
@@ -19893,7 +19901,9 @@ var pipelineAnalyticsCapability = {
 			* selected is an operator who has not narrowed anything, and an empty
 			* timeline would read as a camera that saw nothing.
 			*/
-			classes: zod.z.array(zod.z.string()).optional()
+			classes: zod.z.array(zod.z.string()).optional(),
+			/** See {@link ExcludeSourcesDoc}. */
+			excludeSources: zod.z.array(TrackSourceSchema).optional()
 		}), zod.z.array(TrackSchema).readonly()),
 		/**
 		* Batched cluster-wide track listing — ONE call for the events page /

package/dist/index.mjs

@@ -9136,6 +9136,9 @@ var QueryFilterSchema = z.object({
 	whereBetween: z.record(z.string(), z.tuple([z.unknown(), z.unknown()])).optional(),
 	/** NULL-safe exclusion: matches rows whose field is NULL OR != the value. */
 	whereNot: z.record(z.string(), z.unknown()).optional(),
+	/** NULL-safe exclusion of a SET — `whereNot` for more than one value. An
+	*  empty list excludes nothing. See `QueryFilter.whereNotIn`. */
+	whereNotIn: z.record(z.string(), z.array(z.unknown())).optional(),
 	orderBy: z.object({
 		field: z.string(),
 		direction: z.enum(["asc", "desc"])
@@ -9156,7 +9159,8 @@ var MutationFilterSchema = z.object({
 	where: z.record(z.string(), z.unknown()).optional(),
 	whereIn: z.record(z.string(), z.array(z.unknown())).optional(),
 	whereBetween: z.record(z.string(), z.tuple([z.unknown(), z.unknown()])).optional(),
-	whereNot: z.record(z.string(), z.unknown()).optional()
+	whereNot: z.record(z.string(), z.unknown()).optional(),
+	whereNotIn: z.record(z.string(), z.array(z.unknown())).optional()
 });
 /**
 * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -18648,10 +18652,12 @@ var TrackSourceSchema = z.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 = z.enum([
 	"none",
@@ -19432,7 +19438,9 @@ var RecentTracksQueryInput = z.object({
 	* whose class list is unreadable are kept, and the client's rule stays the
 	* exact one.
 	*/
-	classes: z.array(z.string()).optional()
+	classes: z.array(z.string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: z.array(TrackSourceSchema).optional()
 });
 /**
 * A Summary (D359): the per-camera session envelope that references tracks.
@@ -19892,7 +19900,9 @@ var pipelineAnalyticsCapability = {
 			* selected is an operator who has not narrowed anything, and an empty
 			* timeline would read as a camera that saw nothing.
 			*/
-			classes: z.array(z.string()).optional()
+			classes: z.array(z.string()).optional(),
+			/** See {@link ExcludeSourcesDoc}. */
+			excludeSources: z.array(TrackSourceSchema).optional()
 		}), z.array(TrackSchema).readonly()),
 		/**
 		* Batched cluster-wide track listing — ONE call for the events page /

package/dist/interfaces/storage.d.ts

@@ -208,6 +208,25 @@ export interface QueryFilter {
      * kind-exclusion must KEEP).
      */
     whereNot?: Record<string, unknown>;
+    /**
+     * NULL-safe exclusion of SEVERAL values — `whereNot` for a set.
+     *
+     * A row matches when its field is NULL OR not one of the listed values, for
+     * the same reason `whereNot` is NULL-safe: on a nullable column the NULL
+     * rows are the ones written before the column existed, and a "not these
+     * kinds" filter must keep them.
+     *
+     * It exists because `whereNot` is a `Record` keyed by field, so ONE field
+     * can carry exactly one excluded value. Excluding two members of a small
+     * enum (the case that produced it: `Track.source`, hiding the synthetic
+     * `audio` and `sensor` projections at once) was otherwise inexpressible —
+     * and the alternative, dropping the rows in the caller after the read, makes
+     * paging lie about how much is left.
+     *
+     * An EMPTY list is no filter, never "matches nothing": it is a chip row with
+     * nothing selected. Same rule as `whereJsonArrayAny`.
+     */
+    whereNotIn?: Record<string, unknown[]>;
     /**
      * "This JSON array column contains at least one of these values."
      *

package/package.json

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