@camstack/types 1.2.246 → 1.2.248

package/dist/generated/capability-router-map.d.ts

@@ -55,7 +55,6 @@ export { doorbellCapability } from '../capabilities/doorbell.cap.js';
 export { embeddingEncoderCapability } from '../capabilities/embedding-encoder.cap.js';
 export { enumSensorCapability } from '../capabilities/enum-sensor.cap.js';
 export { eventEmitterCapability } from '../capabilities/event-emitter.cap.js';
-export { eventsCapability } from '../capabilities/events.cap.js';
 export { faceGalleryCapability } from '../capabilities/face-gallery.cap.js';
 export { failureContributionCapability } from '../capabilities/failure-contribution.cap.js';
 export { fanControlCapability } from '../capabilities/fan-control.cap.js';
@@ -116,6 +115,7 @@ export { ptzCapability } from '../capabilities/ptz.cap.js';
 export { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 export { rebootCapability } from '../capabilities/reboot.cap.js';
 export { recordingCapability } from '../capabilities/recording.cap.js';
+export { recordingArchiveCapability } from '../capabilities/recording-archive.cap.js';
 export { recordingExportCapability } from '../capabilities/recording-export.cap.js';
 export { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 export { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
@@ -216,7 +216,6 @@ export declare const CAPABILITY_NAMES: {
     readonly embeddingEncoder: "embedding-encoder";
     readonly enumSensor: "enum-sensor";
     readonly eventEmitter: "event-emitter";
-    readonly events: "events";
     readonly faceGallery: "face-gallery";
     readonly failureContribution: "failure-contribution";
     readonly fanControl: "fan-control";
@@ -277,6 +276,7 @@ export declare const CAPABILITY_NAMES: {
     readonly ptzAutotrack: "ptz-autotrack";
     readonly reboot: "reboot";
     readonly recording: "recording";
+    readonly recordingArchive: "recording-archive";
     readonly recordingExport: "recording-export";
     readonly recordingOnboard: "recording-onboard";
     readonly recordingSignal: "recording-signal";
@@ -390,7 +390,6 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly embeddingEncoder: TRouter;
     readonly enumSensor: TRouter;
     readonly eventEmitter: TRouter;
-    readonly events: TRouter;
     readonly faceGallery: TRouter;
     readonly failureContribution: TRouter;
     readonly fanControl: TRouter;
@@ -451,6 +450,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly ptzAutotrack: TRouter;
     readonly reboot: TRouter;
     readonly recording: TRouter;
+    readonly recordingArchive: TRouter;
     readonly recordingExport: TRouter;
     readonly recordingOnboard: TRouter;
     readonly recordingSignal: TRouter;
@@ -494,12 +494,12 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly zoneRules: TRouter;
     readonly zones: TRouter;
 }
-/** Capability names whose mode is `singleton` (131 caps). */
-export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-grid-layout", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-admin-link", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording", "recording-export", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "stream-signals", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
+/** Capability names whose mode is `singleton` (130 caps). */
+export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-grid-layout", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-admin-link", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording-archive", "recording-export", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "stream-signals", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
-/** Capability names whose mode is `collection` (29 caps). */
-export declare const COLLECTION_CAPABILITY_NAMES: readonly ["addon-pages-source", "addon-routes", "addon-widgets-source", "auth-provider", "broker", "connection-test", "custom-model-registry", "data-store-provider", "device-export", "device-provider", "embedding-encoder", "failure-contribution", "llm", "load-contribution", "log-channels", "log-destination", "login-method", "mesh-network", "mqtt-broker", "network-access", "notification-output", "oauth-integration", "smtp-provider", "storage-evictable", "storage-occupancy", "storage-provider", "turn-provider", "user-passkeys", "videoclips"];
+/** Capability names whose mode is `collection` (30 caps). */
+export declare const COLLECTION_CAPABILITY_NAMES: readonly ["addon-pages-source", "addon-routes", "addon-widgets-source", "auth-provider", "broker", "connection-test", "custom-model-registry", "data-store-provider", "device-export", "device-provider", "embedding-encoder", "failure-contribution", "llm", "load-contribution", "log-channels", "log-destination", "login-method", "mesh-network", "mqtt-broker", "network-access", "notification-output", "oauth-integration", "recording", "smtp-provider", "storage-evictable", "storage-occupancy", "storage-provider", "turn-provider", "user-passkeys", "videoclips"];
 /** Union of collection capability names (literal string union). */
 export type CollectionCapabilityName = typeof COLLECTION_CAPABILITY_NAMES[number];
 /** Capability mode lookup at runtime — mirrors the `.cap.ts` definitions. */

package/dist/generated/collection-array-methods.d.ts

@@ -8,7 +8,7 @@
  * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
  * forked runner. See docs/decisions/adr-0028.md.
  *
- * Coverage: 22 collection caps, 36 array methods.
+ * Coverage: 23 collection caps, 37 array methods.
  */
 export declare const COLLECTION_ARRAY_METHODS: Readonly<Record<string, readonly string[]>>;
 /**
@@ -17,3 +17,21 @@ export declare const COLLECTION_ARRAY_METHODS: Readonly<Record<string, readonly
  * `isCollectionArrayMethod(capDefsByName.get(capName), method)`.
  */
 export declare function isCollectionArrayMethodName(capName: string, method: string): boolean;
+/**
+ * Per capability, the methods declared `optionalMethod` — the ones whose
+ * ABSENCE on a provider is a fact about that provider, not a bug.
+ *
+ * Coverage: 1 caps, 4 methods.
+ */
+export declare const PROVIDER_OPTIONAL_METHODS: Readonly<Record<string, readonly string[]>>;
+/**
+ * True when `method` on cap `capName` is declared `optionalMethod`.
+ *
+ * `providerOptional` used to be a TYPE-only flag: it made the method optional
+ * on `InferProvider` and nothing read it at runtime, so a source that
+ * honestly did not implement one produced `INTERNAL_SERVER_ERROR` — the same
+ * signature as a method somebody forgot. Measured on the live hub 2026-09-24:
+ * `videoclips.getPlaybackOptions` at the recorder's `analytics` source, a
+ * time WINDOW with no file behind it, threw on every player open.
+ */
+export declare function isProviderOptionalMethodName(capName: string, method: string): boolean;

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

@@ -33,7 +33,6 @@ import type { deviceStatusCapability } from '../capabilities/device-status.cap.j
 import type { doorbellCapability } from '../capabilities/doorbell.cap.js';
 import type { enumSensorCapability } from '../capabilities/enum-sensor.cap.js';
 import type { eventEmitterCapability } from '../capabilities/event-emitter.cap.js';
-import type { eventsCapability } from '../capabilities/events.cap.js';
 import type { fanControlCapability } from '../capabilities/fan-control.cap.js';
 import type { featureProbeCapability } from '../capabilities/feature-probe.cap.js';
 import type { floodCapability } from '../capabilities/flood.cap.js';
@@ -66,6 +65,7 @@ import type { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js'
 import type { ptzCapability } from '../capabilities/ptz.cap.js';
 import type { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 import type { rebootCapability } from '../capabilities/reboot.cap.js';
+import type { recordingCapability } from '../capabilities/recording.cap.js';
 import type { recordingOnboardCapability } from '../capabilities/recording-onboard.cap.js';
 import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
@@ -104,7 +104,7 @@ import type { pipelineExecutorCapability } from '../capabilities/pipeline-execut
 import type { pipelineOrchestratorCapability } from '../capabilities/pipeline-orchestrator.cap.js';
 import type { pipelineRunnerCapability } from '../capabilities/pipeline-runner.cap.js';
 import type { plateGalleryCapability } from '../capabilities/plate-gallery.cap.js';
-import type { recordingCapability } from '../capabilities/recording.cap.js';
+import type { recordingArchiveCapability } from '../capabilities/recording-archive.cap.js';
 import type { recordingExportCapability } from '../capabilities/recording-export.cap.js';
 import type { streamBrokerCapability } from '../capabilities/stream-broker.cap.js';
 /**
@@ -232,7 +232,6 @@ export interface DeviceProxy {
     readonly doorbell?: InferDeviceProxyCap<typeof doorbellCapability>;
     readonly enumSensor?: InferDeviceProxyCap<typeof enumSensorCapability>;
     readonly eventEmitter?: InferDeviceProxyCap<typeof eventEmitterCapability>;
-    readonly events?: InferDeviceProxyCap<typeof eventsCapability>;
     readonly fanControl?: InferDeviceProxyCap<typeof fanControlCapability>;
     readonly featureProbe?: InferDeviceProxyCap<typeof featureProbeCapability>;
     readonly flood?: InferDeviceProxyCap<typeof floodCapability>;
@@ -265,6 +264,7 @@ export interface DeviceProxy {
     readonly ptz?: InferDeviceProxyCap<typeof ptzCapability>;
     readonly ptzAutotrack?: InferDeviceProxyCap<typeof ptzAutotrackCapability>;
     readonly reboot?: InferDeviceProxyCap<typeof rebootCapability>;
+    readonly recording?: InferDeviceProxyCap<typeof recordingCapability>;
     readonly recordingOnboard?: InferDeviceProxyCap<typeof recordingOnboardCapability>;
     readonly recordingSignal?: InferDeviceProxyCap<typeof recordingSignalCapability>;
     readonly sceneMonitor?: InferDeviceProxyCap<typeof sceneMonitorCapability>;
@@ -303,7 +303,7 @@ export interface DeviceProxy {
     readonly pipelineOrchestrator: Pick<InferDeviceProxyCap<typeof pipelineOrchestratorCapability>, 'assignPipeline' | 'unassignPipeline' | 'setPipelineDevicePin' | 'getPipelineDevicePin' | 'getPipelineAssignment' | 'getCameraMetrics' | 'assignAudio' | 'unassignAudio' | 'getAudioAssignment' | 'getAudioAssignments' | 'getCameraSettings' | 'setCameraStepToggle' | 'getCameraStepOverrides' | 'setCameraStepOverride' | 'setCameraPipelineForAgent' | 'resolvePipeline' | 'getCameraSwitches' | 'setCameraSwitch' | 'getCameraStatus' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
     readonly pipelineRunner: Pick<InferDeviceProxyCap<typeof pipelineRunnerCapability>, 'detachCamera' | 'getCameraMetrics' | 'requestOccupancyBurst' | 'runDetailSubtree' | 'parkTrackFrame' | 'getParkedTrackFrame' | 'releaseParkedTrackFrames'>;
     readonly plateGallery: Pick<InferDeviceProxyCap<typeof plateGalleryCapability>, 'listPlates' | 'getPlateByTrack'>;
-    readonly recording: Pick<InferDeviceProxyCap<typeof recordingCapability>, 'getAvailability' | 'getDaysWithRecordings' | 'getPlaybackManifest' | 'getDeviceConfig' | 'locateSegment' | 'readSegmentBytes' | 'readGopBytes' | 'readWindowBytes' | 'setDeviceConfig' | 'rescanStorage' | 'pruneFootage' | 'deleteFootprint' | 'renderGif' | 'renderClip' | 'getStatus' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
+    readonly recordingArchive: Pick<InferDeviceProxyCap<typeof recordingArchiveCapability>, 'getDeviceConfig' | 'locateSegment' | 'readSegmentBytes' | 'readGopBytes' | 'readWindowBytes' | 'setDeviceConfig' | 'rescanStorage' | 'pruneFootage' | 'deleteFootprint' | 'renderGif' | 'renderClip' | 'getStatus' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
     readonly recordingExport: Pick<InferDeviceProxyCap<typeof recordingExportCapability>, 'listExports'>;
     readonly streamBroker: Pick<InferDeviceProxyCap<typeof streamBrokerCapability>, 'reportStreamSignal' | 'publishCameraStream' | 'retractCameraStream' | 'assignProfile' | 'unassignProfile' | 'forgetDeviceHardware' | 'renderPreBufferClip' | 'produceEventMedia' | 'restartProfile' | 'getDeviceAudioMute' | 'setDeviceAudioMute' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
 }

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: 1171 method paths across 160 capabilities.
+ * Coverage: 1170 method paths across 160 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: 397 methods carry a device reference, of which
- * 141 are on SYSTEM-scope caps.
+ * Coverage: 396 methods carry a device reference, of which
+ * 138 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

@@ -33,7 +33,7 @@ import type { pipelineExecutorCapability } from '../capabilities/pipeline-execut
 import type { pipelineOrchestratorCapability } from '../capabilities/pipeline-orchestrator.cap.js';
 import type { pipelineRunnerCapability } from '../capabilities/pipeline-runner.cap.js';
 import type { plateGalleryCapability } from '../capabilities/plate-gallery.cap.js';
-import type { recordingCapability } from '../capabilities/recording.cap.js';
+import type { recordingArchiveCapability } from '../capabilities/recording-archive.cap.js';
 import type { recordingExportCapability } from '../capabilities/recording-export.cap.js';
 import type { serverManagementCapability } from '../capabilities/server-management.cap.js';
 import type { settingsStoreCapability } from '../capabilities/settings-store.cap.js';
@@ -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' | 'setAgentDecodeLimits' | '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>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;
+    readonly recordingArchive: Pick<InferProvider<typeof recordingArchiveCapability>, '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' | 'upsert' | 'insert' | 'insertMany' | 'update' | 'delete' | 'deleteWhere' | 'updateWhere' | 'count' | 'aggregate' | 'histogram' | 'isEmpty' | 'declareCollection'>;

package/dist/index.d.ts

@@ -157,6 +157,7 @@ export type { BatteryPresence, BatteryPresenceInput } from './device/battery-pre
 export { BATTERY_UNREACHABLE_AFTER_MS, deriveBatteryPresence, isBatteryPresenceFault, } from './device/battery-presence.js';
 export type { ICameraDevice, StreamSourceEntry } from './device/camera-device.js';
 export { CONTAINER_CHILD_PRIORITY, type ContainerChildRef, resolveContainerPrimaryChild, } from './device/container-primary-child.js';
+export { expandContainer, legacyAutoLinkIds, type LinkCandidate, } from './device/linked-device-resolve.js';
 export type { DeclarationPlacement, DeclaredDeviceOutcome, DeclaredDevicePorts, DeclaredDeviceRow, DeclaredDevicesResult, DeclaredDevicesSpec, DeclaredIntegrationRow, DeviceDeclaration, } from './device/declared-device.js';
 export { DECLARED_DEVICE_SWEEP_LIMIT, DECLARED_INTEGRATION_FIXED_KEY, DeclaredDevices, declarationOwnerNodeId, } from './device/declared-device.js';
 export type { IDevice } from './device/device.js';