@camstack/types 1.2.129 → 1.2.130

package/dist/capabilities/zone-analytics.cap.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { type InferProvider } from './capability-definition.js';
 import { DeviceType } from '../device/device-type.js';
+import { type InferProvider } from './capability-definition.js';
 /**
  * Per-zone occupancy aggregation produced by the analytics frame
  * processor on every inference result. Covers the full combinatorial
@@ -93,6 +93,67 @@ export declare const CameraOccupancySnapshotSchema: z.ZodObject<{
     }, z.core.$strip>>>>;
 }, z.core.$strip>;
 export type CameraOccupancySnapshot = z.infer<typeof CameraOccupancySnapshotSchema>;
+/**
+ * One camera's row in a `getCurrentSnapshotBatch` answer.
+ *
+ * THREE outcomes, and the single-camera method could only express two of them
+ * because `snapshot: null` was already spoken for:
+ *
+ *  - `read: 'read'`, `snapshot` present — the live occupancy reading.
+ *  - `read: 'read'`, `snapshot: null`   — read, and this camera has no reading
+ *    yet: no frame since boot, and no parked-object registry to hydrate from.
+ *  - `read: 'unreadable'`               — the owner could not answer for this
+ *    camera. `snapshot` is null, and it does NOT mean "nothing parked here".
+ *
+ * Collapsing the last two is the failure this field exists to prevent: a
+ * hydration that threw would otherwise render as an empty Stationary section,
+ * which is a definite claim about a camera nobody could read.
+ */
+export declare const CameraOccupancySnapshotForDeviceSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    read: z.ZodEnum<{
+        read: "read";
+        unreadable: "unreadable";
+    }>;
+    snapshot: z.ZodNullable<z.ZodObject<{
+        ts: z.ZodNumber;
+        frameWidth: z.ZodNumber;
+        frameHeight: z.ZodNumber;
+        zones: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            totalObjects: z.ZodNumber;
+            byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            zoneId: z.ZodString;
+            zoneName: z.ZodString;
+            trackIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        frame: z.ZodObject<{
+            totalObjects: z.ZodNumber;
+            byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        }, z.core.$strip>;
+        unzoned: z.ZodObject<{
+            totalObjects: z.ZodNumber;
+            byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        }, z.core.$strip>;
+        stationaryObjects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            className: z.ZodString;
+            bbox: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>;
+            frameWidth: z.ZodNumber;
+            frameHeight: z.ZodNumber;
+            firstSeenAt: z.ZodNumber;
+            becameStationaryAt: z.ZodNumber;
+            lastConfirmedAt: z.ZodNumber;
+            label: z.ZodOptional<z.ZodString>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CameraOccupancySnapshotForDevice = z.infer<typeof CameraOccupancySnapshotForDeviceSchema>;
 export type ZoneScopeBreakdown = z.infer<typeof ZoneScopeBreakdownSchema>;
 export type PerScopeBreakdown = z.infer<typeof PerScopeBreakdownSchema>;
 /**
@@ -192,6 +253,65 @@ export declare const zoneAnalyticsCapability: {
                 keyFrameMediaKey: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * The same snapshot, for a SET of cameras, in one round trip.
+         *
+         * The Events page's Stationary section polls this every 15s for every
+         * selected camera. Fanned out client-side that is one query per camera to
+         * read a `Map.get` at the owner — the answer costs nothing, the round trip
+         * costs everything. Batched, N transports become one and the per-device
+         * work is unchanged.
+         *
+         * Every requested deviceId gets a row, tagged `read` — see
+         * {@link CameraOccupancySnapshotForDeviceSchema}. A camera the owner could
+         * not answer for is `'unreadable'`, never an empty reading.
+         */
+        readonly getCurrentSnapshotBatch: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceIds: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            read: z.ZodEnum<{
+                read: "read";
+                unreadable: "unreadable";
+            }>;
+            snapshot: z.ZodNullable<z.ZodObject<{
+                ts: z.ZodNumber;
+                frameWidth: z.ZodNumber;
+                frameHeight: z.ZodNumber;
+                zones: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    totalObjects: z.ZodNumber;
+                    byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                    zoneId: z.ZodString;
+                    zoneName: z.ZodString;
+                    trackIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>>;
+                frame: z.ZodObject<{
+                    totalObjects: z.ZodNumber;
+                    byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                }, z.core.$strip>;
+                unzoned: z.ZodObject<{
+                    totalObjects: z.ZodNumber;
+                    byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                }, z.core.$strip>;
+                stationaryObjects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    className: z.ZodString;
+                    bbox: z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$strip>;
+                    frameWidth: z.ZodNumber;
+                    frameHeight: z.ZodNumber;
+                    firstSeenAt: z.ZodNumber;
+                    becameStationaryAt: z.ZodNumber;
+                    lastConfirmedAt: z.ZodNumber;
+                    label: z.ZodOptional<z.ZodString>;
+                    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Time-series object count inside one zone. `className` optional —
          *  omit to count every class in the zone. */
         readonly getZoneHistory: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -293,4 +413,4 @@ export declare const zoneAnalyticsCapability: {
     readonly durability: "session";
 };
 export type IZoneAnalyticsProvider = InferProvider<typeof zoneAnalyticsCapability>;
-export { CameraOccupancySnapshotSchema as _CameraOccupancySnapshotSchema, StationaryObjectSchema, HistoryResolutionEnum, HistoryPointSchema, HistoryRangeSchema, ZoneScopeBreakdownSchema, PerScopeBreakdownSchema, };
+export { CameraOccupancySnapshotSchema as _CameraOccupancySnapshotSchema, HistoryPointSchema, HistoryRangeSchema, HistoryResolutionEnum, PerScopeBreakdownSchema, StationaryObjectSchema, ZoneScopeBreakdownSchema, };

package/dist/generated/addon-api.d.ts

@@ -5002,6 +5002,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineAnalyticsCapability.methods.getKeyEvents.output>;
             meta: object;
         }>;
+        getKeyEventsBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineAnalyticsCapability.methods.getKeyEventsBatch.input>;
+            output: z.infer<typeof pipelineAnalyticsCapability.methods.getKeyEventsBatch.output>;
+            meta: object;
+        }>;
         getEventDensity: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -6606,6 +6613,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof recordingCapability.methods.getRelocateResidue.output>;
             meta: object;
         }>;
+        reconcileLedgerAgainstDisk: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingCapability.methods.reconcileLedgerAgainstDisk.input>;
+            output: z.infer<typeof recordingCapability.methods.reconcileLedgerAgainstDisk.output>;
+            meta: object;
+        }>;
         cancelRelocateJob: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -6704,6 +6718,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof sceneMonitorCapability.methods.listScenes.output>;
             meta: object;
         }>;
+        listScenesBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof sceneMonitorCapability.methods.listScenesBatch.input>;
+            output: z.infer<typeof sceneMonitorCapability.methods.listScenesBatch.output>;
+            meta: object;
+        }>;
         createScene: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -8676,6 +8697,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof zoneAnalyticsCapability.methods.getCurrentSnapshot.output>;
             meta: object;
         }>;
+        getCurrentSnapshotBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof zoneAnalyticsCapability.methods.getCurrentSnapshotBatch.input>;
+            output: z.infer<typeof zoneAnalyticsCapability.methods.getCurrentSnapshotBatch.output>;
+            meta: object;
+        }>;
         getZoneHistory: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;

package/dist/generated/cap-input-defaults.d.ts

@@ -11,7 +11,7 @@
  * Plain data, zero Zod: a forked runner must not import the schema barrel
  * (~144MB RSS per runner — D28).
  *
- * Coverage: 24 caps, 54 methods with defaults.
+ * Coverage: 24 caps, 55 methods with defaults.
  */
 export declare const CAP_INPUT_DEFAULTS: Readonly<Record<string, Readonly<Record<string, Readonly<Record<string, unknown>>>>>>;
 /**

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 988 method paths across 126 capabilities.
+ * Coverage: 992 method paths across 126 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,8 +6,8 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 347 methods carry a device reference, of which
- * 129 are on SYSTEM-scope caps.
+ * Coverage: 351 methods carry a device reference, of which
+ * 130 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying
  * a numeric device field (targets[].deviceId) are all mapped; the matcher

package/dist/generated/system-proxy.d.ts

@@ -87,7 +87,7 @@ export interface SystemProxy {
     readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
     readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras' | 'getNativeCrop' | 'runStatelessStep'>;
     readonly plateGallery: Pick<InferProvider<typeof plateGalleryCapability>, 'getPlateMedia' | 'searchPlates' | 'suggestPlateClusters' | 'correctPlateText' | 'deletePlate' | 'listVehicles' | 'createVehicle' | 'renameVehicle' | 'deleteVehicle' | 'listVehicleSamples' | 'removeVehicleSample' | 'assignPlate' | 'unassignPlate' | 'assignPlates' | 'unassignPlates'>;
-    readonly recording: Pick<InferProvider<typeof recordingCapability>, 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance'>;
+    readonly recording: Pick<InferProvider<typeof recordingCapability>, 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance'>;
     readonly recordingExport: Pick<InferProvider<typeof recordingExportCapability>, 'createExport' | 'getExport' | 'cancelExport' | 'deleteExport' | 'getDownloadUrl' | 'readExportBytes'>;
     readonly serverManagement: Pick<InferProvider<typeof serverManagementCapability>, 'getServerPackageStatus' | 'checkServerUpdate' | 'applyServerUpdate' | 'rollbackServerUpdate' | 'restartServer'>;
     readonly settingsStore: Pick<InferProvider<typeof settingsStoreCapability>, 'get' | 'set' | 'query' | 'insert' | 'insertMany' | 'update' | 'delete' | 'deleteWhere' | 'updateWhere' | 'count' | 'aggregate' | 'histogram' | 'isEmpty' | 'declareCollection'>;