@7365admin1/core 3.32.2-staging.62 → 3.32.2-staging.63

package/.changeset/camera-monitoring-wall.md

@@ -0,0 +1,32 @@
+---
+"@7365admin1/core": minor
+---
+
+CCTV monitoring wall: a site-scoped camera list and a batched health sweep.
+
+Two additions to the camera proxy so a supervisor can watch a whole site rather
+than one checkpoint at a time.
+
+`getSiteWall` returns the cameras of one site from `site.cameras` - the
+collection the real cameras are in - together with the polling intervals and
+fan-out caps the client should use. No device is contacted, so opening a wall is
+one database read. Entitlement is by site membership, not by the id in the URL,
+and a caller outside the site gets the same answer as one asking for a site that
+does not exist.
+
+`getSiteHealth` probes the cameras currently on screen with at most
+`CAMERA_WALL_MAX_CONCURRENT_PROBES` in flight. Reachability is a **per-recorder**
+answer, cached per recorder: twelve of this estate's cameras are twelve channels
+on one device, so a full wall is one connect rather than one per tile. It never
+throws for a camera that is down; unreachable is the answer, and a camera whose
+relay has no configured recorder is refused with a reason instead.
+
+Firmware version and device clock are reported as unavailable with a reason: they
+are HTTP CGI facts and the recorder in use exposes RTSP only.
+
+Snapshots now record when a camera last returned a picture, so a tile can say
+"last frame 40 minutes ago" instead of "never".
+
+New, all optional and conservative by default: `CAMERA_WALL_POLL_MS` (5000),
+`CAMERA_SINGLE_POLL_MS` (2000), `CAMERA_WALL_MAX_TILES` (9),
+`CAMERA_WALL_MAX_CONCURRENT_PROBES` (4), `CAMERA_HEALTH_CACHE_SECONDS` (20).

package/dist/index.d.ts

@@ -2879,6 +2879,45 @@ declare function publicCameraFields(camera: Record<string, any>): {
     guardPost: any;
     siteName: any;
 };
+/**
+ * Tuning for a multi-camera wall, read from the environment.
+ *
+ * **Every number here is a guess that must be measured against a real device**,
+ * which is exactly why the client is not allowed to hold its own copy: the wall
+ * endpoint hands these to the app, so an environment that finds its cameras
+ * cannot take nine simultaneous pulls is retuned by a deployment variable and not
+ * by an app-store release.
+ *
+ * V3.37 documents no concurrent-connection limit for any unit — it is absent, not
+ * generous — so the defaults are deliberately slow and small.
+ */
+declare function wallConfig(env?: Record<string, string | undefined>): {
+    /** A wall is situational awareness, not evidence. 5 s per tile is watchable. */
+    snapshotPollMs: number;
+    /**
+     * Single-camera view. Matches `CAMERA_SNAPSHOT_CACHE_SECONDS` exactly —
+     * polling faster than the cache costs round trips and never device requests,
+     * so there is no point going below it and real harm in going far below it.
+     */
+    singlePollMs: number;
+    /** The 3x3 ceiling, enforced here as well as in the client's layout list. */
+    maxTiles: number;
+    /** How many cameras a health sweep probes at once. */
+    maxConcurrentProbes: number;
+    /** Health changes slowly; N supervisors on one wall should be one probe. */
+    healthCacheSeconds: number;
+};
+/**
+ * Runs `worker` over `items`, at most `limit` at a time.
+ *
+ * The whole reason the wall has a backend change at all. Nine tiles asking for
+ * health separately is eighteen device requests fired at once; this makes it four
+ * in flight regardless of how many tiles the supervisor opens.
+ *
+ * ponytail: index-cursor over N workers rather than a queue library — the input is
+ * bounded by `maxTiles` and this is the entire semantics needed.
+ */
+declare function mapWithLimit<T, R>(items: Array<T>, limit: number, worker: (item: T) => Promise<R>): Promise<Array<R>>;
 
 /**
  * Camera functions for Virtual Patrol, proxied.
@@ -2932,6 +2971,14 @@ declare function useCameraViewService(): {
         userId?: string;
         permissions: Array<string>;
     }) => Promise<bson.Document>;
+    authorizeSite: (params: {
+        siteId: string;
+        userId?: string;
+    }) => Promise<{
+        site: mongodb.WithId<bson.Document> | null;
+        siteObjectId: ObjectId;
+        db: mongodb.Db;
+    }>;
     getSnapshot: (params: {
         cameraId: string;
         userId?: string;
@@ -2986,6 +3033,70 @@ declare function useCameraViewService(): {
         driftSeconds: null;
         detailUnavailableReason: string;
     }>;
+    getSiteWall: (params: {
+        siteId: string;
+        userId?: string;
+    }) => Promise<{
+        site: {
+            _id: ObjectId;
+            name: any;
+        };
+        config: {
+            snapshotPollMs: number;
+            singlePollMs: number;
+            maxTiles: number;
+            maxConcurrentProbes: number;
+            healthCacheSeconds: number;
+        };
+        cameras: {
+            unavailableReason: string | null;
+            _id: any;
+            name: any;
+            type: any;
+            status: any;
+            guardPost: any;
+            siteName: any;
+        }[];
+    }>;
+    getSiteHealth: (params: {
+        siteId: string;
+        userId?: string;
+        cameraIds: Array<string>;
+    }) => Promise<{
+        cameras: ({
+            reachable: boolean;
+            health: "unsupported";
+            reason: string;
+            firmwareVersion: null;
+            deviceTime: null;
+            driftSeconds: null;
+            detailUnavailableReason: string;
+            lastFrameAt: string | null;
+            unavailableReason: string | null;
+            _id: any;
+            name: any;
+            type: any;
+            status: any;
+            guardPost: any;
+            siteName: any;
+        } | {
+            reachable: boolean;
+            health: "ok" | "drifted" | "unreachable";
+            reason: string | null;
+            firmwareVersion: null;
+            deviceTime: null;
+            driftSeconds: null;
+            detailUnavailableReason: string;
+            lastFrameAt: string | null;
+            unavailableReason: string | null;
+            _id: any;
+            name: any;
+            type: any;
+            status: any;
+            guardPost: any;
+            siteName: any;
+        })[];
+    }>;
     movePtz: (params: {
         cameraId: string;
         userId?: string;
@@ -3010,6 +3121,8 @@ declare function useCameraViewController(): {
     status: (req: Request, res: Response, next: NextFunction) => Promise<void>;
     ptz: (req: Request, res: Response, next: NextFunction) => Promise<void>;
     capabilities: (_req: Request, res: Response) => Promise<void>;
+    wall: (req: Request, res: Response, next: NextFunction) => Promise<void>;
+    health: (req: Request, res: Response, next: NextFunction) => Promise<void>;
 };
 
 type TCustomerSite = {
@@ -8836,4 +8949,4 @@ declare function useNotificationController(): {
     add: (req: Request, res: Response, next: NextFunction) => Promise<void>;
 };
 
-export { ANPRMode, AccessTypeProps, AppServiceType, AssignCardConfig, BidStatus, BidType, BuildingLevelStatus, BuildingStatus, BulkCardUpdate, BulletinOrder, BulletinRecipient, BulletinSort, BulletinStatus, BulletinVideoOrder, BulletinVideoSort, CAMERA_NOT_PATROL_OR_CCTV, CAMERA_PTZ_PERMISSIONS, CAMERA_REQUEST_TIMEOUT_MS, CAMERA_RTSP_TIMEOUT_MS, CAMERA_SNAPSHOT_CACHE_SECONDS, CAMERA_SNAPSHOT_MAX_BYTES, CAMERA_TYPE_ANPR, CAMERA_TYPE_IP, CAMERA_VIEW_PERMISSIONS, CLOCK_DRIFT_WARN_SECONDS, CURRENT_TIME_ENDPOINT, Camera, CameraDevice, CameraType, DEVICE_STATUS, DOBStatus, DayOfWeek, DynamicFormFields, EAccessCardTypes, EAccessCardUserTypes, EmailSender, EntryOrder, EntrySort, EventOrder, EventSort, EventStatus, EventType, FacilitySort, FacilityStatus, FormEntryStatus, GuestSort, GuestStatus, HID_PERMISSION_CATEGORIES, IAccessCard, IAccessCardTransaction, MAccessCard, MAccessCardTransaction, MAddress, MAttendance, MAttendanceSettings, MBidPreloved, MBillingConfiguration, MBillingItem, MBuilding, MBuildingLevel, MBuildingUnit, MBulletinBoard, MBulletinVideo, MCategoryPreloved, MChannelPreloved, MChat, MChatPreloved, MCustomer, MCustomerSite, MDocumentManagement, MEntryPassSettings, MEventManagement, MFeedback, MFile, MFormEntry, MGuestManagement, MHidAmicoEvent, MHidAmicoIdentity, MHidAmicoReader, MHidSitePermissions, MIncidentReport, MManpowerDesignations, MManpowerMonitoring, MManpowerRemarks, MManpowerSites, MMember, MNfcPatrolLog, MNfcPatrolRoute, MNfcPatrolSettings, MNfcPatrolSettingsUpdate, MNfcPatrolTag, MNotification, MOccurrenceBook, MOccurrenceEntry, MOccurrenceSubject, MOnlineForm, MOrg, MOvernightParkingApprovalHours, MOvernightParkingRequest, MPatrolLog, MPatrolQuestion, MPatrolRoute, MPerson, MPost, MPostFavorite, MPromoCode, MRobot, MRole, MRoleV2, MServiceProvider, MServiceProviderBilling, MSession, MSite, MSiteCamera, MSiteFacility, MSiteFacilityBooking, MStatementOfAccount, MSubcategoryPreloved, MSubscription, MUnitBilling, MUser, MVehicle, MVehicleTransaction, MVerification, MVerificationV2, MVisitorTransaction, MWorkOrder, NotificationAppSlug, NotificationModule, OrgNature, OvernightParkingRequestSort, OvernightParkingRequestStatus, PATROL_CCTV_CAMERA_FILTER, PERSON_TYPES, PStatus, PTZ_ALLOWED_ACTIONS, PTZ_ALLOWED_CODES, Period, PersonStatus, PersonType, PersonTypes, PostOrder, PostSort, PostStatus, QrTagProps, ResidentAppModuleKey, SOFTWARE_VERSION_ENDPOINT, SiteAddress, SiteCategories, SiteStatus, SortFields, SortOrder, Status, SubjectOrder, SubjectSort, SubscriptionType, TAccessMngmntSettings, TActionStatus, TAddress, TAffectedEntities, TAffectedInjured, TAppServiceType, TApprovedBy, TApprover, TAttendance, TAttendanceCheckIn, TAttendanceCheckOut, TAttendanceCheckTime, TAttendanceLocation, TAttendanceSettings, TAttendanceSettingsGetBySite, TAuthorities, TAuthoritiesCalled, TBidPreloved, TBilling, TBillingConfiguration, TBillingItem, TBuilding, TBuildingLevel, TBuildingUnit, TBulletinBoard, TBulletinVideo, TCamera, TCategoryPreloved, TChannelPreloved, TChat, TChatPreloved, TCheckPoint$1 as TCheckPoint, TComplaintInfo, TComplaintReceivedTo, TCounter, TCreateNfcPatrolLog, TCustomer, TCustomerSite, TDayNumber, TDaySchedule, TDefaultAccessCard, TDesignations, TDocs, TDocumentCreate, TDocumentManagement, TEntryPassSettings, TEventManagement, TFeedback, TFeedbackMetadata, TFeedbackUpdate, TFeedbackUpdateCategory, TFeedbackUpdateServiceProvider, TFeedbackUpdateStatus, TFeedbackUpdateToCompleted, TFile, TFiles, TFolderUpdate, TFormEntry, TGetAttendancesByUserQuery, TGetAttendancesQuery, TGuestManagement, THidAmicoEvent, THidAmicoIdentity, THidAmicoReader, THidPermissionAssignment, THidPermissionCategory, THidSitePermissions, TIncidentInformation, TIncidentReport, TIncidentTypeAndTime, TInvoice, TKeyRef, TManpowerDesignations, TManpowerDesignationsUpdate, TManpowerMonitoring, TManpowerMonitoringUpdate, TManpowerRemarks, TManpowerRemarksStatusUpdate, TManpowerRemarksUpdate, TManpowerSearchFilter, TManpowerSites, TMember, TMemberUpdateStatus, TMessagePreloved, TMiniRole, TNfcPatrolLog, TNfcPatrolRoute, TNfcPatrolRouteEdit, TNfcPatrolSettings, TNfcPatrolSettingsGetBySite, TNfcPatrolSettingsUpdate, TNfcPatrolTag, TNfcPatrolTagConfigureReset, TNfcPatrolTagEdit, TNfcPatrolTagUpdateData, TNotification, TOccurrenceBook, TOccurrenceEntry, TOccurrenceSubject, TOnlineForm, TOrg, TOvernightParkingApprovalHours, TOvernightParkingRequest, TPatrolLog, TPatrolQuestion, TPatrolRoute, TPerson, TPlaceOfIncident, TPlates, TPost, TPostFavorite, TPrice, TPriceType, TPromoCode, TPromoTier, TRecipientOfComplaint, TRemarks, TResident, TResidentAppModules, TRobot, TRobotMetadata, TRole, TRoleV2, TRoute, TSOABillingItem, TSOAStatus, TServiceProvider, TServiceProviderBilling, TSession, TSessionCreate, TShifts, TSignNfcPatrolLog, TSite, TSiteCamera, TSiteFacility, TSiteFacilityBooking, TSiteInfo, TSiteInformation, TSiteMetadata, TSiteUpdateBlock, TStatementOfAccount, TSubcategoryPreloved, TSubmissionForm, TSubscription, TUnitBilling, TUnits, TUpdateFormEntry, TUpdateName, TUser, TUserCreate, TVehicle, TVehicleTransaction, TVehicleUpdate, TVerification, TVerificationMetadata, TVerificationMetadataV2, TVerificationV2, TVisitorTransaction, TWorkOrder, TWorkOrderMetadata, TWorkOrderUpdate, TWorkOrderUpdateStatus, TWorkOrderUpdateToCompleted, TanyoneDamageToProperty, UseAccessManagementRepo, UserStatus, VehicleCategory, VehicleOrder, VehicleSort, VehicleStatus, VehicleType, VerificationLinkType, VerificationStatus, VerificationSubjectType, VerificationType, VisitorSort, VisitorStatus, addressSchema, allowedFieldsSite, allowedNatures, attendanceSchema, attendanceSettingsSchema, building_level_namespace_collection, building_units_namespace_collection, buildings_namespace_collection, bulletin_boards_namespace_collection, cameraBaseUrl, cameraDevices, cameraHealthSummary, chatPrelovedEvents, chatSchema, clampPtzSpeed, clockDriftSeconds, createManpowerRemarksDaily, customerSchema, designationsSchema, events_namespace_collection, facility_bookings_namespace_collection, feedbackSchema, feedbacks2_namespace_collection, feedbacks_namespace_collection, ffmpegFrameArgs, ffmpegPath, formatDahuaDate, guests_namespace_collection, hasAnyPermission, incidentReport, incidentReportLog, incidents_namespace_collection, isCameraEntitled, isPatrolCctvCamera, logCamera, manpowerDesignationsSchema, manpowerEvents, manpowerMonitoringSchema, manpowerRemarksSchema, manpowerSitesSchema, nfcPatrolSettingsSchema, nfcPatrolSettingsSchemaUpdate, occurrence_book_namespace_collection, online_forms_namespace_collection, orgSchema, overnight_parking_requests_namespace_collection, parseCameraHost, parseDahuaFind, parseDeviceTime, parseSoftwareVersion, promoCodeSchema, ptzEndpoint, publicCameraFields, remarksSchema, residentAppModuleKeys, residentFormEntry, resolutionRefusalReason, resolveCamera, robotSchema, rtspUrl, schema, schemaAppSlugNotification, schemaApprovedBy, schemaApprover, schemaBidPreloved, schemaBilling, schemaBillingConfiguration, schemaBillingItem, schemaBuilding, schemaBuildingLevel, schemaBuildingUnit, schemaBuildingUpdateOptions, schemaBulletinBoard, schemaBulletinVideo, schemaCategoryPreloved, schemaChannelPreloved, schemaChatPreloved, schemaCreateHidAmicoIdentity, schemaCreateNfcPatrolLog, schemaCreateNotification, schemaCustomerSite, schemaDocumentManagement, schemaEntryPassSettings, schemaEventManagement, schemaFiles, schemaFormEntry, schemaGuestManagement, schemaHidAmicoConfiguration, schemaHidAmicoEvent, schemaHidAmicoExecuteActions, schemaHidAmicoIdentity, schemaHidAmicoIdentityIdParams, schemaHidAmicoIdentityQuery, schemaHidAmicoIntercomCall, schemaHidAmicoLogQuery, schemaHidAmicoNotificationParams, schemaHidAmicoObjectOperation, schemaHidAmicoReader, schemaHidAmicoReaderIdParams, schemaHidAmicoReaderListQuery, schemaHidAmicoSetConfiguration, schemaHidAmicoSiteIdParams, schemaHidAmicoSync, schemaHidAmicoUserImageParams, schemaHidAmicoVisitorQr, schemaHidPermissionCandidateQuery, schemaIncidentReport, schemaListNotification, schemaMultipleDocumentManagement, schemaNfcPatrolLog, schemaNfcPatrolRoute, schemaNfcPatrolTag, schemaNfcPatrolTagUpdateData, schemaNotification, schemaOccurrenceBook, schemaOccurrenceEntry, schemaOccurrenceSubject, schemaOnlineForm, schemaOvernightParkingApprovalHours, schemaOvernightParkingRequest, schemaPatrolLog, schemaPatrolQuestion, schemaPatrolRoute, schemaPerson, schemaPlate, schemaPost, schemaPostFavorite, schemaServiceProvider, schemaServiceProviderBilling, schemaSignNfcPatrolLog, schemaSiteCamera, schemaSiteFacility, schemaSiteFacilityBooking, schemaStatementOfAccount, schemaSubcategoryPreloved, schemaUnitBilling, schemaUpdateBidPreloved, schemaUpdateBuildingLevel, schemaUpdateBulletinBoard, schemaUpdateBulletinVideo, schemaUpdateCategoryPreloved, schemaUpdateChatPreloved, schemaUpdateDocumentManagement, schemaUpdateEntryPassSettings, schemaUpdateEventManagement, schemaUpdateFolderManagement, schemaUpdateFormEntry, schemaUpdateGuestManagement, schemaUpdateHidAmicoIdentity, schemaUpdateHidAmicoReader, schemaUpdateHidSitePermissions, schemaUpdateIncidentReport, schemaUpdateNotification, schemaUpdateOccurrenceBook, schemaUpdateOccurrenceEntry, schemaUpdateOccurrenceSubject, schemaUpdateOnlineForm, schemaUpdateOptions, schemaUpdateOvernightParkingRequest, schemaUpdatePatrolLog, schemaUpdatePatrolQuestion, schemaUpdatePatrolRoute, schemaUpdatePerson, schemaUpdatePost, schemaUpdatePostFavorite, schemaUpdateServiceProviderBilling, schemaUpdateSiteBillingConfiguration, schemaUpdateSiteBillingItem, schemaUpdateSiteCamera, schemaUpdateSiteFacility, schemaUpdateSiteFacilityBooking, schemaUpdateSiteUnitBilling, schemaUpdateStatementOfAccount, schemaUpdateSubcategoryPreloved, schemaUpdateVisTrans, schemaVehicleTransaction, schemaVisitorTransaction, schemeCamera, schemeLogCamera, sessionSchema, shiftSchema, siteSchema, site_people_namespace_collection, snapshotEndpoint, snapshotRefusalReason, updateRemarksStatusEod, updateRemarksisAcknowledged, updateSiteSchema, useAccessManagementController, useAddressRepo, useAttendanceController, useAttendanceRepository, useAttendanceSettingsController, useAttendanceSettingsRepository, useAttendanceSettingsService, useAuthController, useAuthControllerV2, useAuthService, useAuthServiceV2, useBidPrelovedController, useBidPrelovedRepo, useBidPrelovedService, useBuildingController, useBuildingLevelController, useBuildingLevelRepo, useBuildingLevelService, useBuildingRepo, useBuildingService, useBuildingUnitController, useBuildingUnitRepo, useBuildingUnitService, useBulletinBoardController, useBulletinBoardRepo, useBulletinBoardService, useBulletinVideoController, useBulletinVideoRepo, useBulletinVideoService, useCameraViewController, useCameraViewService, useCategoryPrelovedController, useCategoryPrelovedRepo, useChannelPrelovedController, useChannelPrelovedRepo, useChatController, useChatPrelovedController, useChatPrelovedRepo, useChatPrelovedService, useChatRepo, useCounterModel, useCounterRepo, useCustomerController, useCustomerRepo, useCustomerSiteController, useCustomerSiteRepo, useCustomerSiteService, useDahuaService, useDashboardController, useDashboardRepo, useDocumentManagementController, useDocumentManagementRepo, useDocumentManagementService, useEntryPassSettingsController, useEntryPassSettingsRepo, useEventManagementController, useEventManagementRepo, useEventManagementService, useFeedbackController, useFeedbackRepo, useFeedbackService, useFileController, useFileRepo, useFileService, useFormEntryController, useFormEntryRepo, useGuestManagementController, useGuestManagementRepo, useGuestManagementService, useHidAmicoController, useHidAmicoRepo, useHidAmicoService, useHrmLabsAttendanceCtrl, useHrmLabsAttendanceSrvc, useIncidentReportController, useIncidentReportRepo, useIncidentReportService, useInvoiceController, useInvoiceModel, useInvoiceRepo, useManpowerDesignationCtrl, useManpowerDesignationRepo, useManpowerMonitoringCtrl, useManpowerMonitoringRepo, useManpowerMonitoringSrvc, useManpowerRemarkCtrl, useManpowerRemarksRepo, useManpowerSitesCtrl, useManpowerSitesRepo, useManpowerSitesSrvc, useMemberController, useMemberRepo, useMemberService, useNewDashboardController, useNewDashboardRepo, useNfcPatrolLogController, useNfcPatrolLogRepo, useNfcPatrolLogService, useNfcPatrolRouteController, useNfcPatrolRouteRepo, useNfcPatrolRouteService, useNfcPatrolSettingsController, useNfcPatrolSettingsRepository, useNfcPatrolSettingsService, useNfcPatrolTagController, useNfcPatrolTagRepo, useNfcPatrolTagService, useNotificationController, useNotificationRepo, useOccurrenceBookController, useOccurrenceBookRepo, useOccurrenceBookService, useOccurrenceEntryController, useOccurrenceEntryRepo, useOccurrenceEntryService, useOccurrenceSubjectController, useOccurrenceSubjectRepo, useOccurrenceSubjectService, useOnlineFormController, useOnlineFormRepo, useOrgController, useOrgControllerV2, useOrgRepo, useOvernightParkingController, useOvernightParkingRepo, useOvernightParkingRequestController, useOvernightParkingRequestRepo, useOvernightParkingRequestService, usePatrolLogController, usePatrolLogRepo, usePatrolQuestionController, usePatrolQuestionRepo, usePatrolRouteController, usePatrolRouteRepo, usePersonController, usePersonRepo, usePostFavoriteController, usePostFavoriteRepo, usePostFavoriteService, usePostPrelovedController, usePostPrelovedRepo, usePriceController, usePriceModel, usePriceRepo, usePromoCodeController, usePromoCodeRepo, useRedDotPaymentController, useRedDotPaymentRepo, useRedDotPaymentSvc, useRobotController, useRobotRepo, useRobotService, useRoleController, useRoleControllerV2, useRoleRepo, useRoleRepoV2, useRoleServiceV2, useServiceProviderBillingController, useServiceProviderBillingRepo, useServiceProviderBillingService, useServiceProviderController, useServiceProviderRepo, useSessionRepo, useSiteBillingConfigurationController, useSiteBillingConfigurationRepo, useSiteBillingItemController, useSiteBillingItemRepo, useSiteCameraController, useSiteCameraRepo, useSiteCameraService, useSiteController, useSiteFacilityBookingController, useSiteFacilityBookingRepo, useSiteFacilityBookingService, useSiteFacilityController, useSiteFacilityRepo, useSiteFacilityService, useSiteRepo, useSiteService, useSiteUnitBillingController, useSiteUnitBillingRepo, useSiteUnitBillingService, useStatementOfAccountController, useStatementOfAccountRepo, useSubcategoryPrelovedController, useSubcategoryPrelovedRepo, useSubscriptionController, useSubscriptionRepo, useSubscriptionService, useUserController, useUserControllerV2, useUserRepo, useUserRepoV2, useUserService, useUserServiceV2, useVehicleController, useVehicleRepo, useVehicleService, useVerificationController, useVerificationControllerV2, useVerificationRepo, useVerificationRepoV2, useVerificationService, useVerificationServiceV2, useVisitorTransactionController, useVisitorTransactionRepo, useVisitorTransactionService, useWorkOrderController, useWorkOrderRepo, useWorkOrderService, userSchema, vehicleSchema, vehicles_namespace_collection, visitorPersonRepo, visitorPersonService, visitorType, visitors_namespace_collection, workOrderSchema, work_orders2_namespace_collection, work_orders_namespace_collection };
+export { ANPRMode, AccessTypeProps, AppServiceType, AssignCardConfig, BidStatus, BidType, BuildingLevelStatus, BuildingStatus, BulkCardUpdate, BulletinOrder, BulletinRecipient, BulletinSort, BulletinStatus, BulletinVideoOrder, BulletinVideoSort, CAMERA_NOT_PATROL_OR_CCTV, CAMERA_PTZ_PERMISSIONS, CAMERA_REQUEST_TIMEOUT_MS, CAMERA_RTSP_TIMEOUT_MS, CAMERA_SNAPSHOT_CACHE_SECONDS, CAMERA_SNAPSHOT_MAX_BYTES, CAMERA_TYPE_ANPR, CAMERA_TYPE_IP, CAMERA_VIEW_PERMISSIONS, CLOCK_DRIFT_WARN_SECONDS, CURRENT_TIME_ENDPOINT, Camera, CameraDevice, CameraType, DEVICE_STATUS, DOBStatus, DayOfWeek, DynamicFormFields, EAccessCardTypes, EAccessCardUserTypes, EmailSender, EntryOrder, EntrySort, EventOrder, EventSort, EventStatus, EventType, FacilitySort, FacilityStatus, FormEntryStatus, GuestSort, GuestStatus, HID_PERMISSION_CATEGORIES, IAccessCard, IAccessCardTransaction, MAccessCard, MAccessCardTransaction, MAddress, MAttendance, MAttendanceSettings, MBidPreloved, MBillingConfiguration, MBillingItem, MBuilding, MBuildingLevel, MBuildingUnit, MBulletinBoard, MBulletinVideo, MCategoryPreloved, MChannelPreloved, MChat, MChatPreloved, MCustomer, MCustomerSite, MDocumentManagement, MEntryPassSettings, MEventManagement, MFeedback, MFile, MFormEntry, MGuestManagement, MHidAmicoEvent, MHidAmicoIdentity, MHidAmicoReader, MHidSitePermissions, MIncidentReport, MManpowerDesignations, MManpowerMonitoring, MManpowerRemarks, MManpowerSites, MMember, MNfcPatrolLog, MNfcPatrolRoute, MNfcPatrolSettings, MNfcPatrolSettingsUpdate, MNfcPatrolTag, MNotification, MOccurrenceBook, MOccurrenceEntry, MOccurrenceSubject, MOnlineForm, MOrg, MOvernightParkingApprovalHours, MOvernightParkingRequest, MPatrolLog, MPatrolQuestion, MPatrolRoute, MPerson, MPost, MPostFavorite, MPromoCode, MRobot, MRole, MRoleV2, MServiceProvider, MServiceProviderBilling, MSession, MSite, MSiteCamera, MSiteFacility, MSiteFacilityBooking, MStatementOfAccount, MSubcategoryPreloved, MSubscription, MUnitBilling, MUser, MVehicle, MVehicleTransaction, MVerification, MVerificationV2, MVisitorTransaction, MWorkOrder, NotificationAppSlug, NotificationModule, OrgNature, OvernightParkingRequestSort, OvernightParkingRequestStatus, PATROL_CCTV_CAMERA_FILTER, PERSON_TYPES, PStatus, PTZ_ALLOWED_ACTIONS, PTZ_ALLOWED_CODES, Period, PersonStatus, PersonType, PersonTypes, PostOrder, PostSort, PostStatus, QrTagProps, ResidentAppModuleKey, SOFTWARE_VERSION_ENDPOINT, SiteAddress, SiteCategories, SiteStatus, SortFields, SortOrder, Status, SubjectOrder, SubjectSort, SubscriptionType, TAccessMngmntSettings, TActionStatus, TAddress, TAffectedEntities, TAffectedInjured, TAppServiceType, TApprovedBy, TApprover, TAttendance, TAttendanceCheckIn, TAttendanceCheckOut, TAttendanceCheckTime, TAttendanceLocation, TAttendanceSettings, TAttendanceSettingsGetBySite, TAuthorities, TAuthoritiesCalled, TBidPreloved, TBilling, TBillingConfiguration, TBillingItem, TBuilding, TBuildingLevel, TBuildingUnit, TBulletinBoard, TBulletinVideo, TCamera, TCategoryPreloved, TChannelPreloved, TChat, TChatPreloved, TCheckPoint$1 as TCheckPoint, TComplaintInfo, TComplaintReceivedTo, TCounter, TCreateNfcPatrolLog, TCustomer, TCustomerSite, TDayNumber, TDaySchedule, TDefaultAccessCard, TDesignations, TDocs, TDocumentCreate, TDocumentManagement, TEntryPassSettings, TEventManagement, TFeedback, TFeedbackMetadata, TFeedbackUpdate, TFeedbackUpdateCategory, TFeedbackUpdateServiceProvider, TFeedbackUpdateStatus, TFeedbackUpdateToCompleted, TFile, TFiles, TFolderUpdate, TFormEntry, TGetAttendancesByUserQuery, TGetAttendancesQuery, TGuestManagement, THidAmicoEvent, THidAmicoIdentity, THidAmicoReader, THidPermissionAssignment, THidPermissionCategory, THidSitePermissions, TIncidentInformation, TIncidentReport, TIncidentTypeAndTime, TInvoice, TKeyRef, TManpowerDesignations, TManpowerDesignationsUpdate, TManpowerMonitoring, TManpowerMonitoringUpdate, TManpowerRemarks, TManpowerRemarksStatusUpdate, TManpowerRemarksUpdate, TManpowerSearchFilter, TManpowerSites, TMember, TMemberUpdateStatus, TMessagePreloved, TMiniRole, TNfcPatrolLog, TNfcPatrolRoute, TNfcPatrolRouteEdit, TNfcPatrolSettings, TNfcPatrolSettingsGetBySite, TNfcPatrolSettingsUpdate, TNfcPatrolTag, TNfcPatrolTagConfigureReset, TNfcPatrolTagEdit, TNfcPatrolTagUpdateData, TNotification, TOccurrenceBook, TOccurrenceEntry, TOccurrenceSubject, TOnlineForm, TOrg, TOvernightParkingApprovalHours, TOvernightParkingRequest, TPatrolLog, TPatrolQuestion, TPatrolRoute, TPerson, TPlaceOfIncident, TPlates, TPost, TPostFavorite, TPrice, TPriceType, TPromoCode, TPromoTier, TRecipientOfComplaint, TRemarks, TResident, TResidentAppModules, TRobot, TRobotMetadata, TRole, TRoleV2, TRoute, TSOABillingItem, TSOAStatus, TServiceProvider, TServiceProviderBilling, TSession, TSessionCreate, TShifts, TSignNfcPatrolLog, TSite, TSiteCamera, TSiteFacility, TSiteFacilityBooking, TSiteInfo, TSiteInformation, TSiteMetadata, TSiteUpdateBlock, TStatementOfAccount, TSubcategoryPreloved, TSubmissionForm, TSubscription, TUnitBilling, TUnits, TUpdateFormEntry, TUpdateName, TUser, TUserCreate, TVehicle, TVehicleTransaction, TVehicleUpdate, TVerification, TVerificationMetadata, TVerificationMetadataV2, TVerificationV2, TVisitorTransaction, TWorkOrder, TWorkOrderMetadata, TWorkOrderUpdate, TWorkOrderUpdateStatus, TWorkOrderUpdateToCompleted, TanyoneDamageToProperty, UseAccessManagementRepo, UserStatus, VehicleCategory, VehicleOrder, VehicleSort, VehicleStatus, VehicleType, VerificationLinkType, VerificationStatus, VerificationSubjectType, VerificationType, VisitorSort, VisitorStatus, addressSchema, allowedFieldsSite, allowedNatures, attendanceSchema, attendanceSettingsSchema, building_level_namespace_collection, building_units_namespace_collection, buildings_namespace_collection, bulletin_boards_namespace_collection, cameraBaseUrl, cameraDevices, cameraHealthSummary, chatPrelovedEvents, chatSchema, clampPtzSpeed, clockDriftSeconds, createManpowerRemarksDaily, customerSchema, designationsSchema, events_namespace_collection, facility_bookings_namespace_collection, feedbackSchema, feedbacks2_namespace_collection, feedbacks_namespace_collection, ffmpegFrameArgs, ffmpegPath, formatDahuaDate, guests_namespace_collection, hasAnyPermission, incidentReport, incidentReportLog, incidents_namespace_collection, isCameraEntitled, isPatrolCctvCamera, logCamera, manpowerDesignationsSchema, manpowerEvents, manpowerMonitoringSchema, manpowerRemarksSchema, manpowerSitesSchema, mapWithLimit, nfcPatrolSettingsSchema, nfcPatrolSettingsSchemaUpdate, occurrence_book_namespace_collection, online_forms_namespace_collection, orgSchema, overnight_parking_requests_namespace_collection, parseCameraHost, parseDahuaFind, parseDeviceTime, parseSoftwareVersion, promoCodeSchema, ptzEndpoint, publicCameraFields, remarksSchema, residentAppModuleKeys, residentFormEntry, resolutionRefusalReason, resolveCamera, robotSchema, rtspUrl, schema, schemaAppSlugNotification, schemaApprovedBy, schemaApprover, schemaBidPreloved, schemaBilling, schemaBillingConfiguration, schemaBillingItem, schemaBuilding, schemaBuildingLevel, schemaBuildingUnit, schemaBuildingUpdateOptions, schemaBulletinBoard, schemaBulletinVideo, schemaCategoryPreloved, schemaChannelPreloved, schemaChatPreloved, schemaCreateHidAmicoIdentity, schemaCreateNfcPatrolLog, schemaCreateNotification, schemaCustomerSite, schemaDocumentManagement, schemaEntryPassSettings, schemaEventManagement, schemaFiles, schemaFormEntry, schemaGuestManagement, schemaHidAmicoConfiguration, schemaHidAmicoEvent, schemaHidAmicoExecuteActions, schemaHidAmicoIdentity, schemaHidAmicoIdentityIdParams, schemaHidAmicoIdentityQuery, schemaHidAmicoIntercomCall, schemaHidAmicoLogQuery, schemaHidAmicoNotificationParams, schemaHidAmicoObjectOperation, schemaHidAmicoReader, schemaHidAmicoReaderIdParams, schemaHidAmicoReaderListQuery, schemaHidAmicoSetConfiguration, schemaHidAmicoSiteIdParams, schemaHidAmicoSync, schemaHidAmicoUserImageParams, schemaHidAmicoVisitorQr, schemaHidPermissionCandidateQuery, schemaIncidentReport, schemaListNotification, schemaMultipleDocumentManagement, schemaNfcPatrolLog, schemaNfcPatrolRoute, schemaNfcPatrolTag, schemaNfcPatrolTagUpdateData, schemaNotification, schemaOccurrenceBook, schemaOccurrenceEntry, schemaOccurrenceSubject, schemaOnlineForm, schemaOvernightParkingApprovalHours, schemaOvernightParkingRequest, schemaPatrolLog, schemaPatrolQuestion, schemaPatrolRoute, schemaPerson, schemaPlate, schemaPost, schemaPostFavorite, schemaServiceProvider, schemaServiceProviderBilling, schemaSignNfcPatrolLog, schemaSiteCamera, schemaSiteFacility, schemaSiteFacilityBooking, schemaStatementOfAccount, schemaSubcategoryPreloved, schemaUnitBilling, schemaUpdateBidPreloved, schemaUpdateBuildingLevel, schemaUpdateBulletinBoard, schemaUpdateBulletinVideo, schemaUpdateCategoryPreloved, schemaUpdateChatPreloved, schemaUpdateDocumentManagement, schemaUpdateEntryPassSettings, schemaUpdateEventManagement, schemaUpdateFolderManagement, schemaUpdateFormEntry, schemaUpdateGuestManagement, schemaUpdateHidAmicoIdentity, schemaUpdateHidAmicoReader, schemaUpdateHidSitePermissions, schemaUpdateIncidentReport, schemaUpdateNotification, schemaUpdateOccurrenceBook, schemaUpdateOccurrenceEntry, schemaUpdateOccurrenceSubject, schemaUpdateOnlineForm, schemaUpdateOptions, schemaUpdateOvernightParkingRequest, schemaUpdatePatrolLog, schemaUpdatePatrolQuestion, schemaUpdatePatrolRoute, schemaUpdatePerson, schemaUpdatePost, schemaUpdatePostFavorite, schemaUpdateServiceProviderBilling, schemaUpdateSiteBillingConfiguration, schemaUpdateSiteBillingItem, schemaUpdateSiteCamera, schemaUpdateSiteFacility, schemaUpdateSiteFacilityBooking, schemaUpdateSiteUnitBilling, schemaUpdateStatementOfAccount, schemaUpdateSubcategoryPreloved, schemaUpdateVisTrans, schemaVehicleTransaction, schemaVisitorTransaction, schemeCamera, schemeLogCamera, sessionSchema, shiftSchema, siteSchema, site_people_namespace_collection, snapshotEndpoint, snapshotRefusalReason, updateRemarksStatusEod, updateRemarksisAcknowledged, updateSiteSchema, useAccessManagementController, useAddressRepo, useAttendanceController, useAttendanceRepository, useAttendanceSettingsController, useAttendanceSettingsRepository, useAttendanceSettingsService, useAuthController, useAuthControllerV2, useAuthService, useAuthServiceV2, useBidPrelovedController, useBidPrelovedRepo, useBidPrelovedService, useBuildingController, useBuildingLevelController, useBuildingLevelRepo, useBuildingLevelService, useBuildingRepo, useBuildingService, useBuildingUnitController, useBuildingUnitRepo, useBuildingUnitService, useBulletinBoardController, useBulletinBoardRepo, useBulletinBoardService, useBulletinVideoController, useBulletinVideoRepo, useBulletinVideoService, useCameraViewController, useCameraViewService, useCategoryPrelovedController, useCategoryPrelovedRepo, useChannelPrelovedController, useChannelPrelovedRepo, useChatController, useChatPrelovedController, useChatPrelovedRepo, useChatPrelovedService, useChatRepo, useCounterModel, useCounterRepo, useCustomerController, useCustomerRepo, useCustomerSiteController, useCustomerSiteRepo, useCustomerSiteService, useDahuaService, useDashboardController, useDashboardRepo, useDocumentManagementController, useDocumentManagementRepo, useDocumentManagementService, useEntryPassSettingsController, useEntryPassSettingsRepo, useEventManagementController, useEventManagementRepo, useEventManagementService, useFeedbackController, useFeedbackRepo, useFeedbackService, useFileController, useFileRepo, useFileService, useFormEntryController, useFormEntryRepo, useGuestManagementController, useGuestManagementRepo, useGuestManagementService, useHidAmicoController, useHidAmicoRepo, useHidAmicoService, useHrmLabsAttendanceCtrl, useHrmLabsAttendanceSrvc, useIncidentReportController, useIncidentReportRepo, useIncidentReportService, useInvoiceController, useInvoiceModel, useInvoiceRepo, useManpowerDesignationCtrl, useManpowerDesignationRepo, useManpowerMonitoringCtrl, useManpowerMonitoringRepo, useManpowerMonitoringSrvc, useManpowerRemarkCtrl, useManpowerRemarksRepo, useManpowerSitesCtrl, useManpowerSitesRepo, useManpowerSitesSrvc, useMemberController, useMemberRepo, useMemberService, useNewDashboardController, useNewDashboardRepo, useNfcPatrolLogController, useNfcPatrolLogRepo, useNfcPatrolLogService, useNfcPatrolRouteController, useNfcPatrolRouteRepo, useNfcPatrolRouteService, useNfcPatrolSettingsController, useNfcPatrolSettingsRepository, useNfcPatrolSettingsService, useNfcPatrolTagController, useNfcPatrolTagRepo, useNfcPatrolTagService, useNotificationController, useNotificationRepo, useOccurrenceBookController, useOccurrenceBookRepo, useOccurrenceBookService, useOccurrenceEntryController, useOccurrenceEntryRepo, useOccurrenceEntryService, useOccurrenceSubjectController, useOccurrenceSubjectRepo, useOccurrenceSubjectService, useOnlineFormController, useOnlineFormRepo, useOrgController, useOrgControllerV2, useOrgRepo, useOvernightParkingController, useOvernightParkingRepo, useOvernightParkingRequestController, useOvernightParkingRequestRepo, useOvernightParkingRequestService, usePatrolLogController, usePatrolLogRepo, usePatrolQuestionController, usePatrolQuestionRepo, usePatrolRouteController, usePatrolRouteRepo, usePersonController, usePersonRepo, usePostFavoriteController, usePostFavoriteRepo, usePostFavoriteService, usePostPrelovedController, usePostPrelovedRepo, usePriceController, usePriceModel, usePriceRepo, usePromoCodeController, usePromoCodeRepo, useRedDotPaymentController, useRedDotPaymentRepo, useRedDotPaymentSvc, useRobotController, useRobotRepo, useRobotService, useRoleController, useRoleControllerV2, useRoleRepo, useRoleRepoV2, useRoleServiceV2, useServiceProviderBillingController, useServiceProviderBillingRepo, useServiceProviderBillingService, useServiceProviderController, useServiceProviderRepo, useSessionRepo, useSiteBillingConfigurationController, useSiteBillingConfigurationRepo, useSiteBillingItemController, useSiteBillingItemRepo, useSiteCameraController, useSiteCameraRepo, useSiteCameraService, useSiteController, useSiteFacilityBookingController, useSiteFacilityBookingRepo, useSiteFacilityBookingService, useSiteFacilityController, useSiteFacilityRepo, useSiteFacilityService, useSiteRepo, useSiteService, useSiteUnitBillingController, useSiteUnitBillingRepo, useSiteUnitBillingService, useStatementOfAccountController, useStatementOfAccountRepo, useSubcategoryPrelovedController, useSubcategoryPrelovedRepo, useSubscriptionController, useSubscriptionRepo, useSubscriptionService, useUserController, useUserControllerV2, useUserRepo, useUserRepoV2, useUserService, useUserServiceV2, useVehicleController, useVehicleRepo, useVehicleService, useVerificationController, useVerificationControllerV2, useVerificationRepo, useVerificationRepoV2, useVerificationService, useVerificationServiceV2, useVisitorTransactionController, useVisitorTransactionRepo, useVisitorTransactionService, useWorkOrderController, useWorkOrderRepo, useWorkOrderService, userSchema, vehicleSchema, vehicles_namespace_collection, visitorPersonRepo, visitorPersonService, visitorType, visitors_namespace_collection, wallConfig, workOrderSchema, work_orders2_namespace_collection, work_orders_namespace_collection };

package/dist/index.js

@@ -6085,6 +6085,7 @@ __export(src_exports, {
   manpowerMonitoringSchema: () => manpowerMonitoringSchema,
   manpowerRemarksSchema: () => manpowerRemarksSchema,
   manpowerSitesSchema: () => manpowerSitesSchema,
+  mapWithLimit: () => mapWithLimit,
   nfcPatrolSettingsSchema: () => nfcPatrolSettingsSchema,
   nfcPatrolSettingsSchemaUpdate: () => nfcPatrolSettingsSchemaUpdate,
   occurrence_book_namespace_collection: () => occurrence_book_namespace_collection,
@@ -6447,6 +6448,7 @@ __export(src_exports, {
   vehicleSchema: () => vehicleSchema,
   vehicles_namespace_collection: () => vehicles_namespace_collection,
   visitors_namespace_collection: () => visitors_namespace_collection,
+  wallConfig: () => wallConfig,
   workOrderSchema: () => workOrderSchema,
   work_orders2_namespace_collection: () => work_orders2_namespace_collection,
   work_orders_namespace_collection: () => work_orders_namespace_collection
@@ -32583,6 +32585,42 @@ function publicCameraFields(camera) {
     siteName: camera?.siteName ?? ""
   };
 }
+function wallConfig(env = globalThis?.process?.env ?? {}) {
+  return {
+    /** A wall is situational awareness, not evidence. 5 s per tile is watchable. */
+    snapshotPollMs: positiveNumber(env.CAMERA_WALL_POLL_MS, 5e3),
+    /**
+     * Single-camera view. Matches `CAMERA_SNAPSHOT_CACHE_SECONDS` exactly —
+     * polling faster than the cache costs round trips and never device requests,
+     * so there is no point going below it and real harm in going far below it.
+     */
+    singlePollMs: positiveNumber(env.CAMERA_SINGLE_POLL_MS, 2e3),
+    /** The 3x3 ceiling, enforced here as well as in the client's layout list. */
+    maxTiles: positiveNumber(env.CAMERA_WALL_MAX_TILES, 9),
+    /** How many cameras a health sweep probes at once. */
+    maxConcurrentProbes: positiveNumber(env.CAMERA_WALL_MAX_CONCURRENT_PROBES, 4),
+    /** Health changes slowly; N supervisors on one wall should be one probe. */
+    healthCacheSeconds: positiveNumber(env.CAMERA_HEALTH_CACHE_SECONDS, 20)
+  };
+}
+function positiveNumber(raw, fallback) {
+  const value = Number(raw);
+  return Number.isFinite(value) && value > 0 ? value : fallback;
+}
+async function mapWithLimit(items, limit, worker) {
+  const results = new Array(items.length);
+  let cursor = 0;
+  async function run() {
+    while (cursor < items.length) {
+      const index = cursor;
+      cursor += 1;
+      results[index] = await worker(items[index]);
+    }
+  }
+  const width = Math.max(1, Math.min(limit, items.length));
+  await Promise.all(Array.from({ length: width }, run));
+  return results;
+}
 
 // src/services/camera-view.service.ts
 var import_node_server_utils95 = require("@7365admin1/node-server-utils");
@@ -32719,6 +32757,113 @@ function useCameraViewService() {
       socket.on("error", () => done(false));
     });
   }
+  async function authorizeSite(params) {
+    if (!params.userId || !import_mongodb56.ObjectId.isValid(params.userId)) {
+      throw new import_node_server_utils95.UnauthorizedError("Not signed in.");
+    }
+    if (!import_mongodb56.ObjectId.isValid(params.siteId)) {
+      throw new import_node_server_utils95.BadRequestError("Invalid site id.");
+    }
+    const db = import_node_server_utils95.useAtlas.getDb();
+    if (!db)
+      throw new Error("Unable to connect to server.");
+    const siteObjectId = new import_mongodb56.ObjectId(params.siteId);
+    const site = await db.collection("sites").findOne({ _id: siteObjectId }, { projection: { org: 1, name: 1 } });
+    const memberships = await db.collection("members").find({ user: new import_mongodb56.ObjectId(params.userId), status: { $ne: "deleted" } }).project({ siteId: 1, org: 1, role: 1 }).toArray();
+    const entitled = Boolean(site) && isCameraEntitled({
+      cameraSite: siteObjectId,
+      cameraOrg: site?.org,
+      memberships
+    });
+    if (!entitled)
+      throw new import_node_server_utils95.NotFoundError("Site not found.");
+    const permissions = await getUserPermissions({
+      user: params.userId,
+      org: memberships[0]?.org
+    });
+    if (!hasAnyPermission(permissions, CAMERA_VIEW_PERMISSIONS)) {
+      throw new import_node_server_utils95.UnauthorizedError(
+        "You do not have permission to view these cameras."
+      );
+    }
+    return { site, siteObjectId, db };
+  }
+  async function getSiteWall(params) {
+    const { site, siteObjectId, db } = await authorizeSite(params);
+    const cameras = await db.collection("site.cameras").find({
+      ...PATROL_CCTV_CAMERA_FILTER,
+      site: siteObjectId,
+      status: { $ne: "deleted" }
+    }).project({ _id: 1, name: 1, type: 1, status: 1, guardPost: 1, host: 1 }).sort({ guardPost: 1, name: 1 }).toArray();
+    return {
+      site: { _id: siteObjectId, name: site?.name ?? "" },
+      config: wallConfig(),
+      cameras: cameras.map((camera) => ({
+        ...publicCameraFields({ ...camera, siteName: site?.name }),
+        // Answered before anything is requested, so a camera with no address or
+        // an inactive one renders with a reason and costs zero device requests.
+        // (An ANPR unit never reaches here — it is filtered out above.)
+        unavailableReason: snapshotRefusalReason(camera)
+      }))
+    };
+  }
+  async function getSiteHealth(params) {
+    const { siteObjectId, db } = await authorizeSite(params);
+    const config2 = wallConfig();
+    const wanted = params.cameraIds.filter((id) => import_mongodb56.ObjectId.isValid(id)).slice(0, config2.maxTiles);
+    if (wanted.length === 0)
+      return { cameras: [] };
+    const cameras = await db.collection("site.cameras").find({
+      ...PATROL_CCTV_CAMERA_FILTER,
+      _id: { $in: wanted.map((id) => new import_mongodb56.ObjectId(id)) },
+      site: siteObjectId
+    }).toArray();
+    const results = await mapWithLimit(
+      cameras,
+      config2.maxConcurrentProbes,
+      (camera) => probeCamera(camera, config2.healthCacheSeconds)
+    );
+    return { cameras: results };
+  }
+  async function probeCamera(camera, cacheSeconds) {
+    const id = camera?._id?.toString?.() ?? "";
+    const identity = {
+      ...publicCameraFields(camera),
+      unavailableReason: snapshotRefusalReason(camera)
+    };
+    const lastFrameAt = await getCache(`lastframe:${id}`) || null;
+    const base = {
+      ...identity,
+      firmwareVersion: null,
+      deviceTime: null,
+      driftSeconds: null,
+      detailUnavailableReason: "Firmware and device clock are not available: this recorder is reachable over video only.",
+      lastFrameAt
+    };
+    const resolved = identity.unavailableReason ? null : resolveCamera(camera?.host);
+    if (!resolved) {
+      return {
+        ...base,
+        reachable: false,
+        health: "unsupported",
+        reason: identity.unavailableReason ?? "This camera is not configured."
+      };
+    }
+    const cacheKey = `device:${resolved.device.host}:${resolved.device.port}`;
+    const cached = await getCache(cacheKey);
+    const reachable = typeof cached === "boolean" ? cached : await probeDevice(resolved.device);
+    if (typeof cached !== "boolean") {
+      setCache(cacheKey, reachable, cacheSeconds).catch(
+        (error) => import_node_server_utils95.logger.info(`Camera device health cache write failed: ${error?.message}`)
+      );
+    }
+    return {
+      ...base,
+      reachable,
+      health: cameraHealthSummary({ reachable, driftSeconds: null }),
+      reason: reachable ? null : "The recorder did not respond."
+    };
+  }
   async function getSnapshot(params) {
     const camera = await authorizeCamera({
       cameraId: params.cameraId,
@@ -32749,6 +32894,11 @@ function useCameraViewService() {
     setCache(cacheKey, buffer.toString("base64"), CAMERA_SNAPSHOT_CACHE_SECONDS).catch(
       (error) => import_node_server_utils95.logger.info(`Camera snapshot cache write failed: ${error?.message}`)
     );
+    setCache(
+      `lastframe:${params.cameraId}`,
+      (/* @__PURE__ */ new Date()).toISOString(),
+      LAST_FRAME_TTL_SECONDS
+    ).catch(() => void 0);
     return { buffer, cached: false };
   }
   async function captureSnapshot(params) {
@@ -32819,9 +32969,12 @@ function useCameraViewService() {
   }
   return {
     authorizeCamera,
+    authorizeSite,
     getSnapshot,
     captureSnapshot,
     getStatus,
+    getSiteWall,
+    getSiteHealth,
     movePtz,
     ptzEnabled
   };
@@ -32832,12 +32985,20 @@ function maxConcurrentGrabs() {
   return Number.isFinite(value) && value > 0 ? value : 4;
 }
 var inFlightGrabs = 0;
+var LAST_FRAME_TTL_SECONDS = 60 * 60;
 
 // src/controllers/camera-view.controller.ts
 var import_joi50 = __toESM(require("joi"));
 var import_node_server_utils96 = require("@7365admin1/node-server-utils");
 function useCameraViewController() {
-  const { getSnapshot, captureSnapshot, getStatus, movePtz } = useCameraViewService();
+  const {
+    getSnapshot,
+    captureSnapshot,
+    getStatus,
+    getSiteWall,
+    getSiteHealth,
+    movePtz
+  } = useCameraViewService();
   function callerId(req) {
     const user = req.user;
     return user?.user?.toString?.() || user?._id?.toString?.();
@@ -32905,10 +33066,35 @@ function useCameraViewController() {
       next(err);
     }
   }
+  async function wall(req, res, next) {
+    try {
+      const result = await getSiteWall({
+        siteId: String(req.params.siteId ?? ""),
+        userId: callerId(req)
+      });
+      res.json(result);
+    } catch (error) {
+      next(error);
+    }
+  }
+  async function health(req, res, next) {
+    const raw = req.query.ids;
+    const ids = String(Array.isArray(raw) ? raw.join(",") : raw ?? "").split(",").map((id) => id.trim()).filter(Boolean);
+    try {
+      const result = await getSiteHealth({
+        siteId: String(req.params.siteId ?? ""),
+        userId: callerId(req),
+        cameraIds: ids
+      });
+      res.json(result);
+    } catch (error) {
+      next(error);
+    }
+  }
   async function capabilities(_req, res) {
     res.json({ snapshot: true, status: true, ptz: false, liveVideo: false });
   }
-  return { snapshot, capture, status, ptz, capabilities };
+  return { snapshot, capture, status, ptz, capabilities, wall, health };
 }
 
 // src/models/customer-site.model.ts
@@ -74516,6 +74702,7 @@ function useNotificationController() {
   manpowerMonitoringSchema,
   manpowerRemarksSchema,
   manpowerSitesSchema,
+  mapWithLimit,
   nfcPatrolSettingsSchema,
   nfcPatrolSettingsSchemaUpdate,
   occurrence_book_namespace_collection,
@@ -74878,6 +75065,7 @@ function useNotificationController() {
   vehicleSchema,
   vehicles_namespace_collection,
   visitors_namespace_collection,
+  wallConfig,
   workOrderSchema,
   work_orders2_namespace_collection,
   work_orders_namespace_collection