@camstack/types 1.1.48 → 1.1.50

package/dist/interfaces/event-bus.d.ts

@@ -221,6 +221,48 @@ export interface PipelineAnalyticsPlateGalleryChangedPayload {
     readonly kind: 'buffered' | 'assigned' | 'unassigned' | 'deleted';
     readonly [key: string]: unknown;
 }
+/**
+ * Emitted by `addon-post-analysis` when a package-drop is confirmed — a
+ * newly-appeared stationary object of a package class that cleared the
+ * class / zone / dwell / size gates inside a package zone. Telemetry (D8):
+ * the durable record is the `package-events` store row; this drives
+ * notifier rules + live UI. See
+ * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
+ */
+export interface PipelineAnalyticsPackageDeliveredPayload {
+    readonly deviceId: number;
+    /** Stationary-registry entry id the delivery is paired to. */
+    readonly entryId: string;
+    /** Persisted `package-events` row id for this delivery. */
+    readonly eventId: string;
+    readonly className: string;
+    /** Package-zone ids the entry's centroid fell inside. */
+    readonly zoneIds: readonly string[];
+    /** Native-res key-frame crop key (resolve via the event-media plane). */
+    readonly keyFrameMediaKey?: string;
+    readonly bbox: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+    readonly timestamp: number;
+    readonly [key: string]: unknown;
+}
+/**
+ * Emitted by `addon-post-analysis` when a previously-delivered package
+ * leaves its zone (its stationary entry departed — moved or TTL-swept).
+ * Telemetry (D8). See package-zones-design §5.2.
+ */
+export interface PipelineAnalyticsPackagePickedUpPayload {
+    readonly deviceId: number;
+    readonly entryId: string;
+    /** The `package-events` delivery row this pick-up pairs to. */
+    readonly deliveredEventId: string;
+    readonly className: string;
+    readonly timestamp: number;
+    readonly [key: string]: unknown;
+}
 /**
  * Child steps enabled for a camera + their scheduling policy, as read
  * from the pipeline catalog. Announced on `PipelineInferenceResultPayload`
@@ -723,6 +765,8 @@ export interface EventCatalog {
     'pipeline-analytics.track-lifecycle': PipelineAnalyticsTrackLifecyclePayload;
     'pipeline-analytics.face-gallery-changed': PipelineAnalyticsFaceGalleryChangedPayload;
     'pipeline-analytics.plate-gallery-changed': PipelineAnalyticsPlateGalleryChangedPayload;
+    'pipeline-analytics.package-delivered': PipelineAnalyticsPackageDeliveredPayload;
+    'pipeline-analytics.package-picked-up': PipelineAnalyticsPackagePickedUpPayload;
     /**
      * On-board detection coming straight from the camera firmware (Reolink
      * AI alarms, ONVIF analytics, etc.) — as opposed to `detection.result`

package/dist/interfaces/ops-log.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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.
+ */
+import { z } from 'zod';
+/** Which management domain the operation belongs to. */
+export declare const OpsLogDomainSchema: z.ZodEnum<{
+    events: "events";
+    recording: "recording";
+}>;
+export type OpsLogDomain = z.infer<typeof OpsLogDomainSchema>;
+/** The kind of management operation performed. */
+export declare const OpsLogOpSchema: z.ZodEnum<{
+    prune: "prune";
+    "manual-delete": "manual-delete";
+    rescan: "rescan";
+    "retention-run": "retention-run";
+}>;
+export type OpsLogOp = z.infer<typeof OpsLogOpSchema>;
+/** Why the operation ran. */
+export declare const OpsLogReasonSchema: z.ZodEnum<{
+    manual: "manual";
+    retention: "retention";
+    quota: "quota";
+    operator: "operator";
+}>;
+export type OpsLogReason = z.infer<typeof OpsLogReasonSchema>;
+/** One audit row, shared verbatim by both domains. */
+export declare const OpsLogEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodNumber;
+    domain: z.ZodEnum<{
+        events: "events";
+        recording: "recording";
+    }>;
+    op: z.ZodEnum<{
+        prune: "prune";
+        "manual-delete": "manual-delete";
+        rescan: "rescan";
+        "retention-run": "retention-run";
+    }>;
+    reason: z.ZodEnum<{
+        manual: "manual";
+        retention: "retention";
+        quota: "quota";
+        operator: "operator";
+    }>;
+    deviceId: z.ZodNullable<z.ZodNumber>;
+    nodeId: z.ZodString;
+    itemsAffected: z.ZodNumber;
+    bytesReclaimed: z.ZodNumber;
+    detail: z.ZodNullable<z.ZodString>;
+    actor: z.ZodString;
+}, z.core.$strip>;
+export type OpsLogEntry = z.infer<typeof OpsLogEntrySchema>;
+/** Shared query input for the per-domain `listOpsLog` cap methods. */
+export declare const OpsLogQueryInputSchema: z.ZodObject<{
+    deviceId: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type OpsLogQueryInput = z.infer<typeof OpsLogQueryInputSchema>;
+/**
+ * Default cap on the recorder's DurableState ops-log ring — the newest N rows
+ * survive; older ones are evicted on append.
+ */
+export declare const OPS_LOG_RING_DEFAULT_MAX = 500;
+/** Default page size for a `listOpsLog` query when the caller omits `limit`. */
+export declare const OPS_LOG_DEFAULT_LIMIT = 200;

package/dist/{sleep-BoTIF1d4.js → sleep-CF-UWPp0.js}

@@ -1,4 +1,4 @@
-const require_event_category = require("./event-category-AkBNxg_X.js");
+const require_event_category = require("./event-category-CGj9fI4L.js");
 let zod = require("zod");
 //#region src/disposer-chain.ts
 var DisposerChain = class {
@@ -2975,6 +2975,10 @@ function createDeviceProxy(api, binding, opts) {
 			pruneTracksBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneTracksBefore", "mutation", input),
 			wipeAllAnalytics: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "wipeAllAnalytics", "mutation", input),
 			deleteTracks: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deleteTracks", "mutation", input),
+			getEventStoreFootprint: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventStoreFootprint", "query", input),
+			pruneEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneEvents", "mutation", input),
+			deleteDeviceEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deleteDeviceEvents", "mutation", input),
+			listOpsLog: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listOpsLog", "query", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 			getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 			searchObjectEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "searchObjectEvents", "query", input),
@@ -3221,11 +3225,16 @@ function createDeviceProxy(api, binding, opts) {
 			setDeviceConfig: (input) => dispatchSystem("recording", "setDeviceConfig", "mutation", input),
 			rescanStorage: (input) => dispatchSystem("recording", "rescanStorage", "mutation", input),
 			pruneFootage: (input) => dispatchSystem("recording", "pruneFootage", "mutation", input),
+			deleteFootprint: (input) => dispatchSystem("recording", "deleteFootprint", "mutation", input),
 			getStatus: (input) => dispatchSystem("recording", "getStatus", "query", input),
 			getDeviceSettingsContribution: (input) => dispatchSystem("recording", "getDeviceSettingsContribution", "query", input),
 			getDeviceLiveContribution: (input) => dispatchSystem("recording", "getDeviceLiveContribution", "query", input),
 			applyDeviceSettingsPatch: (input) => dispatchSystem("recording", "applyDeviceSettingsPatch", "mutation", input)
 		},
+		recordingExport: {
+			createExport: (input) => dispatchSystem("recordingExport", "createExport", "mutation", input),
+			listExports: (input) => dispatchSystem("recordingExport", "listExports", "query", input)
+		},
 		streamBroker: {
 			publishCameraStream: (input) => dispatchSystem("streamBroker", "publishCameraStream", "mutation", input),
 			retractCameraStream: (input) => dispatchSystem("streamBroker", "retractCameraStream", "mutation", input),

package/dist/{sleep-B3OHhFkL.mjs → sleep-D8ZkNoYz.mjs}

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-H4AVePnn.mjs";
+import { t as EventCategory } from "./event-category-D4HJq7Mw.mjs";
 import { z } from "zod";
 //#region src/disposer-chain.ts
 var DisposerChain = class {
@@ -2975,6 +2975,10 @@ function createDeviceProxy(api, binding, opts) {
 			pruneTracksBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneTracksBefore", "mutation", input),
 			wipeAllAnalytics: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "wipeAllAnalytics", "mutation", input),
 			deleteTracks: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deleteTracks", "mutation", input),
+			getEventStoreFootprint: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventStoreFootprint", "query", input),
+			pruneEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneEvents", "mutation", input),
+			deleteDeviceEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deleteDeviceEvents", "mutation", input),
+			listOpsLog: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listOpsLog", "query", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 			getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 			searchObjectEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "searchObjectEvents", "query", input),
@@ -3221,11 +3225,16 @@ function createDeviceProxy(api, binding, opts) {
 			setDeviceConfig: (input) => dispatchSystem("recording", "setDeviceConfig", "mutation", input),
 			rescanStorage: (input) => dispatchSystem("recording", "rescanStorage", "mutation", input),
 			pruneFootage: (input) => dispatchSystem("recording", "pruneFootage", "mutation", input),
+			deleteFootprint: (input) => dispatchSystem("recording", "deleteFootprint", "mutation", input),
 			getStatus: (input) => dispatchSystem("recording", "getStatus", "query", input),
 			getDeviceSettingsContribution: (input) => dispatchSystem("recording", "getDeviceSettingsContribution", "query", input),
 			getDeviceLiveContribution: (input) => dispatchSystem("recording", "getDeviceLiveContribution", "query", input),
 			applyDeviceSettingsPatch: (input) => dispatchSystem("recording", "applyDeviceSettingsPatch", "mutation", input)
 		},
+		recordingExport: {
+			createExport: (input) => dispatchSystem("recordingExport", "createExport", "mutation", input),
+			listExports: (input) => dispatchSystem("recordingExport", "listExports", "query", input)
+		},
 		streamBroker: {
 			publishCameraStream: (input) => dispatchSystem("streamBroker", "publishCameraStream", "mutation", input),
 			retractCameraStream: (input) => dispatchSystem("streamBroker", "retractCameraStream", "mutation", input),

package/dist/types/pipeline-step.d.ts

@@ -22,8 +22,22 @@ export interface StepDefinition {
     readonly slot: PipelineSlot;
     /** Which postprocessor to apply to raw model output */
     readonly postprocessor: PostprocessorType;
-    /** How this step receives its input */
-    readonly extractMode: 'full-frame' | 'crop-roi';
+    /**
+     * How this step receives its input:
+     * - `full-frame` — the whole frame (root detectors like object-detection).
+     * - `crop-roi` — a crop of a PARENT detection's bbox (child steps like
+     *   face-detection, plate-detection, classifiers).
+     * - `crop-zone` — a crop of the device's own `package`-stage zone-rules
+     *   polygons (+ upscale for small-parcel recall), NOT a parent detection.
+     *   A ROOT-plane detector (`inputClasses === null`) that makes the drawn
+     *   package zones its inference input instead of the full frame. Used by the
+     *   `package-detection` step (design ADDENDUM). NOTE: the frame-preparation
+     *   for `crop-zone` (zone-bbox crop + upscale + bbox re-projection back to
+     *   full-frame coords) is a pipeline-runner concern that is NOT yet
+     *   implemented — a `crop-zone` root currently runs full-frame until that
+     *   plumbing lands (see step-definitions.ts STEP_PACKAGE_DETECTION).
+     */
+    readonly extractMode: 'full-frame' | 'crop-roi' | 'crop-zone';
     /** Classes this step accepts from a parent detector (null = root, accepts full frame) */
     readonly inputClasses: readonly string[] | null;
     /** Classes this step outputs (e.g., ['person','vehicle','animal'] for YOLO) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.1.48",
+  "version": "1.1.50",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",