@7365admin1/layer-common 3.2.8-staging.205 → 3.2.8-staging.207

package/components/HidAccessLogDashboard.vue

@@ -31,7 +31,7 @@
       item-value="key"
       show-header
       @refresh="loadDashboard"
-      @update:page="page = $event"
+      @update:page="goToPage"
     >
       <template #actions>
         <AppButton icon="mdi-download" @click="openExportDialog">Export</AppButton>
@@ -62,20 +62,27 @@
             v-model="selectedReaderId"
             class="reader-select"
             :items="readerOptions"
-            @update:model-value="loadDashboard"
+            @update:model-value="reloadDashboardFromFirstPage"
+          />
+          <AppField
+            v-model="search"
+            search
+            placeholder="Search"
+            @keyup.enter="reloadDashboardFromFirstPage"
           />
-          <AppField v-model="search" search placeholder="Search" />
           <AppSelect
             v-model="status"
             :items="statusOptions"
             placeholder="Status"
             clearable
+            @update:model-value="reloadDashboardFromFirstPage"
           />
           <AppSelect
             v-model="accessMethod"
             :items="accessMethodFilterOptions"
             placeholder="Access Method"
             clearable
+            @update:model-value="reloadDashboardFromFirstPage"
           />
         </div>
       </template>
@@ -320,16 +327,57 @@ type PdfAccessRow = {
   accessDateTime: string;
 };
 
-const { getReaders, getIdentities, getLogs, getUserImage, runObjectOperation, getReaderConfiguration } = useHidAmico();
+type HidAccessRecord = {
+  [key: string]: unknown;
+  _id?: string | number;
+  id?: string | number;
+  name?: string;
+  location?: string;
+  metadata?: HidAccessRecord;
+  payload?: HidAccessRecord;
+  identity?: HidAccessRecord;
+  identityLookup?: HidAccessRecord;
+  rawAccessLog?: HidAccessRecord;
+  reader?: HidAccessRecord;
+  authorization?: HidAccessRecord;
+  data?: HidAccessRecord;
+  result?: HidAccessRecord;
+  values?: HidAccessRecord;
+  access_logs?: HidAccessRecord[];
+  accessLogs?: HidAccessRecord[];
+  object_changes?: unknown[];
+};
+
+type JsPdf = {
+  internal: { pageSize: { getWidth(): number; getHeight(): number } };
+  setFillColor(red: number, green: number, blue: number): void;
+  setDrawColor(red: number, green: number, blue: number): void;
+  setTextColor(red: number, green: number, blue: number): void;
+  setFont(name: string, style: string): void;
+  setFontSize(size: number): void;
+  rect(x: number, y: number, width: number, height: number, style?: string): void;
+  text(value: string | string[], x: number, y: number): void;
+  addPage(): void;
+  splitTextToSize(value: string, width: number): string[];
+  save(filename: string): void;
+};
+
+const {
+  getReaders,
+  getIdentities,
+  getLogs,
+  getUserImage,
+  getReaderUsers,
+  getReaderAccessLogs,
+} = useHidAmico();
 const { getVisitors } = useVisitor();
 
-const readers = ref<Record<string, any>[]>([]);
-const identities = ref<Record<string, any>[]>([]);
-const allIdentities = ref<Record<string, any>[]>([]);
-const visitorRecords = ref<Record<string, any>>({});
-const logs = ref<Record<string, any>[]>([]);
-const liveAccessLogs = ref<Record<string, any>[]>([]);
-const readerConfiguration = ref<Record<string, any>>({});
+const readers = ref<HidAccessRecord[]>([]);
+const identities = ref<HidAccessRecord[]>([]);
+const allIdentities = ref<HidAccessRecord[]>([]);
+const visitorRecords = ref<Record<string, HidAccessRecord>>({});
+const logs = ref<HidAccessRecord[]>([]);
+const liveAccessLogs = ref<HidAccessRecord[]>([]);
 const administratorUserIds = ref<Set<number>>(new Set());
 const userImages = ref<Record<string, string>>({});
 const selectedReaderId = ref("");
@@ -339,6 +387,8 @@ const status = ref("");
 const accessMethod = ref("");
 const page = ref(1);
 const limit = 10;
+const serverPages = ref(1);
+const serverPageRange = ref("");
 const loading = ref(false);
 const loadSequence = ref(0);
 const exportDialog = ref(false);
@@ -490,22 +540,26 @@ const logHeaders = [
   { title: "", value: "action-table", sortable: false },
 ];
 
-const pages = computed(() => Math.max(1, Math.ceil(filteredRows.value.length / limit)));
+const pages = computed(() => Math.max(1, serverPages.value));
 
 const paginatedRows = computed(() => {
-  const currentPage = Math.min(page.value, pages.value);
-  const start = (currentPage - 1) * limit;
-  return filteredRows.value.slice(start, start + limit);
+  return filteredRows.value;
 });
 
 const pageRange = computed(() => {
-  if (!filteredRows.value.length) return "0-0 of 0";
-  const currentPage = Math.min(page.value, pages.value);
-  const start = (currentPage - 1) * limit + 1;
-  const end = Math.min(currentPage * limit, filteredRows.value.length);
-  return `${start}-${end} of ${filteredRows.value.length}`;
+  return serverPageRange.value || (filteredRows.value.length ? `1-${filteredRows.value.length}` : "0-0 of 0");
 });
 
+function goToPage(nextPage: number) {
+  page.value = nextPage;
+  loadDashboard();
+}
+
+function reloadDashboardFromFirstPage() {
+  page.value = 1;
+  loadDashboard();
+}
+
 const exportRowsData = computed(() =>
   getExportSourceRows().filter((row) => {
     const selectedUsers = exportForm.users.filter((user) => user !== "all");
@@ -525,10 +579,6 @@ watch(
   { immediate: true },
 );
 
-watch([search, status, accessMethod, activeTab], () => {
-  page.value = 1;
-});
-
 watch(pages, () => {
   if (page.value > pages.value) page.value = pages.value;
 });
@@ -559,26 +609,47 @@ async function loadDashboard() {
   resetDashboardData();
   try {
     const isVisitorTab = activeTab.value === "visitor";
-    const [identityResponse, logResponse, hidAccessLogs, configurationResponse, roleResponse, visitorResponse, readerUserResponse] = await Promise.all([
+    const [identityResponse, logResponse, hidAccessLogResponse, visitorResponse, readerUserResponse] = await Promise.all([
       loadDashboardSource(
         getIdentities(selectedReaderId.value, {
-          page: 1,
-          limit: 500,
+          page: page.value,
+          limit: 100,
         }),
         null,
         "identities",
       ),
       loadDashboardSource(
         getLogs(selectedReaderId.value, {
-          page: 1,
-          limit: 500,
+          page: page.value,
+          limit,
         }),
         null,
         "persisted access logs",
       ),
-      loadDashboardSource(loadLiveAccessLogs(selectedReaderId.value), [], "live access logs"),
-      loadDashboardSource(loadReaderConfiguration(selectedReaderId.value), {}, "reader configuration"),
-      loadDashboardSource(loadAdministratorRoles(selectedReaderId.value), null, "administrator roles"),
+      loadDashboardSource(
+        getReaderAccessLogs(selectedReaderId.value, {
+          page: page.value,
+          limit,
+          search: search.value.trim(),
+          status: status.value === "Authorized"
+            ? "authorized"
+            : status.value === "Not Authorized"
+              ? "not_authorized"
+              : status.value === "Unknown" ? "unknown" : "",
+          method: accessMethod.value === "Facial"
+            ? "facial"
+            : accessMethod.value === "QR Code"
+              ? "qr_code"
+              : accessMethod.value === "ID and Password"
+                ? "id_password"
+                : accessMethod.value === "PIN"
+                  ? "pin"
+                  : accessMethod.value === "Card" ? "card" : "",
+          tab: activeTab.value,
+        }),
+        { items: [], pages: 1, pageRange: "0-0 of 0" },
+        "live access logs",
+      ),
       isVisitorTab && props.org
         ? loadDashboardSource(
             getVisitors({
@@ -592,25 +663,47 @@ async function loadDashboard() {
             "visitor records",
           )
         : Promise.resolve(null),
-      loadDashboardSource(loadReaderUsers(selectedReaderId.value), [], "reader users"),
+      loadDashboardSource(
+        getReaderUsers(selectedReaderId.value, { page: page.value, limit: 100 }),
+        { items: [] },
+        "reader users",
+      ),
     ]);
 
     if (sequence !== loadSequence.value) return;
 
     const loadedIdentities = identityResponse?.items ?? identityResponse?.data?.items ?? identityResponse?.data?.identities ?? [];
-    const mergedIdentities = mergeReaderUsersWithIdentities(readerUserResponse, loadedIdentities);
+    const liveItems = hidAccessLogResponse?.items ?? hidAccessLogResponse?.data?.items ?? [];
+    const readerUsers = readerUserResponse?.items ?? readerUserResponse?.data?.items ?? [];
+    const embeddedIdentities = liveItems
+      .map((item: Record<string, unknown>) => item.identity)
+      .filter(isUnknownRecord);
+    const mergedIdentities = mergeReaderUsersWithIdentities(
+      readerUsers,
+      [...loadedIdentities, ...embeddedIdentities],
+    );
     const loadedVisitors = visitorResponse?.items ?? visitorResponse?.data?.items ?? visitorResponse?.data?.visitors ?? [];
     visitorRecords.value = Object.fromEntries(
-      loadedVisitors.map((visitor: Record<string, any>) => [String(visitor._id), visitor]),
+      loadedVisitors.map((visitor: HidAccessRecord) => [String(visitor._id), visitor]),
+    );
+    administratorUserIds.value = new Set(
+      [...readerUsers, ...liveItems]
+        .filter((item: Record<string, unknown>) => item.isAdministrator === true)
+        .map((item: Record<string, unknown>) => toHidNumericId(item.hidUserId ?? item.user_id))
+        .filter((userId: number | undefined): userId is number => Boolean(userId)),
     );
-    administratorUserIds.value = getAdministratorRoleUserIds(roleResponse);
     allIdentities.value = mergedIdentities;
     identities.value = mergedIdentities.filter(
       (identity: Record<string, unknown>) => classifyIdentity(identity) === activeTab.value,
     );
-    logs.value = logResponse?.items ?? logResponse?.data?.items ?? logResponse?.data?.logs ?? [];
-    liveAccessLogs.value = hidAccessLogs;
-    readerConfiguration.value = normalizeReaderConfiguration(configurationResponse);
+    logs.value = liveItems.length
+      ? []
+      : logResponse?.items ?? logResponse?.data?.items ?? logResponse?.data?.logs ?? [];
+    liveAccessLogs.value = liveItems;
+    serverPages.value = Number(hidAccessLogResponse?.pages ?? hidAccessLogResponse?.data?.pages ?? 1);
+    serverPageRange.value = String(
+      hidAccessLogResponse?.pageRange ?? hidAccessLogResponse?.data?.pageRange ?? "",
+    );
     await loadUserImages(identities.value);
   } finally {
     if (sequence === loadSequence.value) {
@@ -628,7 +721,7 @@ async function loadDashboardSource<T>(request: Promise<T>, fallback: T, label: s
   }
 }
 
-async function loadUserImages(items: Record<string, any>[]) {
+async function loadUserImages(items: HidAccessRecord[]) {
   if (!selectedReaderId.value) return;
 
   await Promise.all(items.map(async (identity) => {
@@ -648,7 +741,7 @@ async function loadUserImages(items: Record<string, any>[]) {
   }));
 }
 
-function hasHidImageHint(identity: Record<string, any>) {
+function hasHidImageHint(identity: HidAccessRecord) {
   return Boolean(
     identity?.metadata?.imageTimestamp ||
       identity?.metadata?.facialData ||
@@ -660,56 +753,6 @@ function hasHidImageHint(identity: Record<string, any>) {
   );
 }
 
-async function loadLiveAccessLogs(readerId: string) {
-  const allLogs: Record<string, any>[] = [];
-  const limit = 500;
-  const maxPages = 20;
-
-  for (let pageIndex = 0; pageIndex < maxPages; pageIndex += 1) {
-    try {
-      const response = await runObjectOperation(readerId, {
-      operation: "load",
-      object: "access_logs",
-      where: {
-        access_logs: {},
-      },
-        limit,
-        offset: pageIndex * limit,
-      });
-
-      const pageLogs = normalizeHidAccessLogs(response);
-      allLogs.push(...pageLogs);
-
-      if (pageLogs.length < limit) break;
-    } catch (error) {
-      console.warn("Unable to load HID live access logs", error);
-      break;
-    }
-  }
-
-  return dedupeAccessLogs(allLogs).sort((a, b) => {
-    const aTime = parseDate(getAccessLogTime(a, {}))?.getTime() || 0;
-    const bTime = parseDate(getAccessLogTime(b, {}))?.getTime() || 0;
-    return bTime - aTime;
-  });
-}
-
-async function loadReaderConfiguration(readerId: string) {
-  try {
-    return await getReaderConfiguration(readerId, {
-      access_logs: [],
-      event_types: [],
-      log_types: [],
-      identification_rules: [],
-      portals: [],
-      users: [],
-    });
-  } catch (error) {
-    console.warn("Unable to load HID configuration", error);
-    return {};
-  }
-}
-
 async function onTabChange(tab: AccessTab) {
   if (tab) {
     activeTab.value = tab;
@@ -720,48 +763,8 @@ async function onTabChange(tab: AccessTab) {
   loadDashboard();
 }
 
-async function loadReaderUsers(readerId: string) {
-  try {
-    const response = await runObjectOperation(readerId, {
-      operation: "load",
-      object: "users",
-      limit: 500,
-      offset: 0,
-    });
-    return normalizeHidUsers(response);
-  } catch (error) {
-    console.warn("Unable to load HID users for access log images", error);
-    return [];
-  }
-}
-
-function normalizeHidUsers(response: Record<string, any>) {
-  const items =
-    response?.data?.users ||
-    response?.data?.data?.users ||
-    response?.users ||
-    [];
-
-  return Array.isArray(items)
-    ? items.map((user) => ({
-        hidUserId: String(user.id || ""),
-        rawHidUserId: user.id,
-        registration: user.registration,
-        cardNo: user.card_value || user.cardNo || "",
-        name: user.name,
-        hidUserTypeId: user.user_type_id,
-        metadata: {
-          name: user.name,
-          hidUserTypeId: user.user_type_id,
-          imageTimestamp: user.image_timestamp ? String(user.image_timestamp) : "",
-          hidReaderSource: true,
-        },
-      }))
-    : [];
-}
-
-function mergeReaderUsersWithIdentities(readerUsers: Record<string, any>[], identities: Record<string, any>[]) {
-  const identityById = new Map<string, Record<string, any>>();
+function mergeReaderUsersWithIdentities(readerUsers: HidAccessRecord[], identities: HidAccessRecord[]) {
+  const identityById = new Map<string, HidAccessRecord>();
   identities.forEach((identity) => {
     const id = toHidNumericId(identity.hidUserId);
     if (id) identityById.set(String(id), identity);
@@ -799,8 +802,9 @@ function resetDashboardData() {
   visitorRecords.value = {};
   logs.value = [];
   liveAccessLogs.value = [];
-  readerConfiguration.value = {};
   administratorUserIds.value = new Set();
+  serverPages.value = 1;
+  serverPageRange.value = "";
 }
 
 function isVisibleForActiveTab(row: AccessRow) {
@@ -823,35 +827,6 @@ function classifyIdentity(identity?: Record<string, unknown>, row?: AccessRow):
   return "resident";
 }
 
-function loadAdministratorRoles(readerId: string) {
-  return runObjectOperation(readerId, {
-    operation: "load",
-    object: "user_roles",
-    where: {
-      user_roles: {
-        role: 1,
-      },
-    },
-    limit: 500,
-    offset: 0,
-  });
-}
-
-function getAdministratorRoleUserIds(response: Record<string, any> | null) {
-  const data = response?.data || response || {};
-  const roles =
-    data?.user_roles ||
-    data?.data?.user_roles ||
-    data?.result?.user_roles ||
-    [];
-
-  return new Set(
-    (Array.isArray(roles) ? roles : [])
-      .map((role) => toHidNumericId(role.user_id))
-      .filter((userId): userId is number => Boolean(userId)),
-  );
-}
-
 function toHidNumericId(value: unknown) {
   const raw = String(value ?? "").trim();
   if (!raw) return undefined;
@@ -862,7 +837,7 @@ function toHidNumericId(value: unknown) {
   return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
 }
 
-function getIdentityKey(identity: Record<string, any>) {
+function getIdentityKey(identity: HidAccessRecord) {
   return [
     identity.hidUserId,
     identity.registration,
@@ -875,7 +850,7 @@ function findIdentityByKey(identityKey: string) {
   return allIdentities.value.find((identity) => getIdentityKey(identity) === identityKey);
 }
 
-function getLogIdentityKey(log: Record<string, any>) {
+function getLogIdentityKey(log: HidAccessRecord) {
   const identity = log.payload?.identity || {};
   const lookup = log.payload?.identityLookup || {};
   const rawLog = log.payload?.rawAccessLog || log;
@@ -886,20 +861,20 @@ function getLogIdentityKey(log: Record<string, any>) {
   ].filter(Boolean).join("|");
 }
 
-function getName(identity: Record<string, any>) {
+function getName(identity: HidAccessRecord) {
   return getVisitorRecord(identity)?.name || identity.metadata?.name || identity.name || "N/A";
 }
 
-function getFacialData(identity: Record<string, any>) {
+function getFacialData(identity: HidAccessRecord) {
   return identity.metadata?.facialData || identity.metadata?.imageTimestamp || (identity.metadata?.photo ? identity.hidUserId : "N/A");
 }
 
-function getUserImageSrc(identity: Record<string, any>) {
+function getUserImageSrc(identity: HidAccessRecord) {
   const hidUserId = toHidNumericId(identity?.hidUserId);
   return identity?.metadata?.photo || (hidUserId ? userImages.value[String(hidUserId)] : "") || "";
 }
 
-function getUnit(identity: Record<string, any>) {
+function getUnit(identity: HidAccessRecord) {
   const visitor = getVisitorRecord(identity);
   if (visitor) {
     return visitor.unitName || [visitor.block, visitor.level, visitor.unit].filter(Boolean).join("/") || "N/A";
@@ -908,17 +883,22 @@ function getUnit(identity: Record<string, any>) {
   return identity.metadata?.unitLabel || [identity.metadata?.block, identity.metadata?.level, identity.metadata?.unit].filter(Boolean).join("/") || "N/A";
 }
 
-function getVisitorRecord(identity: Record<string, any>) {
+function getVisitorRecord(identity: HidAccessRecord) {
   const visitorId = identity?.visitor;
   return visitorId ? visitorRecords.value[String(visitorId)] : undefined;
 }
 
-function getAccessMethod(identity: Record<string, any>, log?: Record<string, any>) {
+function getAccessMethod(identity: HidAccessRecord, log?: HidAccessRecord) {
   const payload = log?.payload?.rawAccessLog || log?.payload || log || {};
-  const configuredLogType = getConfigurationLabel("log_types", payload.log_type_id || payload.logTypeId);
-  if (configuredLogType) return configuredLogType;
-  const configuredRule = getConfigurationLabel("identification_rules", payload.identification_rule_id || payload.identificationRuleId);
-  if (configuredRule) return configuredRule;
+  const normalizedMethodLabels: Record<string, string> = {
+    facial: "Facial",
+    qr_code: "QR Code",
+    id_password: "ID and Password",
+    pin: "PIN",
+    card: "Card",
+  };
+  const normalizedMethod = String(payload.normalizedMethod || "");
+  if (normalizedMethodLabels[normalizedMethod]) return normalizedMethodLabels[normalizedMethod];
   const rawIdentification = String(payload.identification || payload.identification_type || payload.identificationType || "").toLowerCase();
   if (rawIdentification.includes("facial") || rawIdentification.includes("face")) return "Facial";
   if (payload.qrcode_value || payload.qrCode || payload.qrcode) return "QR Code";
@@ -1122,60 +1102,7 @@ function sortAccessRowsByDateDesc(a: AccessRow, b: AccessRow) {
   return bTime - aTime;
 }
 
-function dedupeAccessLogs(items: Record<string, any>[]) {
-  const seen = new Set<string>();
-  return items.filter((item) => {
-    const key = [
-      item.id,
-      item.time,
-      item.user_id ?? item.userId ?? item.hidUserId,
-      item.card_value ?? item.cardNo,
-    ].join("|");
-
-    if (seen.has(key)) return false;
-    seen.add(key);
-    return true;
-  });
-}
-
-function normalizeHidAccessLogs(response: Record<string, any>) {
-  const data = response?.data || response || {};
-  const accessLogs =
-    data.access_logs ||
-    data.data?.access_logs ||
-    data.accessLogs ||
-    data.data?.accessLogs ||
-    data.result?.access_logs ||
-    data.result?.data?.access_logs;
-
-  return Array.isArray(accessLogs) ? accessLogs : [];
-}
-
-function normalizeReaderConfiguration(response: Record<string, any>) {
-  const data = response?.data || response || {};
-  return data?.data || data?.result || data;
-}
-
-function getConfigurationLabel(section: string, id: unknown) {
-  if (id === undefined || id === null || id === "" || Number(id) === -1) return "";
-  const entries = readerConfiguration.value?.[section];
-  if (!entries) return "";
-
-  const items = Array.isArray(entries)
-    ? entries
-    : typeof entries === "object"
-      ? Object.values(entries)
-      : [];
-
-  const match = items.find((item: any) => {
-    if (!item || typeof item !== "object") return false;
-    return String(item.id ?? item.value ?? item.key ?? item.code) === String(id);
-  }) as Record<string, any> | undefined;
-
-  return match?.name || match?.label || match?.description || match?.title || "";
-}
-
-function getRawAccessLogs(event: Record<string, any>) {
+function getRawAccessLogs(event: HidAccessRecord): HidAccessRecord[] {
   const payload = event.payload || {};
   const result = payload.result || payload.data || {};
   const accessLogs =
@@ -1199,7 +1126,7 @@ function getRawAccessLogs(event: Record<string, any>) {
     : [];
 }
 
-function mapAccessLogToRow(rawLog: Record<string, any>, event: Record<string, any>, index: string): AccessRow {
+function mapAccessLogToRow(rawLog: HidAccessRecord, event: HidAccessRecord, index: string): AccessRow {
   const identity = findIdentityForAccessLog(rawLog, event);
   const eventIdentity = event.payload?.identity || event.payload?.identityLookup || {};
   const rawAccessTime = getAccessLogTime(rawLog, event);
@@ -1225,8 +1152,8 @@ function mapAccessLogToRow(rawLog: Record<string, any>, event: Record<string, an
 }
 
 function getAuthorizationStatus(
-  rawLog: Record<string, any>,
-  event: Record<string, any>,
+  rawLog: HidAccessRecord,
+  event: HidAccessRecord,
 ): Pick<AccessRow, "status" | "authorizationReason"> {
   const authorization = event.payload?.authorization || rawLog.authorization;
   if (typeof authorization?.granted === "boolean") {
@@ -1248,9 +1175,7 @@ function getAuthorizationStatus(
     return { status: "Not Authorized", authorizationReason: "Access denied by HID authorization." };
   }
 
-  const eventLabel = String(
-    getConfigurationLabel("event_types", eventCode) || rawLog.event_name || rawLog.eventName || "",
-  ).toLowerCase();
+  const eventLabel = String(rawLog.event_name || rawLog.eventName || "").toLowerCase();
   if (/not authorized|unauthori[sz]ed|access denied|denied|rejected/.test(eventLabel)) {
     return { status: "Not Authorized", authorizationReason: eventLabel };
   }
@@ -1264,7 +1189,10 @@ function getAuthorizationStatus(
   };
 }
 
-function findIdentityForAccessLog(rawLog: Record<string, any>, event: Record<string, any>) {
+function findIdentityForAccessLog(rawLog: HidAccessRecord, event: HidAccessRecord) {
+  if (rawLog.identity && typeof rawLog.identity === "object") {
+    return rawLog.identity;
+  }
   const eventIdentityId = event.payload?.identity?._id;
   if (eventIdentityId) {
     const byId = allIdentities.value.find((identity) => String(identity._id) === String(eventIdentityId));
@@ -1291,7 +1219,7 @@ function findIdentityForAccessLog(rawLog: Record<string, any>, event: Record<str
   });
 }
 
-function getLatestAccessLogForIdentity(identity: Record<string, any>) {
+function getLatestAccessLogForIdentity(identity: HidAccessRecord) {
   const accessLogs = [
     ...liveAccessLogs.value,
     ...logs.value.flatMap((event) => getRawAccessLogs(event)),
@@ -1306,10 +1234,12 @@ function getLatestAccessLogForIdentity(identity: Record<string, any>) {
     })[0];
 }
 
+function isUnknownRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 function toUnknownRecord(value: unknown): Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value)
-    ? value as Record<string, unknown>
-    : {};
+  return isUnknownRecord(value) ? value : {};
 }
 
 function accessLogMatchesIdentity(log: unknown, identity: unknown) {
@@ -1341,7 +1271,7 @@ function accessLogMatchesIdentity(log: unknown, identity: unknown) {
   );
 }
 
-function getAccessLogIdentityKey(rawLog: Record<string, any>) {
+function getAccessLogIdentityKey(rawLog: HidAccessRecord) {
   return [
     rawLog.user_id ?? rawLog.userId ?? rawLog.hidUserId,
     rawLog.registration,
@@ -1349,11 +1279,11 @@ function getAccessLogIdentityKey(rawLog: Record<string, any>) {
   ].filter(Boolean).join("|");
 }
 
-function getAccessLogTime(rawLog: Record<string, any>, event: Record<string, any>) {
+function getAccessLogTime(rawLog: HidAccessRecord, event: HidAccessRecord) {
   return rawLog.time || rawLog.createdAt || rawLog.accessedAt || event.createdAt;
 }
 
-function getRawLogName(rawLog: Record<string, any>, event: Record<string, any>) {
+function getRawLogName(rawLog: HidAccessRecord, event: HidAccessRecord) {
   return rawLog.name || event.payload?.identity?.name || event.payload?.name || "Unmapped";
 }
 
@@ -1366,12 +1296,12 @@ function getExportSourceRows() {
   return exportScope.value === "history" ? selectedHistoryRows.value : filteredRows.value;
 }
 
-function getLogAccessDateValue(log: Record<string, any>) {
+function getLogAccessDateValue(log: HidAccessRecord) {
   const payload = log.payload || {};
   return log.createdAt || payload.createdAt || payload.accessedAt || payload.time || payload.eventTime;
 }
 
-function getLogReaderLocation(log: Record<string, any>) {
+function getLogReaderLocation(log: HidAccessRecord) {
   return log.payload?.reader?.location || log.payload?.readerLocation || selectedReader.value?.location || "N/A";
 }
 
@@ -1392,7 +1322,7 @@ async function exportRowsAsPdf() {
   pdf.save(`hid-access-log-${activeTab.value}.pdf`);
 }
 
-function drawAccessLogPdf(pdf: any, rows: PdfAccessRow[]) {
+function drawAccessLogPdf(pdf: JsPdf, rows: PdfAccessRow[]) {
   const margin = 12;
   const pageWidth = pdf.internal.pageSize.getWidth();
   const pageHeight = pdf.internal.pageSize.getHeight();