@camstack/types 1.1.49 → 1.1.50

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BfvNtyu8.js");
+const require_sleep = require("./sleep-CF-UWPp0.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");
@@ -1048,6 +1048,71 @@ function migrateConfigToBands(config) {
 	return schedules.map((schedule) => bandFromSchedule(schedule, bandMode, config));
 }
 //#endregion
+//#region src/interfaces/ops-log.ts
+/**
+* Ops-log — the durable, append-only operations audit shared by the
+* recordings and events management surfaces.
+*
+* ONE row shape is reused for both domains so a single "Activity" view can
+* merge the recorder's DurableState ring (recordings ops-log) and the
+* pipeline-analytics SQLite collection (events ops-log). Each row records a
+* management operation, WHY it ran (reason), and its measurable effect
+* (itemsAffected + bytesReclaimed). Writes are best-effort — a failed log must
+* never fail the operation it records.
+*/
+/** Which management domain the operation belongs to. */
+var OpsLogDomainSchema = zod.z.enum(["recording", "events"]);
+/** The kind of management operation performed. */
+var OpsLogOpSchema = zod.z.enum([
+	"prune",
+	"manual-delete",
+	"rescan",
+	"retention-run"
+]);
+/** Why the operation ran. */
+var OpsLogReasonSchema = zod.z.enum([
+	"retention",
+	"quota",
+	"manual",
+	"operator"
+]);
+/** One audit row, shared verbatim by both domains. */
+var OpsLogEntrySchema = zod.z.object({
+	/** Unique row id. */
+	id: zod.z.string(),
+	/** Epoch ms the operation completed. */
+	at: zod.z.number(),
+	domain: OpsLogDomainSchema,
+	op: OpsLogOpSchema,
+	reason: OpsLogReasonSchema,
+	/** The camera the op targeted; null for a cluster/global op. */
+	deviceId: zod.z.number().nullable(),
+	/** Node that performed the op (the log carries nodeId — no cross-node aggregation). */
+	nodeId: zod.z.string(),
+	/** Buckets / rows deleted (op-specific unit). */
+	itemsAffected: zod.z.number(),
+	/** Bytes reclaimed by the op (0 when not measurable). */
+	bytesReclaimed: zod.z.number(),
+	/** Free-text detail (e.g. "floor moved to <ts>"); null when none. */
+	detail: zod.z.string().nullable(),
+	/** Who/what triggered the op. */
+	actor: zod.z.string()
+});
+/** Shared query input for the per-domain `listOpsLog` cap methods. */
+var OpsLogQueryInputSchema = zod.z.object({
+	/** Restrict to a single camera; omit for every row. */
+	deviceId: zod.z.number().optional(),
+	/** Max rows returned, newest-first. */
+	limit: zod.z.number().int().min(1).max(1e3).optional()
+});
+/**
+* Default cap on the recorder's DurableState ops-log ring — the newest N rows
+* survive; older ones are evicted on append.
+*/
+var OPS_LOG_RING_DEFAULT_MAX = 500;
+/** Default page size for a `listOpsLog` query when the caller omits `limit`. */
+var OPS_LOG_DEFAULT_LIMIT = 200;
+//#endregion
 //#region src/interfaces/storage-location.ts
 /**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
@@ -11066,9 +11131,10 @@ var zoneRulesCapability = {
 	* `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 `[]`).
+	* The orchestrator provider writes this stage as a first-class slice
+	* (Phase 4): every mutation mirrors the full `{motion, detection,
+	* package}` shape, so consumers read the current package rules directly
+	* off `device.state.zoneRules.value.package`.
 	*/
 	runtimeState: zod.z.object({
 		motion: zod.z.array(ZoneRuleSchema).readonly(),
@@ -13073,7 +13139,10 @@ function createSystemProxy(api) {
 			assignPlates: (input) => dispatch("plateGallery", "assignPlates", "mutation", input),
 			unassignPlates: (input) => dispatch("plateGallery", "unassignPlates", "mutation", input)
 		},
-		recording: { getStorageUsage: (input) => dispatch("recording", "getStorageUsage", "query", input) },
+		recording: {
+			getStorageUsage: (input) => dispatch("recording", "getStorageUsage", "query", input),
+			listOpsLog: (input) => dispatch("recording", "listOpsLog", "query", input)
+		},
 		recordingExport: {
 			getExport: (input) => dispatch("recordingExport", "getExport", "query", input),
 			cancelExport: (input) => dispatch("recordingExport", "cancelExport", "mutation", input),
@@ -18694,6 +18763,26 @@ var TrackCascadeCountsSchema = zod.z.object({
 	/** Per-track CLIP search vectors removed (best-effort). */
 	embeddings: zod.z.number().int()
 });
+/** Event-store footprint for one camera. */
+var EventStoreDeviceFootprintSchema = zod.z.object({
+	deviceId: zod.z.number(),
+	/** Persisted event rows (motion + object + audio) for the camera. */
+	rows: zod.z.number().int(),
+	/** Event-owned media bytes on disk for the camera. */
+	bytes: zod.z.number().int()
+});
+/** Aggregate event-store footprint: global totals + per-camera breakdown. */
+var EventStoreFootprintSchema = zod.z.object({
+	totalRows: zod.z.number().int(),
+	totalBytes: zod.z.number().int(),
+	devices: zod.z.array(EventStoreDeviceFootprintSchema).readonly()
+});
+/** Per-kind counts returned by the event-prune / device-delete mutations. */
+var EventPruneCountsSchema = zod.z.object({
+	motion: zod.z.number().int(),
+	object: zod.z.number().int(),
+	audio: zod.z.number().int()
+});
 var pipelineAnalyticsCapability = {
 	name: "pipeline-analytics",
 	scope: "device",
@@ -18855,6 +18944,45 @@ var pipelineAnalyticsCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Durable event-store footprint for the management UI: event rows
+		* (motion + object + audio) counted per camera + total, plus the
+		* event-owned media bytes on disk per camera + total. Stat/count-based,
+		* computed on demand.
+		*/
+		getEventStoreFootprint: require_sleep.method(zod.z.object({}), EventStoreFootprintSchema, {
+			kind: "query",
+			auth: "admin"
+		}),
+		/**
+		* Cluster-wide prune of events older than `olderThanMs` (exclusive) across
+		* every camera, deleting each event's media in lockstep. Logged to the
+		* events ops-log with `reason` (default `'retention'`). Returns the summed
+		* per-kind deleted counts.
+		*/
+		pruneEvents: require_sleep.method(zod.z.object({
+			olderThanMs: zod.z.number(),
+			reason: OpsLogReasonSchema.optional()
+		}), EventPruneCountsSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
+		* Manually delete EVERY event (motion + object + audio) for one camera and
+		* its event-owned media in lockstep. Logged to the events ops-log as
+		* `op:'manual-delete', reason:'manual'`. Destructive — the admin UI guards
+		* it behind a confirm.
+		*/
+		deleteDeviceEvents: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), EventPruneCountsSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** The events ops-log rows (newest-first), optionally scoped to one camera.
+		*  Backed by a declared pipeline-analytics SQLite collection. */
+		listOpsLog: require_sleep.method(OpsLogQueryInputSchema, zod.z.array(OpsLogEntrySchema).readonly(), {
+			kind: "query",
+			auth: "admin"
+		}),
 		getEventMedia: require_sleep.method(zod.z.object({
 			eventId: zod.z.string(),
 			kind: MediaFileKindEnum.optional()
@@ -23592,14 +23720,43 @@ var recordingCapability = {
 			auth: "admin"
 		}),
 		/** Apply this device's retention policy to footage now; returns the oldest
-		*  surviving footage start (the retention floor) or null if no footage. */
-		pruneFootage: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
+		*  surviving footage start (the retention floor) or null if no footage. The
+		*  prune is logged to the recordings ops-log with `reason` (default
+		*  `'retention'` — the policy-driven prune; `'quota'` when disk-pressure
+		*  triggered). */
+		pruneFootage: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			reason: OpsLogReasonSchema.optional()
+		}), zod.z.object({
 			floorMs: zod.z.number().nullable(),
 			deletedBuckets: zod.z.number().int(),
 			reclaimedBytes: zod.z.number().int()
 		}), {
 			kind: "mutation",
 			auth: "admin"
+		}),
+		/**
+		* Manually delete a camera's footage — the whole footprint, or a
+		* `[fromMs, toMs)` window when either bound is given. Logged to the
+		* recordings ops-log as `op:'manual-delete', reason:'manual'`. Destructive:
+		* the admin UI guards it behind a confirm.
+		*/
+		deleteFootprint: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			fromMs: zod.z.number().optional(),
+			toMs: zod.z.number().optional()
+		}), zod.z.object({
+			deletedBuckets: zod.z.number().int(),
+			reclaimedBytes: zod.z.number().int()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** The recordings ops-log rows (newest-first), optionally scoped to one
+		*  camera. Backed by the recorder's bounded DurableState ring. */
+		listOpsLog: require_sleep.method(OpsLogQueryInputSchema, zod.z.array(OpsLogEntrySchema).readonly(), {
+			kind: "query",
+			auth: "admin"
 		})
 	}
 };
@@ -28062,6 +28219,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"pipelineAnalytics.deleteDeviceEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "delete"
+	},
 	"pipelineAnalytics.deleteTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28092,6 +28255,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getEventStoreFootprint": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getKeyEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28134,6 +28303,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listOpsLog": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listRecentTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28146,6 +28321,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.pruneEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.pruneEventsBefore": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28908,6 +29089,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"recording.deleteFootprint": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"recording.getAvailability": {
 		capName: "recording",
 		capScope: "system",
@@ -28938,6 +29125,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"recording.listOpsLog": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"recording.locateSegment": {
 		capName: "recording",
 		capScope: "system",
@@ -31303,8 +31496,15 @@ exports.NotificationRuleSchema = NotificationRuleSchema;
 exports.NotificationSchema = NotificationSchema;
 exports.NotifierStatusSchema = NotifierStatusSchema;
 exports.NumericSensorStatusSchema = NumericSensorStatusSchema;
+exports.OPS_LOG_DEFAULT_LIMIT = OPS_LOG_DEFAULT_LIMIT;
+exports.OPS_LOG_RING_DEFAULT_MAX = OPS_LOG_RING_DEFAULT_MAX;
 exports.OauthIntegrationDescriptorSchema = OauthIntegrationDescriptorSchema;
 exports.ObjectEventSchema = ObjectEventSchema;
+exports.OpsLogDomainSchema = OpsLogDomainSchema;
+exports.OpsLogEntrySchema = OpsLogEntrySchema;
+exports.OpsLogOpSchema = OpsLogOpSchema;
+exports.OpsLogQueryInputSchema = OpsLogQueryInputSchema;
+exports.OpsLogReasonSchema = OpsLogReasonSchema;
 exports.OrchestratorMetricsSchema = OrchestratorMetricsSchema;
 exports.OsdOverlayKindEnum = OsdOverlayKindEnum;
 exports.OsdOverlayPatchSchema = OsdOverlayPatchSchema;