@byline/host-tanstack-start 3.10.0 → 3.11.0

package/dist/admin-shell/admin-activity/list.d.ts

@@ -0,0 +1,10 @@
+import type { SystemActivityResponse } from '../../server-fns/admin-activity/index.js';
+/**
+ * The system-wide activity report (docs/AUDIT.md — Workstream 4): a paged,
+ * filterable feed over the union of the version stream (content saves) and the
+ * audit log (status / path / locale changes, deletions, and future admin-realm
+ * events). Read-only; gated by `admin.activity.read`.
+ */
+export declare const ActivitySystemView: ({ data }: {
+    data: SystemActivityResponse;
+}) => import("react").JSX.Element;

package/dist/admin-shell/admin-activity/list.js

@@ -0,0 +1,228 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useRouterState } from "@tanstack/react-router";
+import { getClientConfig } from "@byline/core";
+import { useTranslation } from "@byline/i18n/react";
+import { Button, Container, Section, Select, Table } from "@byline/ui/react";
+import classnames from "classnames";
+import { Link, useNavigate } from "../chrome/loose-router.js";
+import { RouterPager } from "../chrome/router-pager.js";
+import list_module from "./list.module.js";
+const ACTION_KEYS = {
+    'document.created': 'activity.actions.created',
+    'document.updated': 'activity.actions.updated',
+    'document.path.changed': 'activity.actions.pathChanged',
+    'document.locales.changed': 'activity.actions.localesChanged',
+    'document.status.changed': 'activity.actions.statusChanged',
+    'document.deleted': 'activity.actions.deleted'
+};
+const ACTION_FILTER_VALUES = [
+    'document.created',
+    'document.updated',
+    'document.status.changed',
+    'document.path.changed',
+    'document.locales.changed',
+    'document.deleted'
+];
+function formatAuditValue(value) {
+    if (null == value) return '—';
+    if (Array.isArray(value)) return value.length > 0 ? value.join(', ') : '—';
+    return String(value);
+}
+const ActivitySystemView = ({ data })=>{
+    const { t } = useTranslation('byline-admin');
+    const navigate = useNavigate();
+    const location = useRouterState({
+        select: (s)=>s.location
+    });
+    const search = location.search;
+    const entries = data?.entries ?? [];
+    const collections = getClientConfig().collections;
+    const applyFilter = (key, value)=>{
+        const params = structuredClone(location.search);
+        params.page = void 0;
+        if ('_all' === value) params[key] = void 0;
+        else params[key] = value;
+        navigate({
+            to: '/admin/activity',
+            search: params
+        });
+    };
+    const collectionItems = [
+        {
+            value: '_all',
+            label: t('activity.filters.allCollections')
+        },
+        ...collections.map((c)=>({
+                value: c.path,
+                label: c.labels?.plural ?? c.path
+            }))
+    ];
+    const actionItems = [
+        {
+            value: '_all',
+            label: t('activity.filters.allActions')
+        },
+        ...ACTION_FILTER_VALUES.map((a)=>({
+                value: a,
+                label: ACTION_KEYS[a] ? t(ACTION_KEYS[a]) : a
+            }))
+    ];
+    const hasFilters = null != search.collection || null != search.action;
+    return /*#__PURE__*/ jsx(Section, {
+        children: /*#__PURE__*/ jsxs(Container, {
+            children: [
+                /*#__PURE__*/ jsx("div", {
+                    className: classnames('byline-activity-head', list_module.head),
+                    children: /*#__PURE__*/ jsx("h1", {
+                        className: classnames('byline-activity-title', list_module.title),
+                        children: t('activity.title')
+                    })
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    className: classnames('byline-activity-options', list_module.options),
+                    children: [
+                        /*#__PURE__*/ jsx(Select, {
+                            id: "activity_collection_filter",
+                            name: "activity_collection_filter",
+                            size: "sm",
+                            value: search.collection ?? '_all',
+                            items: collectionItems,
+                            onValueChange: (v)=>{
+                                if ('string' == typeof v) applyFilter('collection', v);
+                            }
+                        }),
+                        /*#__PURE__*/ jsx(Select, {
+                            id: "activity_action_filter",
+                            name: "activity_action_filter",
+                            size: "sm",
+                            value: search.action ?? '_all',
+                            items: actionItems,
+                            onValueChange: (v)=>{
+                                if ('string' == typeof v) applyFilter('action', v);
+                            }
+                        }),
+                        hasFilters && /*#__PURE__*/ jsx(Button, {
+                            size: "sm",
+                            variant: "text",
+                            onClick: ()=>navigate({
+                                    to: '/admin/activity',
+                                    search: {}
+                                }),
+                            children: t('activity.filters.clear')
+                        }),
+                        /*#__PURE__*/ jsx(RouterPager, {
+                            page: data.meta.page,
+                            count: data.meta.totalPages,
+                            showFirstButton: true,
+                            showLastButton: true,
+                            componentName: "pagerTop",
+                            "aria-label": t('activity.pagerAriaLabel')
+                        })
+                    ]
+                }),
+                0 === entries.length ? /*#__PURE__*/ jsx("p", {
+                    className: classnames('byline-activity-empty', list_module.empty),
+                    children: t('activity.empty')
+                }) : /*#__PURE__*/ jsx(Table.Container, {
+                    className: classnames('byline-activity-table-wrap', list_module.tableWrap),
+                    children: /*#__PURE__*/ jsxs(Table, {
+                        children: [
+                            /*#__PURE__*/ jsx(Table.Header, {
+                                children: /*#__PURE__*/ jsxs(Table.Row, {
+                                    children: [
+                                        /*#__PURE__*/ jsx(Table.HeadingCell, {
+                                            scope: "col",
+                                            children: t('activity.columns.when')
+                                        }),
+                                        /*#__PURE__*/ jsx(Table.HeadingCell, {
+                                            scope: "col",
+                                            children: t('activity.columns.collection')
+                                        }),
+                                        /*#__PURE__*/ jsx(Table.HeadingCell, {
+                                            scope: "col",
+                                            children: t('activity.columns.action')
+                                        }),
+                                        /*#__PURE__*/ jsx(Table.HeadingCell, {
+                                            scope: "col",
+                                            children: t('activity.columns.actor')
+                                        }),
+                                        /*#__PURE__*/ jsx(Table.HeadingCell, {
+                                            scope: "col",
+                                            children: t('activity.columns.change')
+                                        })
+                                    ]
+                                })
+                            }),
+                            /*#__PURE__*/ jsx(Table.Body, {
+                                children: entries.map((entry)=>{
+                                    const actionKey = ACTION_KEYS[entry.action];
+                                    const actionLabel = actionKey ? t(actionKey) : entry.action;
+                                    const actorLabel = null == entry.actorId || 'system' === entry.actorRealm ? t('activity.systemActor') : data.actors?.[entry.actorId]?.label ?? t('activity.formerUser');
+                                    const col = entry.collectionId ? data.collections[entry.collectionId] : void 0;
+                                    const collectionLabel = col?.plural ?? col?.path ?? '—';
+                                    const hasChange = null != entry.before || null != entry.after;
+                                    return /*#__PURE__*/ jsxs(Table.Row, {
+                                        children: [
+                                            /*#__PURE__*/ jsx(Table.Cell, {
+                                                className: classnames('byline-activity-when', list_module.when),
+                                                children: new Date(entry.occurredAt).toLocaleString()
+                                            }),
+                                            /*#__PURE__*/ jsx(Table.Cell, {
+                                                children: null != col && null != entry.documentId ? /*#__PURE__*/ jsx(Link, {
+                                                    to: '/admin/collections/$collection/$id',
+                                                    params: {
+                                                        collection: col.path,
+                                                        id: entry.documentId
+                                                    },
+                                                    children: collectionLabel
+                                                }) : collectionLabel
+                                            }),
+                                            /*#__PURE__*/ jsx(Table.Cell, {
+                                                children: actionLabel
+                                            }),
+                                            /*#__PURE__*/ jsx(Table.Cell, {
+                                                children: actorLabel
+                                            }),
+                                            /*#__PURE__*/ jsx(Table.Cell, {
+                                                className: classnames('byline-activity-change', list_module.change),
+                                                children: hasChange ? /*#__PURE__*/ jsxs(Fragment, {
+                                                    children: [
+                                                        /*#__PURE__*/ jsx("span", {
+                                                            className: classnames('byline-activity-before', list_module.before),
+                                                            children: formatAuditValue(entry.before)
+                                                        }),
+                                                        /*#__PURE__*/ jsx("span", {
+                                                            className: classnames('byline-activity-arrow', list_module.arrow),
+                                                            children: ' → '
+                                                        }),
+                                                        /*#__PURE__*/ jsx("span", {
+                                                            className: classnames('byline-activity-after', list_module.after),
+                                                            children: formatAuditValue(entry.after)
+                                                        })
+                                                    ]
+                                                }) : '—'
+                                            })
+                                        ]
+                                    }, entry.id);
+                                })
+                            })
+                        ]
+                    })
+                }),
+                /*#__PURE__*/ jsx("div", {
+                    className: classnames('byline-activity-options', list_module.options),
+                    children: /*#__PURE__*/ jsx(RouterPager, {
+                        page: data.meta.page,
+                        count: data.meta.totalPages,
+                        showFirstButton: true,
+                        showLastButton: true,
+                        componentName: "pagerBottom",
+                        "aria-label": t('activity.pagerAriaLabel')
+                    })
+                })
+            ]
+        })
+    });
+};
+export { ActivitySystemView };

package/dist/admin-shell/admin-activity/list.module.js

@@ -0,0 +1,12 @@
+import "./list_module.css";
+const list_module = {
+    head: "head-kI5Xwr",
+    title: "title-ealGXb",
+    options: "options-phg69k",
+    empty: "empty-abhubg",
+    tableWrap: "tableWrap-VncCtZ",
+    when: "when-LlN6zo",
+    change: "change-jeXuPf",
+    arrow: "arrow-W5ERDF"
+};
+export default list_module;

package/dist/admin-shell/admin-activity/list_module.css

@@ -0,0 +1,45 @@
+:is(.head-kI5Xwr, .byline-activity-head) {
+  margin-bottom: .5rem;
+}
+
+:is(.title-ealGXb, .byline-activity-title) {
+  font-size: 1.25rem;
+  font-weight: 600;
+}
+
+:is(.options-phg69k, .byline-activity-options) {
+  flex-wrap: wrap;
+  align-items: center;
+  gap: .5rem;
+  margin: .75rem 0;
+  display: flex;
+}
+
+:is(.empty-abhubg, .byline-activity-empty) {
+  color: var(--gray-500);
+  margin: 1.5rem 0;
+  font-size: .875rem;
+}
+
+:is(:is([data-theme="dark"], .dark) .empty-abhubg, :is([data-theme="dark"], .dark) .byline-activity-empty) {
+  color: var(--gray-400);
+}
+
+:is(.tableWrap-VncCtZ, .byline-activity-table-wrap) {
+  margin-top: .5rem;
+  margin-bottom: .75rem;
+}
+
+:is(.when-LlN6zo, .byline-activity-when) {
+  white-space: nowrap;
+  font-variant-numeric: tabular-nums;
+}
+
+:is(.change-jeXuPf, .byline-activity-change) {
+  font-variant-numeric: tabular-nums;
+}
+
+:is(.arrow-W5ERDF, .byline-activity-arrow) {
+  color: var(--gray-400);
+}
+

package/dist/admin-shell/chrome/menu-drawer.js

@@ -1,10 +1,11 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useRouterState } from "@tanstack/react-router";
+import { ADMIN_ACTIVITY_ABILITIES } from "@byline/admin/admin-activity";
 import { ADMIN_PERMISSIONS_ABILITIES } from "@byline/admin/admin-permissions";
 import { ADMIN_ROLES_ABILITIES } from "@byline/admin/admin-roles";
 import { ADMIN_USERS_ABILITIES } from "@byline/admin/admin-users";
 import { useTranslation } from "@byline/i18n/react";
-import { HomeIcon, RolesIcon, SettingsSlidersIcon, UserIcon, UsersIcon } from "@byline/ui/react";
+import { ActivityIcon, HomeIcon, RolesIcon, SettingsSlidersIcon, Tooltip, UserIcon, UsersIcon } from "@byline/ui/react";
 import classnames from "classnames";
 import { useSwipeable } from "react-swipeable";
 import { useAbilities } from "../../integrations/abilities.js";
@@ -17,6 +18,10 @@ const isActive = (currentPath, linkHref)=>{
     return currentPath.startsWith(linkHref);
 };
 function MenuItem({ to, label, icon, pathname, compact }) {
+    const iconSpan = /*#__PURE__*/ jsx("span", {
+        className: "icon",
+        children: icon
+    });
     return /*#__PURE__*/ jsx("li", {
         className: classnames('menu-item', {
             active: isActive(pathname, to),
@@ -25,10 +30,11 @@ function MenuItem({ to, label, icon, pathname, compact }) {
         children: /*#__PURE__*/ jsxs(Link, {
             to: to,
             children: [
-                /*#__PURE__*/ jsx("span", {
-                    className: "icon",
-                    children: icon
-                }),
+                compact ? /*#__PURE__*/ jsx(Tooltip, {
+                    text: label,
+                    side: "right",
+                    children: iconSpan
+                }) : iconSpan,
                 /*#__PURE__*/ jsx("span", {
                     className: "label",
                     children: label
@@ -47,7 +53,8 @@ function AdminMenuDrawer() {
     const canReadUsers = has(ADMIN_USERS_ABILITIES.read);
     const canReadRoles = has(ADMIN_ROLES_ABILITIES.read);
     const canReadPermissions = has(ADMIN_PERMISSIONS_ABILITIES.read);
-    const showAdminSection = canReadUsers || canReadRoles || canReadPermissions;
+    const canReadActivity = has(ADMIN_ACTIVITY_ABILITIES.read);
+    const showAdminSection = canReadUsers || canReadRoles || canReadPermissions || canReadActivity;
     const handlers = useSwipeable({
         onSwipedLeft: ()=>{
             closeDrawer();
@@ -119,6 +126,16 @@ function AdminMenuDrawer() {
                                 }),
                                 pathname: pathname,
                                 compact: compact
+                            }),
+                            canReadActivity && /*#__PURE__*/ jsx(MenuItem, {
+                                to: "/admin/activity",
+                                label: t('chrome.menu.activity'),
+                                icon: /*#__PURE__*/ jsx(ActivityIcon, {
+                                    width: "20px",
+                                    height: "20px"
+                                }),
+                                pathname: pathname,
+                                compact: compact
                             })
                         ]
                     }),

package/dist/admin-shell/chrome/preview-toggle.js

@@ -1,7 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { useTranslation } from "@byline/i18n/react";
-import { EyeClosedIcon, EyeOpenIcon } from "@byline/ui/react";
+import { EyeClosedIcon, EyeOpenIcon, Tooltip } from "@byline/ui/react";
 import classnames from "classnames";
 import { disablePreviewModeFn, enablePreviewModeFn, getPreviewStateFn } from "../../server-fns/preview/index.js";
 function PreviewToggle({ compact }) {
@@ -50,6 +50,10 @@ function PreviewToggle({ compact }) {
         width: "20px",
         height: "20px"
     });
+    const iconSpan = /*#__PURE__*/ jsx("span", {
+        className: "icon",
+        children: icon
+    });
     return /*#__PURE__*/ jsx("li", {
         className: classnames('menu-item byline-preview-toggle', {
             compact,
@@ -60,12 +64,13 @@ function PreviewToggle({ compact }) {
             onClick: handleToggle,
             disabled: busy,
             "aria-label": preview ? t('chrome.preview.disableAriaLabel') : t('chrome.preview.enableAriaLabel'),
-            title: preview ? t('chrome.preview.onTitle') : t('chrome.preview.offTitle'),
+            title: compact ? void 0 : preview ? t('chrome.preview.onTitle') : t('chrome.preview.offTitle'),
             children: [
-                /*#__PURE__*/ jsx("span", {
-                    className: "icon",
-                    children: icon
-                }),
+                compact ? /*#__PURE__*/ jsx(Tooltip, {
+                    text: label,
+                    side: "right",
+                    children: iconSpan
+                }) : iconSpan,
                 /*#__PURE__*/ jsx("span", {
                     className: "label",
                     children: label

package/dist/routes/create-admin-activity-route.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+export declare function createAdminActivityRoute(path: string): any;

package/dist/routes/create-admin-activity-route.js

@@ -0,0 +1,71 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { createFileRoute } from "@tanstack/react-router";
+import { useTranslation } from "@byline/i18n/react";
+import { z } from "zod";
+import { ActivitySystemView } from "../admin-shell/admin-activity/list.js";
+import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
+import { getSystemActivityLog } from "../server-fns/admin-activity/index.js";
+const searchSchema = z.object({
+    page: z.coerce.number().int().min(1).optional(),
+    page_size: z.coerce.number().int().min(1).max(100).optional(),
+    collection: z.string().optional(),
+    action: z.string().optional(),
+    actorId: z.string().optional(),
+    from: z.string().optional(),
+    to: z.string().optional()
+});
+function createAdminActivityRoute(path) {
+    const Route = createFileRoute(path)({
+        validateSearch: searchSchema,
+        loaderDeps: ({ search })=>({
+                page: search.page,
+                page_size: search.page_size,
+                collection: search.collection,
+                action: search.action,
+                actorId: search.actorId,
+                from: search.from,
+                to: search.to
+            }),
+        loader: async ({ deps })=>{
+            const data = await getSystemActivityLog({
+                data: {
+                    page: deps.page,
+                    page_size: deps.page_size,
+                    collection: deps.collection,
+                    action: deps.action,
+                    actorId: deps.actorId,
+                    from: deps.from,
+                    to: deps.to
+                }
+            });
+            return {
+                data
+            };
+        },
+        component: function() {
+            const { data } = Route.useLoaderData();
+            const { t } = useTranslation('byline-admin');
+            return /*#__PURE__*/ jsxs(Fragment, {
+                children: [
+                    /*#__PURE__*/ jsx(BreadcrumbsClient, {
+                        breadcrumbs: [
+                            {
+                                label: t('chrome.menu.dashboard'),
+                                href: '/admin'
+                            },
+                            {
+                                label: t('activity.title'),
+                                href: '/admin/activity'
+                            }
+                        ]
+                    }),
+                    /*#__PURE__*/ jsx(ActivitySystemView, {
+                        data: data
+                    })
+                ]
+            });
+        }
+    });
+    return Route;
+}
+export { createAdminActivityRoute };

package/dist/routes/index.d.ts

@@ -19,6 +19,7 @@
  * locales) take a second `opts` argument.
  */
 export { createAdminAccountRoute } from './create-admin-account-route.js';
+export { createAdminActivityRoute } from './create-admin-activity-route.js';
 export { createAdminDashboardRoute } from './create-admin-dashboard-route.js';
 export { createAdminLayoutRoute } from './create-admin-layout-route.js';
 export { createAdminPermissionsRoute } from './create-admin-permissions-route.js';

package/dist/routes/index.js

@@ -1,4 +1,5 @@
 export { createAdminAccountRoute } from "./create-admin-account-route.js";
+export { createAdminActivityRoute } from "./create-admin-activity-route.js";
 export { createAdminDashboardRoute } from "./create-admin-dashboard-route.js";
 export { createAdminLayoutRoute } from "./create-admin-layout-route.js";
 export { createAdminPermissionsRoute } from "./create-admin-permissions-route.js";

package/dist/server-fns/admin-account/change-password.js

@@ -4,7 +4,7 @@ import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { bylineCore } from "../../integrations/byline-core.js";
 const changeAccountPassword = createServerFn({
     method: 'POST'
-}).inputValidator((input)=>input).handler(async ({ data })=>{
+}).validator((input)=>input).handler(async ({ data })=>{
     const context = await getAdminRequestContext();
     return changeAccountPasswordCommand(context, data, {
         store: bylineCore().adminStore

package/dist/server-fns/admin-account/get.js

@@ -4,7 +4,7 @@ import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { bylineCore } from "../../integrations/byline-core.js";
 const getAccount = createServerFn({
     method: 'GET'
-}).inputValidator((input)=>input ?? {}).handler(async ({ data })=>{
+}).validator((input)=>input ?? {}).handler(async ({ data })=>{
     const context = await getAdminRequestContext();
     return getAccountCommand(context, data, {
         store: bylineCore().adminStore

package/dist/server-fns/admin-account/update.js

@@ -4,7 +4,7 @@ import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { bylineCore } from "../../integrations/byline-core.js";
 const updateAccount = createServerFn({
     method: 'POST'
-}).inputValidator((input)=>input).handler(async ({ data })=>{
+}).validator((input)=>input).handler(async ({ data })=>{
     const context = await getAdminRequestContext();
     return updateAccountCommand(context, data, {
         store: bylineCore().adminStore

package/dist/server-fns/admin-activity/get.d.ts

@@ -0,0 +1,50 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { type ActorLabelMap } from '../collections/actors.js';
+import type { AuditLogEntryDto } from '../collections/audit.js';
+/** Filters for the activity feed. `from` / `to` are ISO strings over the wire. */
+export interface SystemActivitySearchParams {
+    actorId?: string;
+    /** Collection **path** (the admin works in paths; the handler resolves it to the stored collection id). */
+    collection?: string;
+    action?: string;
+    from?: string;
+    to?: string;
+    page?: number;
+    page_size?: number;
+}
+/** Collection display info, captured at query time (a row may name a collection that was later renamed/removed). */
+export interface ActivityCollectionInfo {
+    path: string;
+    singular: string;
+    plural: string;
+}
+export type ActivityCollectionMap = Record<string, ActivityCollectionInfo>;
+export interface SystemActivityResponse {
+    entries: AuditLogEntryDto[];
+    meta: {
+        total: number;
+        page: number;
+        pageSize: number;
+        totalPages: number;
+    };
+    /** Acting-user id → display label. Absent ids (system rows, deleted users) render a tombstone. */
+    actors: ActorLabelMap;
+    /** Collection id → display info. Absent ids name a removed collection. */
+    collections: ActivityCollectionMap;
+}
+/**
+ * The system-wide activity feed: the union of the version stream (content
+ * saves) and the audit log (status / path / locale changes, deletions, and
+ * future admin-realm events). Unlike the per-document audit fn, this is NOT
+ * routed through `CollectionHandle` — it is cross-collection and includes
+ * admin-realm rows with no `document_id`, so it reads the adapter's audit
+ * queries directly and is gated system-wide by `admin.activity.read` rather
+ * than by any document's own read gate.
+ */
+export declare const getSystemActivityLog: import("@tanstack/react-start").RequiredFetcher<undefined, (input: SystemActivitySearchParams) => SystemActivitySearchParams, Promise<SystemActivityResponse>>;

package/dist/server-fns/admin-activity/get.js

@@ -0,0 +1,71 @@
+import { createServerFn } from "@tanstack/react-start";
+import { assertAdminActor } from "@byline/admin";
+import { ADMIN_ACTIVITY_ABILITIES } from "@byline/admin/admin-activity";
+import { ERR_AUDIT_UNSUPPORTED, getLogger, getServerConfig } from "@byline/core";
+import { getAdminRequestContext } from "../../auth/auth-context.js";
+import { resolveActorLabels } from "../collections/actors.js";
+const getSystemActivityLog = createServerFn({
+    method: 'GET'
+}).validator((input)=>input ?? {}).handler(async ({ data })=>{
+    const context = await getAdminRequestContext();
+    assertAdminActor(context, ADMIN_ACTIVITY_ABILITIES.read);
+    const queries = getServerConfig().db.queries;
+    if (null == queries.audit) throw ERR_AUDIT_UNSUPPORTED({
+        message: 'the configured db adapter does not support audit-log reads (queries.audit)'
+    }).log(getLogger());
+    let collectionId;
+    if (data.collection) {
+        const col = await queries.collections.getCollectionByPath(data.collection);
+        collectionId = col?.id;
+        if (null == collectionId) return {
+            entries: [],
+            meta: {
+                total: 0,
+                page: 1,
+                pageSize: 0,
+                totalPages: 0
+            },
+            actors: {},
+            collections: {}
+        };
+    }
+    const result = await queries.audit.findAuditLog({
+        actorId: data.actorId,
+        collectionId,
+        action: data.action,
+        from: data.from ? new Date(data.from) : void 0,
+        to: data.to ? new Date(data.to) : void 0,
+        page: data.page,
+        page_size: data.page_size
+    });
+    const actors = await resolveActorLabels(result.entries.map((e)=>e.actorId));
+    const collections = {};
+    const collectionIds = new Set(result.entries.map((e)=>e.collectionId).filter((id)=>null != id));
+    if (collectionIds.size > 0) {
+        const all = await queries.collections.getAllCollections();
+        for (const c of all)if (collectionIds.has(c.id)) collections[c.id] = {
+            path: c.path,
+            singular: c.singular,
+            plural: c.plural
+        };
+    }
+    const entries = result.entries.map((e)=>({
+            id: e.id,
+            documentId: e.documentId,
+            collectionId: e.collectionId,
+            actorId: e.actorId,
+            actorRealm: e.actorRealm,
+            action: e.action,
+            field: e.field,
+            before: e.before,
+            after: e.after,
+            occurredAt: e.occurredAt instanceof Date ? e.occurredAt.toISOString() : String(e.occurredAt)
+        }));
+    return {
+        entries,
+        meta: result.meta,
+        actors,
+        collections
+    };
+});
+export { getSystemActivityLog };