@camstack/types 1.2.272 → 1.2.274

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DYGSsCgK.js");
+const require_sleep = require("./sleep-WOeeZ4FU.js");
 const require_event_category = require("./event-category-MbnB-6AN.js");
 const require_composition = require("./composition-BRxAnxtU.js");
 const require_err_msg = require("./err-msg-Dx2Kor0g.js");
@@ -16,7 +16,7 @@ let zod = require("zod");
 * ```
 *
 * The owner type is a TABLE. That is already true of every owner on the live
-* hub - `track`, `summary`, `face`, `identity`, `plate` - and the exception was
+* hub - `track`, `face`, `identity`, `plate` - and the exception was
 * `event`, which covered three tables at once. While event ids were UUIDs the
 * ambiguity cost nothing, because a UUID is unique across tables. D474 made an
 * event id a SQLite rowid alias, so each table numbers from 1 and `event:5`
@@ -62,10 +62,13 @@ let zod = require("zod");
 * are declared owner kinds with no rows today, and the parser would have
 * rejected their keys the day one appeared. A list derived from data is a list
 * that is correct until the data changes.
+*
+* `summary` is gone with the session summary it named (D680): a `summary:` key
+* left on disk is unreadable by design, like a legacy `event:` one, and the
+* orphan audit reclaims its row as a retired owner.
 */
 var MEDIA_OWNER_TYPES = [
 	"track",
-	"summary",
 	"face",
 	"identity",
 	"plate",
@@ -655,6 +658,92 @@ async function resolveEgressDecodeHwAccel(deps) {
 	return resolved;
 }
 //#endregion
+//#region src/ffmpeg/gif-derive.ts
+/**
+* The notification GIF's filter chain and argv — ONE definition for every
+* process that derives a gif from a notification video.
+*
+* ## Why this lives in `@camstack/types`
+*
+* Two addons derive a notification gif from an mp4, and they may never import
+* each other:
+*
+*  - the stream broker (`addon-pipeline`), from the clip it just cut out of its
+*    own ring (`gif-from-mp4.ts`);
+*  - the notification centre (`addon-post-analysis`), from a clip cut out of
+*    the RECORDINGS when the moment is older than any ring holds
+*    ([D682](../../../../docs/decisions/adr-0682-a-pick-ups-footage-is-cut-around-the-pick-up.md)).
+*
+* Two copies of this chain would be two gifs of the same kind of moment that
+* look different depending on how old the moment was — the class of defect
+* D85/D91 already paid for once. So the chain is here, pure and dependency
+* free, and each caller owns only its own process lifecycle.
+*
+* ## The palette was never the problem
+*
+* The `split` + `palettegen(stats_mode=diff)` + `paletteuse(bayer)` pair is
+* right and stays. The measured cause of "the gif looks de-pixellated" was a
+* 640×360 substream scaled DOWN to 480 px, upstream of the palette. The `split`
+* form is a single READ of the input, not a lesser two-pass.
+*/
+/**
+* Format a frame rate for an ffmpeg filter argument.
+*
+* `12 / 4` must reach the filter as `3` and `15 / 4` as `3.75`, not as a float
+* tail that `av_parse_video_rate` then has to guess at.
+*/
+function ffmpegRate(rate) {
+	return String(Math.round(rate * 1e3) / 1e3);
+}
+/**
+* The factor the derive must apply ON TOP of the speed the mp4 already carries.
+*
+* The gif is derived from a muxed mp4, so if that mux already ran `setpts` at
+* the caller's `speed`, applying the absolute gif rate again would compound
+* them — a 4× gif beside a 2× video would come out at 8×. Discounting here is
+* what keeps the gif rate ABSOLUTE against real time whatever the video does.
+*/
+function gifDeriveSpeed(gifSpeed, videoSpeed) {
+	if (!Number.isFinite(videoSpeed) || videoSpeed <= 0) return gifSpeed;
+	return gifSpeed / videoSpeed;
+}
+/**
+* The filter chain. Extracted so a test can assert the palette pair without
+* spawning ffmpeg — an argv test cannot see quality, but it can see a filter
+* that somebody deleted.
+*
+* `fps` BEFORE `setpts`: decimating an already sped-up timeline yields `speed`
+* times the frames asked for, and a gif pays for every one. So the decimation
+* runs at `fps / speed` in SOURCE time and `setpts` multiplies what survived.
+* The trailing `fps` re-declares the rate, which is NOT redundant: `setpts`
+* leaves the filter link advertising the sampled rate and the gif muxer
+* believes the link — measured on 615 as a 3.01 s gif of ten frames.
+*/
+function gifFilterComplex(input) {
+	const speed = input.speed > 0 ? input.speed : 1;
+	if (speed === 1) return `[0:v]fps=${ffmpegRate(input.fps)},scale=${input.maxWidth}:-2:flags=lanczos,split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle`;
+	return `[0:v]fps=${ffmpegRate(input.fps / speed)},setpts=PTS/${speed},fps=${ffmpegRate(input.fps)},scale=${input.maxWidth}:-2:flags=lanczos,split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle`;
+}
+/** The full argv: mp4 in, gif on stdout. */
+function gifFromMp4Args(input) {
+	return [
+		"-y",
+		"-v",
+		"error",
+		"-f",
+		"mp4",
+		"-i",
+		input.input ?? "pipe:0",
+		"-filter_complex",
+		gifFilterComplex(input),
+		"-loop",
+		"0",
+		"-f",
+		"gif",
+		"pipe:1"
+	];
+}
+//#endregion
 //#region src/ffmpeg/sharing-key.ts
 /**
 * The sharing key for `streamBroker.acquireEgressTranscode`.
@@ -21735,6 +21824,21 @@ var ObjectEventSchema = zod.z.object({
 	keyFrameMediaId: zod.z.number().int().optional(),
 	/** Populated by B5 (recording playback URL for this event). */
 	mediaUrl: zod.z.string().optional(),
+	/**
+	* When the change this row records HAPPENED, epoch ms, when that is earlier
+	* than {@link timestamp} and the producer could date it (D684).
+	*
+	* Set on a package PICK-UP row only: its `timestamp` is when the departure
+	* was CONCLUDED — five minutes of unseen observed time after the parcel went
+	* — and a notification's footage has to be cut around the pick-up, not the
+	* empty doormat after it (D682). Stored so every path that rebuilds a
+	* notification subject from the row (the boot reconcile, a dry-run) anchors
+	* on the same instant the live hook did.
+	*
+	* `timestamp` keeps its meaning. Absent on every other row and on every
+	* pick-up written before D684 — UNKNOWN, never 0 and never `timestamp`.
+	*/
+	observedAt: zod.z.number().optional(),
 	/** The parent track's key-event importance [0,1], propagated to every object
 	*  event of the track (so an event row can be sorted by importance without a
 	*  track join). Absent on legacy rows / before the track was scored. */
@@ -22080,143 +22184,6 @@ var RecentTracksQueryInput = zod.z.object({
 	/** See {@link ExcludeSourcesDoc}. */
 	excludeSources: zod.z.array(TrackSourceSchema).optional()
 });
-/**
-* A Summary (D359): the per-camera session envelope that references tracks.
-* `groupShotMediaId` is the media ROW id of its group shot (`ownerKind:
-* 'summary'`, served by the event-media plane at `/m/<id>`), null until the
-* first frame with a member visible has been materialised (D482 — it was the
-* row's composite key, which embedded the owner and could name another table's
-* row once event ids became per-table rowids).
-*/
-var SummarySchema = zod.z.object({
-	id: zod.z.string(),
-	deviceId: zod.z.number(),
-	openedAt: zod.z.number(),
-	lastActiveAt: zod.z.number(),
-	sealedAt: zod.z.number().nullable(),
-	memberCount: zod.z.number().int().nonnegative(),
-	groupShotMediaId: zod.z.number().int().nullable()
-});
-var SUMMARIES_MAX_LIMIT = 200;
-var SUMMARIES_DEFAULT_LIMIT = 50;
-var SummariesQueryInput = zod.z.object({
-	deviceIds: zod.z.array(zod.z.number()).min(1),
-	since: zod.z.number().optional(),
-	until: zod.z.number().optional(),
-	limit: zod.z.number().int().min(1).max(200).default(50),
-	/** The same member-wise filter {@link listRecentSummaries} takes — one
-	*  meaning of "dog" on every summary surface. */
-	classes: zod.z.array(zod.z.string().min(1).max(60)).max(40).optional()
-});
-/**
-* One member of a group, as a reader needs it.
-*
-* The class and the role travel WITH the id because every consumer that shows
-* a group has to say what it was made of — "two people and a dog" — and asking
-* `getTrack` per member to find that out turns one card into `memberCount`
-* round trips. The member row already holds both (they are written at the
-* join), so this costs the reader nothing.
-*/
-var SummaryMemberSchema = zod.z.object({
-	trackId: zod.z.string(),
-	/**
-	* The track's class at the time it JOINED, or `null` when it was unresolved
-	* and the track no longer exists to fill it.
-	*
-	* The join, not the latest opinion: class voting can re-decide a track's
-	* class afterwards, and a group's composition is the history of who came
-	* together. A consumer counts these to badge a thumbnail — "two people and a
-	* dog" — rather than being handed a second, denormalised tally that would
-	* drift from the members it claims to describe.
-	*/
-	className: zod.z.string().nullable(),
-	/** `primary` is the one member that carries the group's identity. */
-	role: zod.z.enum([
-		"primary",
-		"sibling",
-		"child"
-	]).nullable(),
-	joinedAt: zod.z.number(),
-	/** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
-	*  at read time. Absent when nothing resolved, never an empty string. */
-	label: zod.z.string().optional(),
-	/** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
-	*  recognised nobody, and absent for a member whose track has been pruned —
-	*  a thumbnail that names the wrong person is worse than one naming nobody. */
-	subLabel: zod.z.string().optional()
-});
-var SummaryDetailSchema = zod.z.object({
-	summary: SummarySchema,
-	/** Members in absorption order, oldest join first. */
-	members: zod.z.array(SummaryMemberSchema).readonly()
-});
-/**
-* What a LIST of groups carries: the envelope plus what it is MADE OF.
-*
-* Coarse on purpose — the operator's rule is "only the rough data on the list,
-* we extend when we notice we need more". Enough to draw the card ("two people
-* and a dog") and no more. The MEMBERS, their names and the per-member links
-* are on {@link getSummary}: shipping every member of every group so a client
-* can count them turns a page of two hundred groups into a thousand records to
-* draw two hundred badges.
-*/
-var SummaryListItemSchema = zod.z.object({
-	summary: SummarySchema,
-	/** Class counts, most numerous first; `className: null` is a member whose
-	*  class never resolved, counted so the counts add up to `memberCount`. */
-	classes: zod.z.array(zod.z.object({
-		className: zod.z.string().nullable(),
-		count: zod.z.number().int().positive()
-	})).readonly()
-});
-var SummariesPageSchema = zod.z.object({ summaries: zod.z.array(SummaryListItemSchema).readonly() });
-/**
-* The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
-*
-* The reel on the cameras page and the Events gallery both ride a cursor, so a
-* summaries feed that could only answer "the last N for these cameras"
-* (`listSummaries`) would make groups available in the timeline and nowhere
-* else. Two feeds with different ordering contracts would be two ideas of what
-* "newest" means, on one screen.
-*/
-var RecentSummariesQueryInput = zod.z.object({
-	/** Devices to merge. An empty array yields an empty page. */
-	deviceIds: zod.z.array(zod.z.number()),
-	/** Window lower bound on `lastActiveAt` (inclusive). */
-	since: zod.z.number().optional(),
-	/** Window upper bound on `lastActiveAt` (inclusive). */
-	until: zod.z.number().optional(),
-	limit: zod.z.number().int().min(1).max(500).default(100),
-	/** Opaque continuation cursor from a previous page's `nextCursor`. */
-	cursor: zod.z.string().optional(),
-	/**
-	* Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
-	* deliberately the same name: the events filter tree emits one list of ticked
-	* taxonomy nodes, and a summaries feed that called it something else would
-	* make the operator's one filter component produce two shapes.
-	*
-	* A question about the MEMBERS: a group matches when ANY of them does. "Show
-	* me the arrivals with a dog" has to return the group of four people who had
-	* one with them; a filter on the group's own fields could only ever answer
-	* about its primary.
-	*
-	* Matched against all THREE tiers of a member — the class (`animal`), the
-	* sub-class (`dog`) and the instance (a name, a plate) — because which tier a
-	* ticked node lives on is the taxonomy's business, not the caller's. `dog` is
-	* an event kind in the tree and a tier-1 label on an `animal` track; a filter
-	* that read only the class would answer "animal" and never "dog".
-	*
-	* ABSENT or EMPTY means no filter — absent is not a selection of none.
-	*/
-	classes: zod.z.array(zod.z.string().min(1).max(60)).max(40).optional()
-});
-var RecentSummariesPageSchema = zod.z.object({
-	/** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
-	*  {@link listSummaries} — one list shape, so a card renders the same
-	*  whichever feed drew it. */
-	summaries: zod.z.array(SummaryListItemSchema).readonly(),
-	nextCursor: zod.z.string().nullable()
-});
 var RecentTracksPageSchema = zod.z.object({
 	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
 	tracks: zod.z.array(TrackSchema).readonly(),
@@ -22803,15 +22770,6 @@ var pipelineAnalyticsCapability = {
 		* are not included (same contract as `listTracks`).
 		*/
 		listRecentTracks: require_sleep.method(RecentTracksQueryInput, RecentTracksPageSchema),
-		/** Newest first by `openedAt`, for a camera set, inside an optional window. */
-		listSummaries: require_sleep.method(SummariesQueryInput, SummariesPageSchema),
-		/**
-		* The PAGED feed — the reel and the Events gallery. Same cursor contract as
-		* {@link listRecentTracks}, so one screen cannot hold two ideas of newest.
-		*/
-		listRecentSummaries: require_sleep.method(RecentSummariesQueryInput, RecentSummariesPageSchema),
-		/** One summary with its member track ids; `null` for an id nobody wrote. */
-		getSummary: require_sleep.method(zod.z.object({ id: zod.z.string() }), SummaryDetailSchema.nullable()),
 		clearTracks: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), {
 			kind: "mutation",
 			auth: "admin"
@@ -55962,12 +55920,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.getSummary": {
-		capName: "pipeline-analytics",
-		capScope: "device",
-		addonId: null,
-		access: "view"
-	},
 	"pipelineAnalytics.getTrack": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -56028,12 +55980,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.listRecentSummaries": {
-		capName: "pipeline-analytics",
-		capScope: "device",
-		addonId: null,
-		access: "view"
-	},
 	"pipelineAnalytics.listRecentTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -56064,12 +56010,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.listSummaries": {
-		capName: "pipeline-analytics",
-		capScope: "device",
-		addonId: null,
-		access: "view"
-	},
 	"pipelineAnalytics.listTrackMedia": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -60574,11 +60514,6 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: true
 	}],
-	"pipelineAnalytics.listRecentSummaries": [{
-		name: "deviceIds",
-		form: "array",
-		optional: false
-	}],
 	"pipelineAnalytics.listRecentTracks": [{
 		name: "deviceIds",
 		form: "array",
@@ -60589,11 +60524,6 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "array",
 		optional: true
 	}],
-	"pipelineAnalytics.listSummaries": [{
-		name: "deviceIds",
-		form: "array",
-		optional: false
-	}],
 	"pipelineAnalytics.listTrackMedia": [{
 		name: "deviceId",
 		form: "single",
@@ -69525,8 +69455,6 @@ exports.STORAGE_LOCATION_MODES = STORAGE_LOCATION_MODES;
 exports.STREAM_PROFILE_META = STREAM_PROFILE_META;
 exports.STREAM_QUALITY_LABELS = STREAM_QUALITY_LABELS;
 exports.SUB_DETECTION_TYPES = SUB_DETECTION_TYPES;
-exports.SUMMARIES_DEFAULT_LIMIT = SUMMARIES_DEFAULT_LIMIT;
-exports.SUMMARIES_MAX_LIMIT = SUMMARIES_MAX_LIMIT;
 exports.SYSTEM_CAP_NAMES = SYSTEM_CAP_NAMES;
 exports.SYSTEM_SCOPE_DEVICE_METHODS = SYSTEM_SCOPE_DEVICE_METHODS;
 exports.SceneCheckSchema = SceneCheckSchema;
@@ -69636,7 +69564,6 @@ exports.SubscribeAudioChunksInputSchema = require_sleep.SubscribeAudioChunksInpu
 exports.SubscribeAudioChunksResultSchema = require_sleep.SubscribeAudioChunksResultSchema;
 exports.SubscribeFramesInputSchema = require_sleep.SubscribeFramesInputSchema;
 exports.SubscribeFramesResultSchema = require_sleep.SubscribeFramesResultSchema;
-exports.SummarySchema = SummarySchema;
 exports.SwitchStatusSchema = SwitchStatusSchema;
 exports.SystemMetricsSchema = SystemMetricsSchema;
 exports.SystemMirror = SystemMirror;
@@ -69982,6 +69909,7 @@ exports.featureProbeCapability = featureProbeCapability;
 exports.featureSources = require_composition.featureSources;
 exports.feederCustomizationExample = feederCustomizationExample;
 exports.feederExampleSources = feederExampleSources;
+exports.ffmpegRate = ffmpegRate;
 exports.fieldReads = require_composition.fieldReads;
 exports.filesystemBrowseCapability = filesystemBrowseCapability;
 exports.findCandidateCycles = findCandidateCycles;
@@ -70001,6 +69929,9 @@ exports.getByPath = getByPath;
 exports.getCapsByProviderKind = getCapsByProviderKind;
 exports.getLogChannelRegistry = getLogChannelRegistry;
 exports.getTaxonomyEntry = getTaxonomyEntry;
+exports.gifDeriveSpeed = gifDeriveSpeed;
+exports.gifFilterComplex = gifFilterComplex;
+exports.gifFromMp4Args = gifFromMp4Args;
 exports.hasMotionTrigger = hasMotionTrigger;
 exports.hfModelUrl = hfModelUrl;
 exports.htmlToText = htmlToText;