@camstack/types 1.2.134 → 1.2.136

package/dist/capabilities/recording.cap.d.ts

@@ -41,6 +41,65 @@ export declare const RecordingDaysSchema: z.ZodObject<{
     days: z.ZodArray<z.ZodNumber>;
 }, z.core.$strip>;
 export type RecordingDays = z.infer<typeof RecordingDaysSchema>;
+/**
+ * Most cameras one `getAvailabilityBatch` / `getDaysWithRecordingsBatch` may
+ * name.
+ *
+ * Matches the ceiling the per-camera batches elsewhere in the system carry
+ * (`pipelineAnalytics.getKeyEventsBatch`, `sceneMonitor.listScenesBatch`): a
+ * grid is tens of cameras, never hundreds, and each id costs the recorder one
+ * calendar walk whose answer crosses a process boundary.
+ *
+ * The ceiling is on the SCHEMA. An over-eager ask is REFUSED, never truncated
+ * to the first {@link RECORDING_TIMELINE_BATCH_MAX} ids — a truncated answer
+ * looks exactly like a complete one, and the caller would draw an empty
+ * timeline for the cameras it never learned were dropped.
+ */
+export declare const RECORDING_TIMELINE_BATCH_MAX = 200;
+/**
+ * One camera's row in a `getAvailabilityBatch` answer.
+ *
+ * `ranges` is EXACTLY what `getAvailability` returns for that camera — the
+ * batch collapses the transport, not the work — plus the one thing the singular
+ * method never had to say:
+ *
+ *  - `read: 'read'` — answered. `ranges: []` means "read, and this camera has
+ *    no footage in the window", which is a real claim.
+ *  - `read: 'unreadable'` — the recorder could not answer for this camera (its
+ *    calendar rung threw, its location is unmounted). `ranges` is empty and
+ *    that emptiness means NOTHING.
+ *
+ * A timeline that renders the second as the first tells an operator there is no
+ * footage when the truth is that nobody looked.
+ */
+export declare const RecordingAvailabilityForDeviceSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    read: z.ZodEnum<{
+        read: "read";
+        unreadable: "unreadable";
+    }>;
+    ranges: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        profile: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RecordingAvailabilityForDevice = z.infer<typeof RecordingAvailabilityForDeviceSchema>;
+/**
+ * One camera's row in a `getDaysWithRecordingsBatch` answer. Same rule as
+ * {@link RecordingAvailabilityForDeviceSchema}: `days: []` on a `'read'` row is
+ * "no footage in this month", `read: 'unreadable'` is "nobody could look", and
+ * the date-picker's day dots must not spell them the same.
+ */
+export declare const RecordingDaysForDeviceSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    read: z.ZodEnum<{
+        read: "read";
+        unreadable: "unreadable";
+    }>;
+    days: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export type RecordingDaysForDevice = z.infer<typeof RecordingDaysForDeviceSchema>;
 export declare const RecordingManifestSchema: z.ZodObject<{
     deviceId: z.ZodNumber;
     localMasterPath: z.ZodNullable<z.ZodString>;
@@ -298,6 +357,40 @@ export declare const recordingCapability: {
                 endMs: z.ZodNumber;
             }, z.core.$strip>>;
         }, z.core.$strip>, "query">;
+        /**
+         * `getAvailability` for a SET of cameras, in one round trip.
+         *
+         * A multi-camera timeline re-asks availability for every camera in the grid
+         * on every day change; fanned out that is one request per camera for N
+         * independent calendar walks. The per-camera work is IDENTICAL (the same
+         * `availabilityProfileFor` + `rangesIn`, run concurrently inside the
+         * recorder) — only the transport collapses.
+         *
+         * `protected` for the same reason the singular method is: every id in
+         * `deviceIds` is a device reference, so the F1 #3 gate refuses any camera
+         * outside the caller's scope — one id out of scope refuses the CALL, it
+         * does not quietly drop a row.
+         *
+         * Every requested id gets a row, marked — see
+         * {@link RecordingAvailabilityForDeviceSchema}. `deviceIds` is capped at
+         * {@link RECORDING_TIMELINE_BATCH_MAX} and an over-cap ask is refused.
+         */
+        readonly getAvailabilityBatch: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceIds: z.ZodArray<z.ZodNumber>;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            read: z.ZodEnum<{
+                read: "read";
+                unreadable: "unreadable";
+            }>;
+            ranges: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                profile: z.ZodString;
+                startMs: z.ZodNumber;
+                endMs: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>, "query">;
         /** Which calendar days in [fromMs,toMs) have ≥1 recorded segment, bucketed by
          *  the client's local day (`tzOffsetMinutes` = minutes to add to UTC). Drives
          *  the theater date-picker's day dots. */
@@ -310,6 +403,30 @@ export declare const recordingCapability: {
             deviceId: z.ZodNumber;
             days: z.ZodArray<z.ZodNumber>;
         }, z.core.$strip>, "query">;
+        /**
+         * `getDaysWithRecordings` for a SET of cameras, in one round trip.
+         *
+         * The cheapest question in the product, asked once per camera per month
+         * change. One directory read per day per camera at the owner, unchanged;
+         * what collapses is the N requests it took to ask.
+         *
+         * Every requested id gets a row, marked — see
+         * {@link RecordingDaysForDeviceSchema}. `deviceIds` is capped at
+         * {@link RECORDING_TIMELINE_BATCH_MAX} and an over-cap ask is refused.
+         */
+        readonly getDaysWithRecordingsBatch: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceIds: z.ZodArray<z.ZodNumber>;
+            fromMs: z.ZodNumber;
+            toMs: z.ZodNumber;
+            tzOffsetMinutes: z.ZodNumber;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            read: z.ZodEnum<{
+                read: "read";
+                unreadable: "unreadable";
+            }>;
+            days: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>>>, "query">;
         readonly getPlaybackManifest: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
             fromMs: z.ZodNumber;
@@ -546,6 +663,7 @@ export declare const recordingCapability: {
                 retention: "retention";
                 quota: "quota";
                 maintenance: "maintenance";
+                "orphaned-device": "orphaned-device";
             }>>;
         }, z.core.$strip>, z.ZodObject<{
             floorMs: z.ZodNullable<z.ZodNumber>;
@@ -592,6 +710,7 @@ export declare const recordingCapability: {
                 retention: "retention";
                 quota: "quota";
                 maintenance: "maintenance";
+                "orphaned-device": "orphaned-device";
             }>;
             deviceId: z.ZodNullable<z.ZodNumber>;
             nodeId: z.ZodString;

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

@@ -2040,6 +2040,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof deviceManagerCapability.methods.allocateDeviceId.output>;
             meta: object;
         }>;
+        migrateDevice: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceManagerCapability.methods.migrateDevice.input>;
+            output: z.infer<typeof deviceManagerCapability.methods.migrateDevice.output>;
+            meta: object;
+        }>;
         registerDevice: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -5009,6 +5016,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineAnalyticsCapability.methods.getEventDensity.output>;
             meta: object;
         }>;
+        getEventDensityBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineAnalyticsCapability.methods.getEventDensityBatch.input>;
+            output: z.infer<typeof pipelineAnalyticsCapability.methods.getEventDensityBatch.output>;
+            meta: object;
+        }>;
         pruneEventsBefore: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -6452,6 +6466,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof recordingCapability.methods.getAvailability.output>;
             meta: object;
         }>;
+        getAvailabilityBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingCapability.methods.getAvailabilityBatch.input>;
+            output: z.infer<typeof recordingCapability.methods.getAvailabilityBatch.output>;
+            meta: object;
+        }>;
         getDaysWithRecordings: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -6459,6 +6480,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof recordingCapability.methods.getDaysWithRecordings.output>;
             meta: object;
         }>;
+        getDaysWithRecordingsBatch: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingCapability.methods.getDaysWithRecordingsBatch.input>;
+            output: z.infer<typeof recordingCapability.methods.getDaysWithRecordingsBatch.output>;
+            meta: object;
+        }>;
         getPlaybackManifest: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -9769,7 +9797,11 @@ export type AppRouter = TrpcCoreRouter<{
                 nodeId: string;
             };
             output: {
-                success: boolean;
+                forgotten: boolean;
+                historyRemoved: boolean;
+                registryRemoved: boolean;
+                stillListed: boolean;
+                message: string;
             };
             meta: object;
         }>;
@@ -9788,7 +9820,11 @@ export type AppRouter = TrpcCoreRouter<{
                 nodeId: string;
             };
             output: {
-                success: boolean;
+                forgotten: boolean;
+                historyRemoved: boolean;
+                registryRemoved: boolean;
+                stillListed: boolean;
+                message: string;
             };
             meta: object;
         }>;

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: 999 method paths across 126 capabilities.
+ * Coverage: 1003 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: 351 methods carry a device reference, of which
- * 131 are on SYSTEM-scope caps.
+ * Coverage: 354 methods carry a device reference, of which
+ * 133 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

@@ -68,7 +68,7 @@ export interface SystemProxy {
     readonly decoder: Pick<InferProvider<typeof decoderCapability>, 'supportsCodec' | 'getInfo' | 'createSession' | 'destroySession' | 'pushPacket' | 'openStream' | 'pullFrames' | 'pullHandles' | 'getFrame' | 'getShmStats' | 'updateConfig' | 'getStats' | 'listActiveSessions' | 'reprobeHwaccel'>;
     readonly deviceAdoption: Pick<InferProvider<typeof deviceAdoptionCapability>, 'listCandidateFilters' | 'listCandidates' | 'getCandidate' | 'refresh' | 'adopt' | 'release' | 'resync'>;
     readonly deviceExport: Pick<InferProvider<typeof deviceExportCapability>, 'getStatus' | 'listSupportedDeviceKinds' | 'listExposedDevices' | 'exposeDevice' | 'unexposeDevice'>;
-    readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'renameLocation' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'getChildrenBatch' | 'getLinkedDevicesBatch' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
+    readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'migrateDevice' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'renameLocation' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'getChildrenBatch' | 'getLinkedDevicesBatch' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
     readonly deviceProvider: Pick<InferProvider<typeof deviceProviderCapability>, 'start' | 'stop' | 'getStatus' | 'getDevices' | 'supportsDiscovery' | 'discoverDevices' | 'getDiscoveryParamsSchema' | 'getManualCreationType' | 'adoptDiscoveredDevice' | 'supportsManualCreation' | 'getChildCreationSchema' | 'createDevice' | 'testCreationField'>;
     readonly deviceState: Pick<InferProvider<typeof deviceStateCapability>, 'getAllSnapshots'>;
     readonly faceGallery: Pick<InferProvider<typeof faceGalleryCapability>, 'listIdentities' | 'createIdentity' | 'renameIdentity' | 'deleteIdentity' | 'listIdentitySamples' | 'removeSample' | 'getFaceMedia' | 'assignFace' | 'unassignFace' | 'deleteFace' | 'assignFaces' | 'unassignFaces' | 'suggestFaceClusters'>;
@@ -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' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;
+    readonly recording: Pick<InferProvider<typeof recordingCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;
     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'>;