@camstack/addon-post-analysis 1.2.126 → 1.2.127

package/dist/pipeline-analytics/index.js

@@ -46374,6 +46374,50 @@ var AUDIO_COLUMNS = [
 		type: "JSON"
 	}
 ];
+/**
+* The columns `slimMotion` reads. `id` is the primary key — always returned,
+* never part of a projection.
+*
+* What it leaves behind is the point: `regions` is a JSON array with one entry
+* per motion rectangle, and it is the only reason a motion row is not tiny.
+* `frameWidth` / `frameHeight` go with it — they exist to interpret `regions`
+* and mean nothing without it.
+*/
+var SLIM_MOTION_COLUMNS = [
+	"deviceId",
+	"timestamp",
+	"regionCount"
+];
+/**
+* The columns `slimObject` reads — and ONLY those.
+*
+* Four JSON columns are dropped (`bbox`, `zones`, `labelMeta`, `subLabelMeta`)
+* plus the numbers that only exist to argue about a value after the fact
+* (`confidence`, `labelScore`, `subLabelScore`) and the frame geometry that,
+* like motion's, is meaningless without the box it describes.
+*
+* `label` / `subLabel` stay because the timeline renders `subLabel ?? label`,
+* which cannot be evaluated from half a row. `frameId` / `trackId` /
+* `importance` stay because they are the grouping and sort keys the events page
+* needs — all three are light.
+*
+* ⚠ `slimObject` calls `readTieredLabelColumns`, which reads all SIX tiered
+* columns and returns the four unprojected ones as `undefined`. That is
+* harmless here only because `slimObject` uses exactly `label` and `subLabel`
+* from what it gets back. If it ever starts reading a score, this list is the
+* thing that has to learn about it — the failure would otherwise be a score
+* that reads as absent on every slim row.
+*/
+var SLIM_OBJECT_COLUMNS = [
+	"deviceId",
+	"timestamp",
+	"className",
+	"frameId",
+	"trackId",
+	"importance",
+	"label",
+	"subLabel"
+];
 var COMMON_INDEXES = (prefix) => [{
 	name: `idx_${prefix}_device_ts`,
 	columns: ["deviceId", "timestamp"]
@@ -46557,6 +46601,19 @@ var EventStore = class {
 			filter
 		})]);
 	}
+	/**
+	* Spreadable `columns` for a slim read — omitted entirely for `full`.
+	*
+	* The projection is decided in ONE place per collection ({@link
+	* SLIM_MOTION_COLUMNS} / {@link SLIM_OBJECT_COLUMNS}) because a projection is
+	* a promise between the SELECT and the mapper: the day they disagree nothing
+	* fails. SQLite returns the row without the column, `slimObject` reads
+	* `data['className']`, gets `undefined`, and hands back an event whose class
+	* is missing — indistinguishable from a row that never had one.
+	*/
+	slimColumns(projection, columns) {
+		return projection === "slim" ? { columns } : {};
+	}
 	buildFilter(q) {
 		const filter = {
 			where: { deviceId: q.deviceId },
@@ -46572,7 +46629,8 @@ var EventStore = class {
 	async queryMotion(q) {
 		const rows = await this.store.query.query({
 			collection: MOTION_EVENTS_COLLECTION,
-			filter: this.buildFilter(q)
+			filter: this.buildFilter(q),
+			...this.slimColumns(q.projection, SLIM_MOTION_COLUMNS)
 		});
 		if (q.projection === "slim") return rows.map((r) => slimMotion(r.id, stripNulls$1(r.data)));
 		return rows.map((r) => {
@@ -46642,7 +46700,8 @@ var EventStore = class {
 		}
 		const rows = await this.store.query.query({
 			collection: OBJECT_EVENTS_COLLECTION,
-			filter
+			filter,
+			...this.slimColumns(q.projection, SLIM_OBJECT_COLUMNS)
 		});
 		if (q.projection === "slim") return rows.map((r) => slimObject(r.id, stripNulls$1(r.data)));
 		return rows.map((r) => {
@@ -49301,6 +49360,16 @@ function trackColumnsFor(projection, needsPositions = false) {
 	if (projection !== "slim") return void 0;
 	return needsPositions ? [...SLIM_TRACK_COLUMN_NAMES, "positions"] : SLIM_TRACK_COLUMN_NAMES;
 }
+/**
+* The SELECT list for an IDS-ONLY recent page: the primary key (free, always
+* returned) plus `lastSeen`.
+*
+* `lastSeen` is not an optimisation to shave off later — {@link
+* TrackStore.recentPage} orders on it, windows on it and breaks
+* same-millisecond ties with it. Reading ids without it would produce a page in
+* whatever order the engine felt like and a cursor that cannot resume.
+*/
+var RECENT_IDS_COLUMNS = ["lastSeen"];
 /** Spreadable `columns` for a store query — omitted entirely for `full`. */
 function projectionArg(projection, needsPositions = false) {
 	const columns = trackColumnsFor(projection, needsPositions);
@@ -50555,10 +50624,48 @@ var TrackStore = class {
 	* Errors propagate (no partial merges): a failed device query fails the
 	* page rather than silently returning an incomplete window.
 	*/
+	/**
+	* A page of RECENT track ids, and nothing else.
+	*
+	* Two callers only ever wanted the strings — `collectLiveTrackIds` (the
+	* orphan audit's live set) and `listTrackIdPage` (the embedding rebuild's
+	* cursor walk) — and both were reading whole tracks to build them. This reads
+	* the primary key plus `lastSeen`, which is not a saving to be traded away:
+	* the cursor, the descending order and the same-millisecond tie-break are all
+	* defined on `lastSeen`, so a page without it would be unordered and
+	* unresumable.
+	*
+	* It shares {@link recentPage} with {@link queryRecent} rather than repeating
+	* the window/cursor arithmetic. Two copies of a paging rule is how one of
+	* them learns about a new bound and the other does not.
+	*/
+	async queryRecentIds(params) {
+		const { page, nextCursor } = await this.recentPage(params, RECENT_IDS_COLUMNS);
+		return {
+			trackIds: page.map((r) => r.id),
+			nextCursor
+		};
+	}
 	async queryRecent(params) {
+		const { page, nextCursor } = await this.recentPage(params, trackColumnsFor(params.projection));
+		return {
+			tracks: page.map((r) => this.rowToTrack(r.id, r.data, params.projection)),
+			nextCursor
+		};
+	}
+	/**
+	* The window, cursor and fan-out arithmetic behind every "recent tracks"
+	* read — shared so the SELECT list is the only thing a caller varies.
+	*
+	* `columns` is passed straight through to the engine (`undefined` = the whole
+	* row). Everything else here is projection-agnostic on purpose: which rows a
+	* page contains, and in what order, must not depend on how much of each row
+	* the caller asked to read.
+	*/
+	async recentPage(params, columns) {
 		const deviceIds = [...new Set(params.deviceIds)];
 		if (deviceIds.length === 0) return {
-			tracks: [],
+			page: [],
 			nextCursor: null
 		};
 		const requested = Math.min(Math.max(params.limit ?? RECENT_DEFAULT_LIMIT, 1), RECENT_MAX_LIMIT);
@@ -50582,7 +50689,7 @@ var TrackStore = class {
 		const winHi = params.until ?? Number.MAX_SAFE_INTEGER;
 		const hi = cursor !== null ? Math.min(cursor.lastSeen, winHi) : winHi;
 		if (hi < lo) return {
-			tracks: [],
+			page: [],
 			nextCursor: null
 		};
 		const stationaryExclusion = params.excludeStationaryPromotions === true ? { whereNot: { closedReason: "stationary-promotion" } } : {};
@@ -50598,7 +50705,7 @@ var TrackStore = class {
 				},
 				...pageLimit !== void 0 ? { limit: pageLimit } : {}
 			},
-			...projectionArg(params.projection)
+			...columns === void 0 ? {} : { columns }
 		});
 		const perDevice = await Promise.all(deviceIds.map(async (deviceId) => {
 			if (cursor === null || cursor.lastSeen > hi) return fetchRange(deviceId, [lo, hi], limit + 1);
@@ -50622,10 +50729,9 @@ var TrackStore = class {
 		}
 		candidates.sort(compareRecentDesc);
 		const page = candidates.slice(0, limit);
-		const tracks = page.map((r) => this.rowToTrack(r.id, r.data, params.projection));
 		const last = page[page.length - 1];
 		return {
-			tracks,
+			page,
 			nextCursor: candidates.length > limit && last !== void 0 ? encodeRecentCursor({
 				lastSeen: last.lastSeen,
 				trackId: last.id
@@ -64417,11 +64523,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 		const trackStore = this.trackStore;
 		if (!trackStore) return live;
 		for (const deviceId of deviceIds) {
-			const page = await trackStore.queryRecent({
+			const page = await trackStore.queryRecentIds({
 				deviceIds: [deviceId],
 				limit: EMBEDDING_ORPHAN_SCAN_LIMIT
 			});
-			for (const track of page.tracks) live.add(track.trackId);
+			for (const trackId of page.trackIds) live.add(trackId);
 		}
 		return live;
 	}
@@ -64744,19 +64850,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			logger: this.ctx.logger
 		}));
 		const deps = {
-			listTrackIdPage: async (cursor) => {
-				const page = await trackStore.queryRecent({
-					deviceIds,
-					...input.since !== void 0 ? { since: input.since } : {},
-					...input.until !== void 0 ? { until: input.until } : {},
-					...cursor !== null ? { cursor } : {},
-					limit: REBUILD_PAGE_SIZE
-				});
-				return {
-					trackIds: page.tracks.map((t) => t.trackId),
-					nextCursor: page.nextCursor
-				};
-			},
+			listTrackIdPage: async (cursor) => trackStore.queryRecentIds({
+				deviceIds,
+				...input.since !== void 0 ? { since: input.since } : {},
+				...input.until !== void 0 ? { until: input.until } : {},
+				...cursor !== null ? { cursor } : {},
+				limit: REBUILD_PAGE_SIZE
+			}),
 			loadSource: (trackId) => loadRebuildSource({
 				media: mediaStore,
 				events: eventStore

package/dist/pipeline-analytics/index.mjs

@@ -46311,6 +46311,50 @@ var AUDIO_COLUMNS = [
 		type: "JSON"
 	}
 ];
+/**
+* The columns `slimMotion` reads. `id` is the primary key — always returned,
+* never part of a projection.
+*
+* What it leaves behind is the point: `regions` is a JSON array with one entry
+* per motion rectangle, and it is the only reason a motion row is not tiny.
+* `frameWidth` / `frameHeight` go with it — they exist to interpret `regions`
+* and mean nothing without it.
+*/
+var SLIM_MOTION_COLUMNS = [
+	"deviceId",
+	"timestamp",
+	"regionCount"
+];
+/**
+* The columns `slimObject` reads — and ONLY those.
+*
+* Four JSON columns are dropped (`bbox`, `zones`, `labelMeta`, `subLabelMeta`)
+* plus the numbers that only exist to argue about a value after the fact
+* (`confidence`, `labelScore`, `subLabelScore`) and the frame geometry that,
+* like motion's, is meaningless without the box it describes.
+*
+* `label` / `subLabel` stay because the timeline renders `subLabel ?? label`,
+* which cannot be evaluated from half a row. `frameId` / `trackId` /
+* `importance` stay because they are the grouping and sort keys the events page
+* needs — all three are light.
+*
+* ⚠ `slimObject` calls `readTieredLabelColumns`, which reads all SIX tiered
+* columns and returns the four unprojected ones as `undefined`. That is
+* harmless here only because `slimObject` uses exactly `label` and `subLabel`
+* from what it gets back. If it ever starts reading a score, this list is the
+* thing that has to learn about it — the failure would otherwise be a score
+* that reads as absent on every slim row.
+*/
+var SLIM_OBJECT_COLUMNS = [
+	"deviceId",
+	"timestamp",
+	"className",
+	"frameId",
+	"trackId",
+	"importance",
+	"label",
+	"subLabel"
+];
 var COMMON_INDEXES = (prefix) => [{
 	name: `idx_${prefix}_device_ts`,
 	columns: ["deviceId", "timestamp"]
@@ -46494,6 +46538,19 @@ var EventStore = class {
 			filter
 		})]);
 	}
+	/**
+	* Spreadable `columns` for a slim read — omitted entirely for `full`.
+	*
+	* The projection is decided in ONE place per collection ({@link
+	* SLIM_MOTION_COLUMNS} / {@link SLIM_OBJECT_COLUMNS}) because a projection is
+	* a promise between the SELECT and the mapper: the day they disagree nothing
+	* fails. SQLite returns the row without the column, `slimObject` reads
+	* `data['className']`, gets `undefined`, and hands back an event whose class
+	* is missing — indistinguishable from a row that never had one.
+	*/
+	slimColumns(projection, columns) {
+		return projection === "slim" ? { columns } : {};
+	}
 	buildFilter(q) {
 		const filter = {
 			where: { deviceId: q.deviceId },
@@ -46509,7 +46566,8 @@ var EventStore = class {
 	async queryMotion(q) {
 		const rows = await this.store.query.query({
 			collection: MOTION_EVENTS_COLLECTION,
-			filter: this.buildFilter(q)
+			filter: this.buildFilter(q),
+			...this.slimColumns(q.projection, SLIM_MOTION_COLUMNS)
 		});
 		if (q.projection === "slim") return rows.map((r) => slimMotion(r.id, stripNulls$1(r.data)));
 		return rows.map((r) => {
@@ -46579,7 +46637,8 @@ var EventStore = class {
 		}
 		const rows = await this.store.query.query({
 			collection: OBJECT_EVENTS_COLLECTION,
-			filter
+			filter,
+			...this.slimColumns(q.projection, SLIM_OBJECT_COLUMNS)
 		});
 		if (q.projection === "slim") return rows.map((r) => slimObject(r.id, stripNulls$1(r.data)));
 		return rows.map((r) => {
@@ -49238,6 +49297,16 @@ function trackColumnsFor(projection, needsPositions = false) {
 	if (projection !== "slim") return void 0;
 	return needsPositions ? [...SLIM_TRACK_COLUMN_NAMES, "positions"] : SLIM_TRACK_COLUMN_NAMES;
 }
+/**
+* The SELECT list for an IDS-ONLY recent page: the primary key (free, always
+* returned) plus `lastSeen`.
+*
+* `lastSeen` is not an optimisation to shave off later — {@link
+* TrackStore.recentPage} orders on it, windows on it and breaks
+* same-millisecond ties with it. Reading ids without it would produce a page in
+* whatever order the engine felt like and a cursor that cannot resume.
+*/
+var RECENT_IDS_COLUMNS = ["lastSeen"];
 /** Spreadable `columns` for a store query — omitted entirely for `full`. */
 function projectionArg(projection, needsPositions = false) {
 	const columns = trackColumnsFor(projection, needsPositions);
@@ -50492,10 +50561,48 @@ var TrackStore = class {
 	* Errors propagate (no partial merges): a failed device query fails the
 	* page rather than silently returning an incomplete window.
 	*/
+	/**
+	* A page of RECENT track ids, and nothing else.
+	*
+	* Two callers only ever wanted the strings — `collectLiveTrackIds` (the
+	* orphan audit's live set) and `listTrackIdPage` (the embedding rebuild's
+	* cursor walk) — and both were reading whole tracks to build them. This reads
+	* the primary key plus `lastSeen`, which is not a saving to be traded away:
+	* the cursor, the descending order and the same-millisecond tie-break are all
+	* defined on `lastSeen`, so a page without it would be unordered and
+	* unresumable.
+	*
+	* It shares {@link recentPage} with {@link queryRecent} rather than repeating
+	* the window/cursor arithmetic. Two copies of a paging rule is how one of
+	* them learns about a new bound and the other does not.
+	*/
+	async queryRecentIds(params) {
+		const { page, nextCursor } = await this.recentPage(params, RECENT_IDS_COLUMNS);
+		return {
+			trackIds: page.map((r) => r.id),
+			nextCursor
+		};
+	}
 	async queryRecent(params) {
+		const { page, nextCursor } = await this.recentPage(params, trackColumnsFor(params.projection));
+		return {
+			tracks: page.map((r) => this.rowToTrack(r.id, r.data, params.projection)),
+			nextCursor
+		};
+	}
+	/**
+	* The window, cursor and fan-out arithmetic behind every "recent tracks"
+	* read — shared so the SELECT list is the only thing a caller varies.
+	*
+	* `columns` is passed straight through to the engine (`undefined` = the whole
+	* row). Everything else here is projection-agnostic on purpose: which rows a
+	* page contains, and in what order, must not depend on how much of each row
+	* the caller asked to read.
+	*/
+	async recentPage(params, columns) {
 		const deviceIds = [...new Set(params.deviceIds)];
 		if (deviceIds.length === 0) return {
-			tracks: [],
+			page: [],
 			nextCursor: null
 		};
 		const requested = Math.min(Math.max(params.limit ?? RECENT_DEFAULT_LIMIT, 1), RECENT_MAX_LIMIT);
@@ -50519,7 +50626,7 @@ var TrackStore = class {
 		const winHi = params.until ?? Number.MAX_SAFE_INTEGER;
 		const hi = cursor !== null ? Math.min(cursor.lastSeen, winHi) : winHi;
 		if (hi < lo) return {
-			tracks: [],
+			page: [],
 			nextCursor: null
 		};
 		const stationaryExclusion = params.excludeStationaryPromotions === true ? { whereNot: { closedReason: "stationary-promotion" } } : {};
@@ -50535,7 +50642,7 @@ var TrackStore = class {
 				},
 				...pageLimit !== void 0 ? { limit: pageLimit } : {}
 			},
-			...projectionArg(params.projection)
+			...columns === void 0 ? {} : { columns }
 		});
 		const perDevice = await Promise.all(deviceIds.map(async (deviceId) => {
 			if (cursor === null || cursor.lastSeen > hi) return fetchRange(deviceId, [lo, hi], limit + 1);
@@ -50559,10 +50666,9 @@ var TrackStore = class {
 		}
 		candidates.sort(compareRecentDesc);
 		const page = candidates.slice(0, limit);
-		const tracks = page.map((r) => this.rowToTrack(r.id, r.data, params.projection));
 		const last = page[page.length - 1];
 		return {
-			tracks,
+			page,
 			nextCursor: candidates.length > limit && last !== void 0 ? encodeRecentCursor({
 				lastSeen: last.lastSeen,
 				trackId: last.id
@@ -64354,11 +64460,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		const trackStore = this.trackStore;
 		if (!trackStore) return live;
 		for (const deviceId of deviceIds) {
-			const page = await trackStore.queryRecent({
+			const page = await trackStore.queryRecentIds({
 				deviceIds: [deviceId],
 				limit: EMBEDDING_ORPHAN_SCAN_LIMIT
 			});
-			for (const track of page.tracks) live.add(track.trackId);
+			for (const trackId of page.trackIds) live.add(trackId);
 		}
 		return live;
 	}
@@ -64681,19 +64787,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			logger: this.ctx.logger
 		}));
 		const deps = {
-			listTrackIdPage: async (cursor) => {
-				const page = await trackStore.queryRecent({
-					deviceIds,
-					...input.since !== void 0 ? { since: input.since } : {},
-					...input.until !== void 0 ? { until: input.until } : {},
-					...cursor !== null ? { cursor } : {},
-					limit: REBUILD_PAGE_SIZE
-				});
-				return {
-					trackIds: page.tracks.map((t) => t.trackId),
-					nextCursor: page.nextCursor
-				};
-			},
+			listTrackIdPage: async (cursor) => trackStore.queryRecentIds({
+				deviceIds,
+				...input.since !== void 0 ? { since: input.since } : {},
+				...input.until !== void 0 ? { until: input.until } : {},
+				...cursor !== null ? { cursor } : {},
+				limit: REBUILD_PAGE_SIZE
+			}),
 			loadSource: (trackId) => loadRebuildSource({
 				media: mediaStore,
 				events: eventStore

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.126",
+  "version": "1.2.127",
   "description": "Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",