@camstack/types 1.1.49 → 1.1.51

package/dist/interfaces/config-ui.d.ts

@@ -80,7 +80,7 @@ export interface ConfigSection {
     readonly immediate?: boolean;
     readonly fields: readonly ConfigField[];
 }
-export type ConfigField = ConfigTextField | ConfigNumberField | ConfigBooleanField | ConfigSelectField | ConfigMultiSelectField | ConfigTimezoneField | ConfigDateTimeField | ConfigColorField | ConfigPasswordField | ConfigTextAreaField | ConfigSliderField | ConfigTagsField | ConfigGroupField | ConfigSubTabsField | ConfigSeparatorField | ConfigInfoField | ConfigQrCodeField | ConfigObjectArrayField | ConfigEditableArrayField | ConfigModelSelectorField | ConfigStorageLocationField | ConfigProbeField | ConfigButtonField | ConfigPipelineEditorField | ConfigNodeSelectField | ConfigNodeMultiSelectField | ConfigWidgetField | ConfigAddonActionSelectField | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;
+export type ConfigField = ConfigTextField | ConfigNumberField | ConfigBooleanField | ConfigSelectField | ConfigMultiSelectField | ConfigTimezoneField | ConfigDateTimeField | ConfigColorField | ConfigPasswordField | ConfigTextAreaField | ConfigSliderField | ConfigTagsField | ConfigGroupField | ConfigSubTabsField | ConfigSeparatorField | ConfigInfoField | ConfigQrCodeField | ConfigObjectArrayField | ConfigEditableArrayField | ConfigModelSelectorField | ConfigStorageLocationField | ConfigProbeField | ConfigButtonField | ConfigPipelineEditorField | ConfigNodeSelectField | ConfigNodeMultiSelectField | ConfigDeviceSelectField | ConfigDeviceMultiSelectField | ConfigWidgetField | ConfigAddonActionSelectField | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;
 export interface ConfigFieldBase {
     readonly key: string;
     readonly label: string;
@@ -319,6 +319,48 @@ export interface ConfigNodeMultiSelectField extends ConfigFieldBase {
     showOffline?: boolean;
     maxItems?: number;
 }
+/**
+ * Declarative, client-evaluated filter for `device-select` /
+ * `device-multiselect`. The field carries ONLY this filter — the renderer
+ * lists every system device (`deviceManager.listAll`) and narrows the
+ * options CLIENT-SIDE. There is deliberately NO server-computed option
+ * list (that path depended on `deviceManager.getAllBindings`, which returns
+ * an empty set on the live cluster and left pickers blank).
+ *
+ * Match rule (union — a device is kept when ANY provided clause matches;
+ * an absent/empty filter matches every device):
+ *   - `caps`  → the device's advertised `features` intersect this list.
+ *   - `types` → the device's `type` is one of these.
+ * `excludeDeviceId` is always subtracted last (typically the device whose
+ * settings host the field — e.g. a camera must not list itself as a source).
+ */
+export interface DeviceSelectFilter {
+    /** Keep devices whose `features` intersect ANY of these capability names. */
+    readonly caps?: readonly string[];
+    /** Keep devices whose `type` is one of these `DeviceType` strings. */
+    readonly types?: readonly string[];
+    /** Always drop this device id from the options (e.g. the host device). */
+    readonly excludeDeviceId?: number;
+}
+/**
+ * Pick a SINGLE device from the live device catalogue. Options are the
+ * result of `deviceManager.listAll` filtered client-side by `deviceFilter`.
+ * Stored value is the chosen device id as a string.
+ */
+export interface ConfigDeviceSelectField extends ConfigFieldBase {
+    type: 'device-select';
+    deviceFilter?: DeviceSelectFilter;
+}
+/**
+ * Pick MULTIPLE devices from the live device catalogue — the searchable
+ * sibling of `device-select` (same client-side `deviceFilter`). Stored
+ * value is a `string[]` of device ids.
+ */
+export interface ConfigDeviceMultiSelectField extends ConfigFieldBase {
+    type: 'device-multiselect';
+    deviceFilter?: DeviceSelectFilter;
+    maxItems?: number;
+}
 export interface ConfigPasswordField extends ConfigFieldBase {
     type: 'password';
     showToggle?: boolean;
@@ -801,6 +843,10 @@ export type ConfigFieldWithValue = (ConfigTextField & {
     readonly value: unknown;
 }) | (ConfigNodeMultiSelectField & {
     readonly value: unknown;
+}) | (ConfigDeviceSelectField & {
+    readonly value: unknown;
+}) | (ConfigDeviceMultiSelectField & {
+    readonly value: unknown;
 }) | ConfigWidgetField | (ConfigAddonActionSelectField & {
     readonly value: unknown;
 }) | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;

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-BfvNtyu8.js → sleep-CF-UWPp0.js}

@@ -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,6 +3225,7 @@ 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),

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

@@ -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,6 +3225,7 @@ 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),

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.49",
+  "version": "1.1.51",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",