@camstack/types 1.1.47 → 1.1.49

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BkhAiFKX.js");
-const require_event_category = require("./event-category-AkBNxg_X.js");
+const require_sleep = require("./sleep-BfvNtyu8.js");
+const require_event_category = require("./event-category-CGj9fI4L.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let zod = require("zod");
@@ -870,6 +870,83 @@ 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.
 *
 * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
@@ -906,7 +983,14 @@ var RecordingConfigSchema = zod.z.object({
 	* derived into bands once via `migrateConfigToBands`.
 	*/
 	bands: zod.z.array(RecordingBandSchema).optional(),
-	retention: RecordingRetentionSchema.optional()
+	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()
 });
 //#endregion
 //#region src/interfaces/recording-config-migrate.ts
@@ -2187,6 +2271,10 @@ var MACRO_LABELS = [
 	{
 		id: "animal",
 		name: "Animal"
+	},
+	{
+		id: "package",
+		name: "Package"
 	}
 ];
 var COCO_TO_MACRO = {
@@ -2209,7 +2297,10 @@ var COCO_TO_MACRO = {
 		elephant: "animal",
 		bear: "animal",
 		zebra: "animal",
-		giraffe: "animal"
+		giraffe: "animal",
+		suitcase: "package",
+		backpack: "package",
+		handbag: "package"
 	},
 	preserveOriginal: false
 };
@@ -10917,7 +11008,11 @@ var ZoneRulesArraySchema = zod.z.array(ZoneRuleSchema).readonly();
 * Extend the enum here when a new gating consumer comes online (audio
 * gating, alert filtering, …) — no other surface needs to change.
 */
-var ZoneRuleStageEnum = zod.z.enum(["motion", "detection"]);
+var ZoneRuleStageEnum = zod.z.enum([
+	"motion",
+	"detection",
+	"package"
+]);
 /**
 * Zone rules capability — per-camera CRUD over the {@link ZoneRule}
 * arrays that decide how each pipeline stage uses the polygon zones.
@@ -10961,16 +11056,24 @@ var zoneRulesCapability = {
 		})
 	},
 	/**
-	* Runtime-state slice — both stages mirrored together so consumers
+	* Runtime-state slice — every stage mirrored together so consumers
 	* see one reactive handle (`device.state.zoneRules.value`) instead
-	* of two. Bulk-replace mutations on either stage write the full
-	* `{motion, detection}` shape, so subscribers always get the
+	* of one per stage. Bulk-replace mutations on any stage write the full
+	* `{motion, detection, package}` shape, so subscribers always get the
 	* complete current set. Consumers that only care about one stage
 	* just read the matching property.
+	*
+	* `package` backs the package-drop detector — a package zone is a
+	* `ZoneRule` on the `'package'` stage referencing drawn polygons
+	* (see docs/superpowers/specs/2026-07-17-package-zones-design.md §3.1).
+	* The orchestrator provider that writes this stage lands in a later
+	* slice; until then the mirror carries only `{motion, detection}` and
+	* consumers read `package` as absent (treat as `[]`).
 	*/
 	runtimeState: zod.z.object({
 		motion: zod.z.array(ZoneRuleSchema).readonly(),
-		detection: zod.z.array(ZoneRuleSchema).readonly()
+		detection: zod.z.array(ZoneRuleSchema).readonly(),
+		package: zod.z.array(ZoneRuleSchema).readonly()
 	})
 };
 //#endregion
@@ -12971,6 +13074,12 @@ function createSystemProxy(api) {
 			unassignPlates: (input) => dispatch("plateGallery", "unassignPlates", "mutation", input)
 		},
 		recording: { getStorageUsage: (input) => dispatch("recording", "getStorageUsage", "query", input) },
+		recordingExport: {
+			getExport: (input) => dispatch("recordingExport", "getExport", "query", input),
+			cancelExport: (input) => dispatch("recordingExport", "cancelExport", "mutation", input),
+			deleteExport: (input) => dispatch("recordingExport", "deleteExport", "mutation", input),
+			getDownloadUrl: (input) => dispatch("recordingExport", "getDownloadUrl", "query", input)
+		},
 		serverManagement: {
 			getServerPackageStatus: (input) => dispatch("serverManagement", "getServerPackageStatus", "query", input),
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
@@ -18235,6 +18344,7 @@ var EventKindIconSchema = zod.z.enum([
 	"smoke",
 	"water",
 	"button",
+	"package",
 	"generic"
 ]);
 var EventKindCategorySchema = zod.z.enum([
@@ -18242,7 +18352,8 @@ var EventKindCategorySchema = zod.z.enum([
 	"audio",
 	"detection",
 	"sensor",
-	"custom"
+	"custom",
+	"package"
 ]);
 var EventKindDescriptorSchema = zod.z.object({
 	/** Stable kind id (e.g. 'motion', 'person', 'contact'). */
@@ -23493,6 +23604,127 @@ var recordingCapability = {
 	}
 };
 //#endregion
+//#region src/capabilities/recording-export.cap.ts
+/**
+* `recordingExport` cap — render a footage time range into a single downloadable
+* MP4 (regular / accelerated / decelerated / timelapse, ± audio), kept for a
+* bounded lifetime with a durable history, auto-expiry, and optional
+* delete-after-download.
+*
+* Like `recording` this is a `scope:'system', mode:'singleton'` cap: the
+* recorder self-gates so exactly ONE node (the designated `recordingNodeId`,
+* default `hub`) registers it. Device-scoped methods carry `deviceId` in their
+* input and dispatch to that single provider; the render runs on the node that
+* owns the footage (no cross-node segment transfer). Download rides the
+* framework addon data-plane. State persists in a DurableState blob (NOT
+* SQLite); history rows survive file deletion for audit.
+*/
+/** Playback-speed multiplier for the render (1 = realtime). */
+var ExportSpeedSchema = zod.z.number().min(.25).max(32);
+/** Timelapse cadence — sample one source frame per `everyMs`, output at `outputFps`. */
+var ExportTimelapseSchema = zod.z.object({
+	everyMs: zod.z.number().int().positive(),
+	outputFps: zod.z.number().int().min(1).max(60).optional()
+});
+/**
+* Render options. `speed` and `timelapse` are mutually exclusive. `includeAudio`
+* is honoured only for a realtime-ish speed (0.5–2×); timelapse is always
+* silent. `maxLifeMs` bounds how long the finished file is kept;
+* `deleteAfterDownload` removes it shortly after the first complete download.
+*/
+var ExportOptionsSchema = zod.z.object({
+	speed: ExportSpeedSchema.optional(),
+	timelapse: ExportTimelapseSchema.optional(),
+	includeAudio: zod.z.boolean(),
+	maxLifeMs: zod.z.number().int().positive(),
+	deleteAfterDownload: zod.z.boolean(),
+	title: zod.z.string().max(200).optional()
+}).superRefine((v, ctx) => {
+	if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
+		code: zod.z.ZodIssueCode.custom,
+		message: "speed and timelapse are mutually exclusive",
+		path: ["timelapse"]
+	});
+});
+var ExportStateSchema = zod.z.enum([
+	"queued",
+	"rendering",
+	"ready",
+	"failed",
+	"expired",
+	"deleted"
+]);
+/** One export job / history row. */
+var ExportRecordSchema = zod.z.object({
+	id: zod.z.string(),
+	deviceId: zod.z.number(),
+	profile: zod.z.string(),
+	fromMs: zod.z.number(),
+	toMs: zod.z.number(),
+	options: ExportOptionsSchema,
+	state: ExportStateSchema,
+	/** 0–100 while rendering; null otherwise. */
+	progressPct: zod.z.number().nullable(),
+	/** File size once ready; null before. */
+	fileBytes: zod.z.number().nullable(),
+	expiresAt: zod.z.number(),
+	deleteAfterDownload: zod.z.boolean(),
+	/** Epoch of the first complete download; null until then. */
+	downloadedAt: zod.z.number().nullable(),
+	createdAt: zod.z.number(),
+	/** User id/name that requested the export. */
+	createdBy: zod.z.string(),
+	/** Failure reason when state is 'failed'; null otherwise. */
+	error: zod.z.string().nullable()
+});
+/** Candidate download URLs (LAN first, then operator extra hosts). */
+var ExportDownloadSchema = zod.z.object({
+	url: zod.z.string(),
+	endpoints: zod.z.array(zod.z.string())
+});
+var recordingExportCapability = {
+	name: "recordingExport",
+	scope: "system",
+	mode: "singleton",
+	methods: {
+		/** Queue a render of `[fromMs,toMs)` for `deviceId`/`profile`. Fails fast
+		*  when no footage covers the range. Returns the queued record. */
+		createExport: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			profile: zod.z.string(),
+			fromMs: zod.z.number(),
+			toMs: zod.z.number(),
+			options: ExportOptionsSchema
+		}), ExportRecordSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		/** All export rows (history included), optionally scoped to one device. */
+		listExports: require_sleep.method(zod.z.object({ deviceId: zod.z.number().optional() }), zod.z.array(ExportRecordSchema), {
+			kind: "query",
+			auth: "protected"
+		}),
+		getExport: require_sleep.method(zod.z.object({ exportId: zod.z.string() }), ExportRecordSchema, {
+			kind: "query",
+			auth: "protected"
+		}),
+		/** Abort a queued/rendering export; the partial file is removed. */
+		cancelExport: require_sleep.method(zod.z.object({ exportId: zod.z.string() }), ExportRecordSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		/** Remove the file but keep the history row (state → 'deleted'). */
+		deleteExport: require_sleep.method(zod.z.object({ exportId: zod.z.string() }), ExportRecordSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		getDownloadUrl: require_sleep.method(zod.z.object({ exportId: zod.z.string() }), ExportDownloadSchema, {
+			kind: "query",
+			auth: "protected"
+		})
+	}
+};
+//#endregion
 //#region src/capabilities/stream-catalog.cap.ts
 /**
 * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -24284,6 +24516,7 @@ var CAPABILITY_NAMES = {
 	ptzAutotrack: "ptz-autotrack",
 	reboot: "reboot",
 	recording: "recording",
+	recordingExport: "recordingExport",
 	sceneMonitor: "scene-monitor",
 	scriptRunner: "script-runner",
 	serverManagement: "server-management",
@@ -24749,6 +24982,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "recording",
 		name: "recording"
 	},
+	{
+		key: "recordingExport",
+		name: "recordingExport"
+	},
 	{
 		key: "sceneMonitor",
 		name: "scene-monitor"
@@ -25003,6 +25240,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	ptzAutotrackCapability,
 	rebootCapability,
 	recordingCapability,
+	recordingExportCapability,
 	sceneMonitorCapability,
 	scriptRunnerCapability,
 	serverManagementCapability,
@@ -28730,6 +28968,42 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"recordingExport.cancelExport": {
+		capName: "recordingExport",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"recordingExport.createExport": {
+		capName: "recordingExport",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"recordingExport.deleteExport": {
+		capName: "recordingExport",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
+	"recordingExport.getDownloadUrl": {
+		capName: "recordingExport",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"recordingExport.getExport": {
+		capName: "recordingExport",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"recordingExport.listExports": {
+		capName: "recordingExport",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"sceneMonitor.captureReference": {
 		capName: "scene-monitor",
 		capScope: "device",
@@ -29941,6 +30215,7 @@ var KNOWN_CAP_NAMES = [
 	"ptz-autotrack",
 	"reboot",
 	"recording",
+	"recordingExport",
 	"scene-monitor",
 	"script-runner",
 	"server-management",
@@ -30077,6 +30352,7 @@ var SYSTEM_CAP_NAMES = [
 	"plate-gallery",
 	"platform-probe",
 	"recording",
+	"recordingExport",
 	"server-management",
 	"settings-store",
 	"smtp-provider",
@@ -30825,6 +31101,7 @@ exports.DEFAULT_AUDIO_ANALYZER_CONFIG = DEFAULT_AUDIO_ANALYZER_CONFIG;
 exports.DEFAULT_DECODER_HWACCEL_CONFIG = DEFAULT_DECODER_HWACCEL_CONFIG;
 exports.DEFAULT_FEATURES = DEFAULT_FEATURES;
 exports.DEFAULT_RETENTION = DEFAULT_RETENTION;
+exports.DEFAULT_SCRUB_THUMBNAIL_PRESET = DEFAULT_SCRUB_THUMBNAIL_PRESET;
 exports.DEVICE_CAP_NAMES = DEVICE_CAP_NAMES;
 exports.DEVICE_PROFILES = DEVICE_PROFILES;
 exports.DEVICE_SETTINGS_CONTRIBUTION_METHODS = require_sleep.DEVICE_SETTINGS_CONTRIBUTION_METHODS;
@@ -30885,8 +31162,14 @@ exports.EventKindDescriptorSchema = EventKindDescriptorSchema;
 exports.EventKindIconSchema = EventKindIconSchema;
 exports.EventKindSchema = EventKindSchema;
 exports.EventSourceType = require_enums.EventSourceType$1;
+exports.ExportDownloadSchema = ExportDownloadSchema;
+exports.ExportOptionsSchema = ExportOptionsSchema;
+exports.ExportRecordSchema = ExportRecordSchema;
 exports.ExportSetupFieldSchema = ExportSetupFieldSchema;
 exports.ExportSetupSchema = ExportSetupSchema;
+exports.ExportSpeedSchema = ExportSpeedSchema;
+exports.ExportStateSchema = ExportStateSchema;
+exports.ExportTimelapseSchema = ExportTimelapseSchema;
 exports.ExposedDeviceSchema = ExposedDeviceSchema;
 exports.ExposureModeSchema = ExposureModeSchema;
 exports.ExpressionEvalError = ExpressionEvalError;
@@ -31118,6 +31401,9 @@ exports.RunnerFrameSourceSchema = RunnerFrameSourceSchema;
 exports.RunnerLocalLoadSchema = RunnerLocalLoadSchema;
 exports.RunnerLocalMetricsSchema = RunnerLocalMetricsSchema;
 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.SOURCE_INFO_METADATA_KEY = SOURCE_INFO_METADATA_KEY;
 exports.STREAM_PROFILE_META = STREAM_PROFILE_META;
 exports.STREAM_QUALITY_LABELS = STREAM_QUALITY_LABELS;
@@ -31133,6 +31419,7 @@ exports.ScopedTokenSchema = ScopedTokenSchema;
 exports.ScopedTokenSummarySchema = ScopedTokenSummarySchema;
 exports.ScoredObjectEventSchema = ScoredObjectEventSchema;
 exports.ScriptRunnerStatusSchema = ScriptRunnerStatusSchema;
+exports.ScrubThumbnailPresetSchema = ScrubThumbnailPresetSchema;
 exports.SearchResultSchema = SearchResultSchema;
 exports.SendEmailInputSchema = SendEmailInputSchema;
 exports.SendEmailResultSchema = SendEmailResultSchema;
@@ -31460,6 +31747,7 @@ exports.readNodePin = readNodePin;
 exports.readinessKey = require_sleep.readinessKey;
 exports.rebootCapability = rebootCapability;
 exports.recordingCapability = recordingCapability;
+exports.recordingExportCapability = recordingExportCapability;
 exports.rectsToCells = rectsToCells;
 exports.requiresPython = requiresPython;
 exports.resolveAddonExecution = resolveAddonExecution;
@@ -31473,6 +31761,7 @@ exports.resolveFormat = resolveFormat;
 exports.resolveHydratedFieldValue = require_sleep.resolveHydratedFieldValue;
 exports.resolveModelFormat = resolveModelFormat;
 exports.resolveRunnerId = resolveRunnerId;
+exports.resolveScrubThumbnailGeometry = resolveScrubThumbnailGeometry;
 exports.resolveVariantModelId = resolveVariantModelId;
 exports.runInferenceStep = runInferenceStep;
 exports.runtimeDevices = runtimeDevices;