@camstack/types 1.1.48 → 1.1.49

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BoTIF1d4.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");
@@ -2271,6 +2271,10 @@ var MACRO_LABELS = [
 	{
 		id: "animal",
 		name: "Animal"
+	},
+	{
+		id: "package",
+		name: "Package"
 	}
 ];
 var COCO_TO_MACRO = {
@@ -2293,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
 };
@@ -11001,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.
@@ -11045,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
@@ -13055,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),
@@ -18319,6 +18344,7 @@ var EventKindIconSchema = zod.z.enum([
 	"smoke",
 	"water",
 	"button",
+	"package",
 	"generic"
 ]);
 var EventKindCategorySchema = zod.z.enum([
@@ -18326,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'). */
@@ -23577,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
@@ -24368,6 +24516,7 @@ var CAPABILITY_NAMES = {
 	ptzAutotrack: "ptz-autotrack",
 	reboot: "reboot",
 	recording: "recording",
+	recordingExport: "recordingExport",
 	sceneMonitor: "scene-monitor",
 	scriptRunner: "script-runner",
 	serverManagement: "server-management",
@@ -24833,6 +24982,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "recording",
 		name: "recording"
 	},
+	{
+		key: "recordingExport",
+		name: "recordingExport"
+	},
 	{
 		key: "sceneMonitor",
 		name: "scene-monitor"
@@ -25087,6 +25240,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	ptzAutotrackCapability,
 	rebootCapability,
 	recordingCapability,
+	recordingExportCapability,
 	sceneMonitorCapability,
 	scriptRunnerCapability,
 	serverManagementCapability,
@@ -28814,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",
@@ -30025,6 +30215,7 @@ var KNOWN_CAP_NAMES = [
 	"ptz-autotrack",
 	"reboot",
 	"recording",
+	"recordingExport",
 	"scene-monitor",
 	"script-runner",
 	"server-management",
@@ -30161,6 +30352,7 @@ var SYSTEM_CAP_NAMES = [
 	"plate-gallery",
 	"platform-probe",
 	"recording",
+	"recordingExport",
 	"server-management",
 	"settings-store",
 	"smtp-provider",
@@ -30970,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;
@@ -31549,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;