@camstack/types 1.2.104 → 1.2.106

package/dist/index.js

@@ -1578,83 +1578,6 @@ var RecordingRetentionSchema = zod.z.object({
 	maxSizeGb: zod.z.number().min(0).optional()
 });
 /**
-* Scrub-thumbnail fidelity preset — the single per-camera selector bundling the
-* sprite tile RESOLUTION + JPEG QUALITY the recorder packs timeline-scrub
-* previews at. Five graduated steps; absent on a config = `standard` (the
-* shipped default, matching `sheet-geometry`/`sheet-composer`).
-*
-* Existing sheets are IMMUTABLE — a changed preset applies to NEW windows only.
-* Each window's index sidecar carries its own tile dims, so a camera whose
-* preset changed over time renders every historical window at the dims it was
-* written with.
-*/
-var ScrubThumbnailPresetSchema = zod.z.enum([
-	"minimal",
-	"low",
-	"standard",
-	"high",
-	"max"
-]);
-/** The default preset when a config omits `scrubThumbnails`. */
-var DEFAULT_SCRUB_THUMBNAIL_PRESET = "standard";
-/**
-* Preset → tile geometry + JPEG quality. Every step is 16:9; the graduated
-* ladder trades sheet size (and remote fetch cost) for scrub crispness.
-* `standard` matches the shipped `sheet-geometry`/`sheet-composer` defaults
-* (480×270 q72), so an unset config is byte-identical to today. The map is
-* strictly monotone in resolution AND quality across the ordered steps.
-*/
-var SCRUB_THUMBNAIL_PRESETS = {
-	minimal: {
-		tileWidth: 240,
-		tileHeight: 135,
-		quality: 55
-	},
-	low: {
-		tileWidth: 320,
-		tileHeight: 180,
-		quality: 60
-	},
-	standard: {
-		tileWidth: 480,
-		tileHeight: 270,
-		quality: 72
-	},
-	high: {
-		tileWidth: 640,
-		tileHeight: 360,
-		quality: 80
-	},
-	max: {
-		tileWidth: 960,
-		tileHeight: 540,
-		quality: 85
-	}
-};
-/** Human labels for each preset (resolution-tagged), for settings UIs. */
-var SCRUB_THUMBNAIL_PRESET_LABELS = {
-	minimal: "Minimal (240p)",
-	low: "Low (320p)",
-	standard: "Standard (480p)",
-	high: "High (640p)",
-	max: "Max (960p)"
-};
-/** Ordered low→high so a UI can render the ladder in graduated order. */
-var SCRUB_THUMBNAIL_PRESET_ORDER = [
-	"minimal",
-	"low",
-	"standard",
-	"high",
-	"max"
-];
-/**
-* Resolve the geometry for a recording config's scrub-thumbnail preset,
-* defaulting to `standard` when unset. Pure — no I/O.
-*/
-function resolveScrubThumbnailGeometry(preset) {
-	return SCRUB_THUMBNAIL_PRESETS[preset ?? "standard"];
-}
-/**
 * The full per-camera recording intent — the wire shape of a RecordingTarget.
 *
 * `bands` is the ONLY authored recording intent: what to record, when, and on
@@ -1662,7 +1585,11 @@ function resolveScrubThumbnailGeometry(preset) {
 * other field is a storage knob (profiles, segment length, retention, scrub).
 *
 * STRICT on purpose: the legacy authoring surface (`schedule`/`schedules`/
-* `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30.
+* `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30,
+* and `scrubThumbnails` — a five-step fidelity knob for a sprite tier that was
+* deleted on 2026-07-24 and had ZERO consumers in the recorder — on 2026-08-25
+* (D62: a switch that writes a store nobody reads is worse than no switch).
+* Stored rows keep loading: the READ schema is `.strip()` (config-store.ts).
 * A stale caller must fail loudly — silently stripping its legacy intent would
 * persist a band-less config, i.e. silently stop recording the camera.
 */
@@ -1685,14 +1612,7 @@ var RecordingConfigSchema = zod.z.object({
 	* "off" is the absence of a covering band, never a band value.
 	*/
 	bands: zod.z.array(RecordingBandSchema).default([]),
-	retention: RecordingRetentionSchema.optional(),
-	/**
-	* Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
-	* timeline-scrub sprite previews). Absent = `standard`. Applies to NEW
-	* windows only — existing sheets are immutable, and each window's index
-	* carries its own tile dims so mixed-preset history renders correctly.
-	*/
-	scrubThumbnails: ScrubThumbnailPresetSchema.optional()
+	retention: RecordingRetentionSchema.optional()
 }).strict();
 /**
 * Derive the {@link RecordingStorageModeSchema} summary from the authoritative
@@ -7307,11 +7227,26 @@ var settingsStoreCapability = {
 			key: zod.z.string(),
 			value: zod.z.unknown()
 		}), zod.z.void(), { kind: "mutation" }),
-		/** Get all entries matching an optional filter. */
+		/**
+		* Rows matching a filter.
+		*
+		* `columns` is a SQL-level projection: the engine SELECTs only those
+		* columns (plus the primary key) instead of the whole row. It is the only
+		* way to stop paying disk for a column that is discarded — a heavy JSON
+		* column dominates the row, and dropping it in JS after the read pays every
+		* byte first. Measured on the live `pipeline-analytics:tracks` table: a
+		* 501-row page is 4.6 MB whole and 0.11 MB projected, same index, same
+		* plan.
+		*
+		* The engine REFUSES a column it cannot serve rather than omitting it —
+		* see `SettingsQueryInput.columns` for why a projection may not be
+		* forgiving the way a predicate is.
+		*/
 		query: require_sleep.method(zod.z.object({
 			namespace: zod.z.string().optional(),
 			collection: zod.z.string(),
-			filter: QueryFilterSchema.optional()
+			filter: QueryFilterSchema.optional(),
+			columns: zod.z.array(zod.z.string()).readonly().optional()
 		}), zod.z.array(SettingsRecordSchema).readonly()),
 		/** Insert a new record. */
 		insert: require_sleep.method(zod.z.object({
@@ -7478,7 +7413,17 @@ var dataStoreProviderCapability = {
 		query: require_sleep.method(zod.z.object({
 			namespace: zod.z.string().optional(),
 			collection: zod.z.string(),
-			filter: QueryFilterSchema.optional()
+			filter: QueryFilterSchema.optional(),
+			/**
+			* SQL-level column projection — MUST mirror `settings-store.query`.
+			*
+			* This is the second schema the same call passes through, and Zod
+			* objects STRIP what they do not declare: a field present on the door
+			* and absent here does not error, it silently disappears one hop before
+			* the engine, and the caller concludes the projection does nothing.
+			* `data-door-schema-parity.spec.ts` is what keeps the two in step.
+			*/
+			columns: zod.z.array(zod.z.string()).readonly().optional()
 		}), zod.z.array(SettingsRecordSchema).readonly()),
 		/** Insert a new record. */
 		insert: require_sleep.method(zod.z.object({
@@ -23600,7 +23545,27 @@ var faceGalleryCapability = {
 	scope: "system",
 	mode: "singleton",
 	methods: {
-		listIdentities: require_sleep.method(zod.z.void(), zod.z.array(IdentitySchema).readonly()),
+		listIdentities: require_sleep.method(zod.z.object({ 
+		/**
+		* Inline {@link IdentitySchema.coverBase64} on every row.
+		*
+		* Default `false`, the same inversion `listRecentFaces` and
+		* `listPlates` took on 2026-08-25 (see `include-crops-default.ts` for
+		* why the burden belongs on the caller that WANTS the bytes). Measured
+		* on the live hub the same day: four identities cost 40,979 B with the
+		* covers inline, ~10 KB of base64 per row, on a query this UI mounts
+		* four times and the viewer holds at `staleTime: 30_000`.
+		*
+		* Nothing loses its avatar: `coverMediaKey` is already on every row and
+		* the `event-media` plane serves that key `immutable` with an ETag.
+		*
+		* **This is an INPUT field, so it does not reach the addon until the
+		* next train** — the hub router validates cap inputs against its own
+		* compiled Zod and strips a key it does not know. Until then the
+		* provider sees `undefined`, which resolves to `false`: the cheap shape
+		* is what ships, and the opt-in becomes reachable when the train lands.
+		*/
+includeCrops: zod.z.boolean().optional() }).optional(), zod.z.array(IdentitySchema).readonly()),
 		createIdentity: require_sleep.method(zod.z.object({ name: zod.z.string().min(1) }), IdentitySchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -26961,8 +26926,10 @@ var PlateInfoSchema = zod.z.object({
 	keyFrameMediaKey: zod.z.string().optional(),
 	base64: zod.z.string().optional(),
 	/**
-	* Same crop as a data-plane URL. `getPlateByTrack` returns this and
-	* never inlines JPEG; `listPlates` still inlines for the admin-ui.
+	* Same crop as a data-plane URL, always present when the plate has a stored
+	* crop. `getPlateByTrack` returns this and never inlines JPEG; `listPlates`
+	* and `searchPlates` inline the crop only when their `includeCrops` input is
+	* left at its `true` default.
 	*/
 	cropUrl: zod.z.string().optional()
 });
@@ -26995,7 +26962,25 @@ var plateGalleryCapability = {
 	methods: {
 		listPlates: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number().int().optional(),
-			limit: zod.z.number().int().positive().optional()
+			limit: zod.z.number().int().positive().optional(),
+			/**
+			* Inline the base64 crop on every row. Default `true` — the existing
+			* behaviour, kept so no caller breaks.
+			*
+			* Set `false` once the caller renders {@link PlateInfo.cropUrl}.
+			* Measured on the live hub at the 500 rows the Plates view asks for:
+			* 879,403 B and 27.7 s with the crops inline, against a few KiB of
+			* metadata without them — and the browser then caches the images.
+			*
+			* This is the plate twin of `faceGallery.listRecentFaces`'s option;
+			* plates were the one gallery list left without it.
+			*
+			* **This is an INPUT field, so it does not reach the addon until the
+			* next train.** The hub router validates cap inputs against its own
+			* compiled Zod and strips a key it does not know. Until the train
+			* ships, sending `false` is harmless and keeps the crops inline.
+			*/
+			includeCrops: zod.z.boolean().optional()
 		}).optional(), zod.z.array(PlateInfoSchema).readonly()),
 		getPlateByTrack: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number().int(),
@@ -27006,7 +26991,9 @@ var plateGalleryCapability = {
 		searchPlates: require_sleep.method(zod.z.object({
 			text: zod.z.string().min(1),
 			maxDistance: zod.z.number().int().min(0).optional(),
-			limit: zod.z.number().int().positive().optional()
+			limit: zod.z.number().int().positive().optional(),
+			/** See `listPlates.includeCrops`. Default `true`. */
+			includeCrops: zod.z.boolean().optional()
 		}), zod.z.array(PlateInfoSchema).readonly()),
 		/** Suggest groups of near-identical reads (same physical plate) for review/merge. */
 		suggestPlateClusters: require_sleep.method(zod.z.object({
@@ -27026,7 +27013,13 @@ var plateGalleryCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
-		listVehicles: require_sleep.method(zod.z.void(), zod.z.array(VehicleSchema).readonly()),
+		listVehicles: require_sleep.method(zod.z.object({ 
+		/** Inline {@link VehicleSchema.coverBase64} on every row. Default
+		*  `false` — the vehicle twin of `faceGallery.listIdentities`'s
+		*  option; `coverMediaKey` + the `event-media` plane carry the picture.
+		*  INPUT field: stripped by the hub router until the train ships, which
+		*  resolves to `false` and is exactly the intended default. */
+includeCrops: zod.z.boolean().optional() }).optional(), zod.z.array(VehicleSchema).readonly()),
 		createVehicle: require_sleep.method(zod.z.object({ name: zod.z.string().min(1) }), VehicleSchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -47838,7 +47831,6 @@ exports.DEFAULT_POOL_MEMORY_POLICY = DEFAULT_POOL_MEMORY_POLICY;
 exports.DEFAULT_RECORDING_PROFILES = DEFAULT_RECORDING_PROFILES;
 exports.DEFAULT_RETENTION = DEFAULT_RETENTION;
 exports.DEFAULT_RUNTIME_STATE_DURABILITY = require_sleep.DEFAULT_RUNTIME_STATE_DURABILITY;
-exports.DEFAULT_SCRUB_THUMBNAIL_PRESET = DEFAULT_SCRUB_THUMBNAIL_PRESET;
 exports.DEFAULT_TIMELAPSE_PREVIEW_TEXT = DEFAULT_TIMELAPSE_PREVIEW_TEXT;
 exports.DETAIL_CROP_PADDING_FIELD = DETAIL_CROP_PADDING_FIELD;
 exports.DETAIL_CROP_PADDING_KEY = DETAIL_CROP_PADDING_KEY;
@@ -48362,9 +48354,6 @@ exports.SCENE_DEFAULT_UNCOVERED_POLICY = SCENE_DEFAULT_UNCOVERED_POLICY;
 exports.SCENE_DIVERGED = SCENE_DIVERGED;
 exports.SCENE_RESET_RECAPTURES = SCENE_RESET_RECAPTURES;
 exports.SCOPE_PRESETS = SCOPE_PRESETS;
-exports.SCRUB_THUMBNAIL_PRESETS = SCRUB_THUMBNAIL_PRESETS;
-exports.SCRUB_THUMBNAIL_PRESET_LABELS = SCRUB_THUMBNAIL_PRESET_LABELS;
-exports.SCRUB_THUMBNAIL_PRESET_ORDER = SCRUB_THUMBNAIL_PRESET_ORDER;
 exports.SENSOR_FEATURES = SENSOR_FEATURES;
 exports.SENSOR_MAP = SENSOR_MAP;
 exports.SOURCE_INFO_METADATA_KEY = SOURCE_INFO_METADATA_KEY;
@@ -48387,7 +48376,6 @@ exports.ScopedTokenSchema = ScopedTokenSchema;
 exports.ScopedTokenSummarySchema = ScopedTokenSummarySchema;
 exports.ScoredObjectEventSchema = ScoredObjectEventSchema;
 exports.ScriptRunnerStatusSchema = ScriptRunnerStatusSchema;
-exports.ScrubThumbnailPresetSchema = ScrubThumbnailPresetSchema;
 exports.SearchResultSchema = SearchResultSchema;
 exports.SendEmailInputSchema = SendEmailInputSchema;
 exports.SendEmailResultSchema = SendEmailResultSchema;
@@ -48885,7 +48873,6 @@ exports.resolveMutate = resolveMutate;
 exports.resolvePoolMemoryPolicy = resolvePoolMemoryPolicy;
 exports.resolveRecordingProfiles = resolveRecordingProfiles;
 exports.resolveRunnerId = resolveRunnerId;
-exports.resolveScrubThumbnailGeometry = resolveScrubThumbnailGeometry;
 exports.resolveVariantModelId = resolveVariantModelId;
 exports.resolveViewableDeviceIds = resolveViewableDeviceIds;
 exports.roleSpec = roleSpec;