dsh-file-activity 0.5.0 → 0.5.2

package/lib/parts/view.part.js

@@ -1,129 +1,183 @@
-    // ── view component ────────────────────────────────────────────────────
-    /** Shared empty bucket for sessions that have never loaded data (stable ref). */
-    const EMPTY_SESSION = { recent: [], counts: {}, loading: true }
+// ── view component ────────────────────────────────────────────────────
+/** Shared empty bucket for sessions that have never loaded data (stable ref). */
+const EMPTY_SESSION = { recent: [], counts: {}, loading: true }
 
-    /**
-     * Polling loader for one session: fetches stats on mount and on a fixed
-     * interval while visible, prefers the sidebar's authoritative session.cwd
-     * for relative display, and writes results into the per-session bucket.
-     */
-    function useSessionLoader(visible, sessionId, scope, dataStore, setCwd, setError) {
-      useEffect(() => {
-        if (!visible || sessionId === '') return
-        let cancelled = false
-        const load = () => {
-          void fetchStats(sessionId).then((value) => {
-            if (cancelled || value === null) return
-            setCwd((prev) => prev || value.cwd || '')
-            const current = dataStore.getSnapshot()
-            dataStore.set({
-              bySession: {
-                ...(current.bySession ?? {}),
-                [sessionId]: { recent: value.recent ?? [], counts: value.counts ?? {}, loading: false },
+/**
+ * Polling loader for one session: fetches stats on mount and on a fixed
+ * interval while visible, prefers the sidebar's authoritative session.cwd
+ * for relative display, and writes results into the per-session bucket.
+ */
+function useSessionLoader(visible, sessionId, scope, dataStore, setCwd, setError) {
+  useEffect(() => {
+    if (!visible || sessionId === '') return
+    let cancelled = false
+    const load = () => {
+      void fetchStats(sessionId)
+        .then((value) => {
+          if (cancelled || value === null) return
+          setCwd((prev) => prev || value.cwd || '')
+          const current = dataStore.getSnapshot()
+          dataStore.set({
+            bySession: {
+              ...(current.bySession ?? {}),
+              [sessionId]: {
+                recent: value.recent ?? [],
+                counts: value.counts ?? {},
+                loading: false,
               },
-            })
-            setError(false)
-          }).catch(() => {
-            if (!cancelled) setError(true)
+            },
           })
-        }
-        load()
-        void fetchSessionCwd(sessionId).then((cwd) => {
-          if (!cancelled && cwd !== '') setCwd(cwd)
+          setError(false)
+        })
+        .catch(() => {
+          if (!cancelled) setError(true)
         })
-        const timer = window.setInterval(load, POLL_MS)
-        return () => {
-          cancelled = true
-          window.clearInterval(timer)
-        }
-      }, [visible, sessionId, dataStore])
     }
-
-    /** Error banner element, or null when the last load succeeded. */
-    function renderError(error) {
-      if (!error) return null
-      return createElement('div', { style: { color: 'var(--dsw-alias-state-error-primary)', padding: '4px 6px', font: 'var(--dsw-font-xxs-12)' } }, strings.loadError())
+    load()
+    void fetchSessionCwd(sessionId).then((cwd) => {
+      if (!cancelled && cwd !== '') setCwd(cwd)
+    })
+    const timer = window.setInterval(load, POLL_MS)
+    return () => {
+      cancelled = true
+      window.clearInterval(timer)
     }
+  }, [visible, sessionId, dataStore])
+}
 
-    /** "最近访问" section: collapsible head with refresh/clear actions. */
-    function renderRecentSection(recent, recentOpen, onToggle, onRefresh, onClear, onOpen) {
-      return createElement(
-        'div',
-        { className: 'dfa-section' },
+/** Error banner element, or null when the last load succeeded. */
+function renderError(error) {
+  if (!error) return null
+  return createElement(
+    'div',
+    {
+      style: {
+        color: 'var(--dsw-alias-state-error-primary)',
+        padding: '4px 6px',
+        font: 'var(--dsw-font-xxs-12)',
+      },
+    },
+    strings.loadError(),
+  )
+}
+
+/** "最近访问" section: collapsible head with refresh/clear actions. */
+function renderRecentSection(recent, recentOpen, onToggle, onRefresh, onClear, onOpen) {
+  return createElement(
+    'div',
+    { className: 'dfa-section' },
+    createElement(
+      'div',
+      { className: 'dfa-section-head' },
+      createElement(
+        'button',
+        { className: 'dfa-section-head-toggle', onClick: onToggle },
+        recentOpen ? icon.chevronDown(13) : icon.chevronRight(13),
+        strings.recent(),
+      ),
+      createElement(
+        'span',
+        { className: 'dfa-section-head-actions' },
         createElement(
-          'div',
-          { className: 'dfa-section-head' },
-          createElement(
-            'button',
-            { className: 'dfa-section-head-toggle', onClick: onToggle },
-            recentOpen ? icon.chevronDown(13) : icon.chevronRight(13),
-            strings.recent(),
-          ),
-          createElement('span', { className: 'dfa-section-head-actions' },
-            createElement('button', { className: 'dfa-iconbtn dfa-iconbtn-xs', onClick: onRefresh, title: strings.refresh(), 'aria-label': strings.refresh() }, icon.refresh(14)),
-            createElement('button', { className: 'dfa-iconbtn dfa-iconbtn-xs dfa-iconbtn-danger', onClick: onClear, title: strings.clear(), 'aria-label': strings.clear() }, icon.trash(14)),
-          ),
+          'button',
+          {
+            className: 'dfa-iconbtn dfa-iconbtn-xs',
+            onClick: onRefresh,
+            title: strings.refresh(),
+            'aria-label': strings.refresh(),
+          },
+          icon.refresh(14),
         ),
-        !recentOpen ? null : recent.length === 0
-          ? createElement(
-              'div',
-              { className: 'dfa-empty' },
-              strings.empty(),
-              createElement('span', { className: 'dfa-empty-hint' }, strings.emptyHint()),
-            )
-          : createElement('div', { className: 'dfa-list' }, recent.map((entry) => recentEntry(entry, onOpen))),
-      )
-    }
+        createElement(
+          'button',
+          {
+            className: 'dfa-iconbtn dfa-iconbtn-xs dfa-iconbtn-danger',
+            onClick: onClear,
+            title: strings.clear(),
+            'aria-label': strings.clear(),
+          },
+          icon.trash(14),
+        ),
+      ),
+    ),
+    !recentOpen
+      ? null
+      : recent.length === 0
+        ? createElement(
+            'div',
+            { className: 'dfa-empty' },
+            strings.empty(),
+            createElement('span', { className: 'dfa-empty-hint' }, strings.emptyHint()),
+          )
+        : createElement(
+            'div',
+            { className: 'dfa-list' },
+            recent.map((entry) => recentEntry(entry, onOpen)),
+          ),
+  )
+}
 
-    /** "文件统计" section: the directory tree, or an empty hint. */
-    function renderStatsSection(tree, collapsedDirs, onToggleDir, onOpen) {
-      return createElement(
-        'div',
-        { className: 'dfa-section' },
-        createElement('div', { className: 'dfa-section-head' }, strings.stats()),
-        tree.children.length === 0
-          ? createElement('div', { className: 'dfa-empty' }, strings.empty())
-          : createElement('div', { className: 'dfa-list' }, tree.children.map((child) => renderTreeNode(child, 0, collapsedDirs, onToggleDir, onOpen))),
-      )
-    }
+/** "文件统计" section: the directory tree, or an empty hint. */
+function renderStatsSection(tree, collapsedDirs, onToggleDir, onOpen) {
+  return createElement(
+    'div',
+    { className: 'dfa-section' },
+    createElement('div', { className: 'dfa-section-head' }, strings.stats()),
+    tree.children.length === 0
+      ? createElement('div', { className: 'dfa-empty' }, strings.empty())
+      : createElement(
+          'div',
+          { className: 'dfa-list' },
+          tree.children.map((child) => renderTreeNode(child, 0, collapsedDirs, onToggleDir, onOpen)),
+        ),
+  )
+}
 
-    /**
-     * The file-activity tab. Each session renders only its own store bucket:
-     * a fresh conversation shows an empty list immediately, with no residue
-     * from the previous session. Clicking any file opens a FLOATING preview
-     * that reuses the sidebar's NATIVE viewer via matchFileViewer.
-     */
-    function FileActivityView({ ctx, store, scope, visible, dataStore }) {
-      const data = useSyncExternalStore(dataStore.subscribe, dataStore.getSnapshot)
-      const [cwd, setCwd] = useState(scope?.cwd || '')
-      const [error, setError] = useState(false)
-      const [recentOpen, setRecentOpen] = useState(true)
-      const [collapsedDirs, setCollapsedDirs] = useState(() => new Set())
-      const sessionId = scope?.sessionId ?? ''
-      const sessionData = (data.bySession ?? {})[sessionId] ?? EMPTY_SESSION
-      const tree = useMemo(() => buildTree(sessionData.counts ?? {}), [sessionData.counts])
-      useEffect(() => {
-        if (scope?.cwd) setCwd(scope.cwd)
-      }, [scope?.cwd])
-      useSessionLoader(visible, sessionId, scope, dataStore, setCwd, setError)
-      // Switching conversations closes any floating preview left open by the
-      // previous session (preview is shared UI state; session data never
-      // crosses sessions anymore).
-      useEffect(() => {
-        dataStore.set({ preview: null })
-      }, [sessionId, dataStore])
-      const toggleDir = (path) => setCollapsedDirs((prev) => toggleInSet(prev, path))
-      const openPreview = (path) => dataStore.set({ preview: { abs: path, name: basenameOf(path) } })
-      const closePreview = () => dataStore.set({ preview: null })
-      const onClear = () => clearSessionData(dataStore, sessionId)
-      const onRefresh = () => refreshSessionData(dataStore, sessionId, setCwd, setError)
-      const recent = sessionData.recent ?? []
-      return createElement('div', { className: 'dfa' },
-        renderError(error),
-        renderRecentSection(recent, recentOpen, () => setRecentOpen((v) => !v), onRefresh, onClear, openPreview),
-        renderStatsSection(tree, collapsedDirs, toggleDir, openPreview),
-        data.preview
-          ? createElement(FloatingPreview, { ctx, store, scope, preview: data.preview, onClose: closePreview })
-          : null,
-      )
-    }
+/**
+ * The file-activity tab. Each session renders only its own store bucket:
+ * a fresh conversation shows an empty list immediately, with no residue
+ * from the previous session. Clicking any file opens a FLOATING preview
+ * that reuses the sidebar's NATIVE viewer via matchFileViewer.
+ */
+function FileActivityView({ ctx, store, scope, visible, dataStore }) {
+  const data = useSyncExternalStore(dataStore.subscribe, dataStore.getSnapshot)
+  const [cwd, setCwd] = useState(scope?.cwd || '')
+  const [error, setError] = useState(false)
+  const [recentOpen, setRecentOpen] = useState(true)
+  const [collapsedDirs, setCollapsedDirs] = useState(() => new Set())
+  const sessionId = scope?.sessionId ?? ''
+  const sessionData = (data.bySession ?? {})[sessionId] ?? EMPTY_SESSION
+  const tree = useMemo(() => buildTree(sessionData.counts ?? {}), [sessionData.counts])
+  useEffect(() => {
+    if (scope?.cwd) setCwd(scope.cwd)
+  }, [scope?.cwd])
+  useSessionLoader(visible, sessionId, scope, dataStore, setCwd, setError)
+  // Switching conversations closes any floating preview left open by the
+  // previous session (preview is shared UI state; session data never
+  // crosses sessions anymore).
+  useEffect(() => {
+    dataStore.set({ preview: null })
+  }, [sessionId, dataStore])
+  const toggleDir = (path) => setCollapsedDirs((prev) => toggleInSet(prev, path))
+  const openPreview = (path) => dataStore.set({ preview: { abs: path, name: basenameOf(path) } })
+  const closePreview = () => dataStore.set({ preview: null })
+  const onClear = () => clearSessionData(dataStore, sessionId)
+  const onRefresh = () => refreshSessionData(dataStore, sessionId, setCwd, setError)
+  const recent = sessionData.recent ?? []
+  return createElement(
+    'div',
+    { className: 'dfa' },
+    renderError(error),
+    renderRecentSection(recent, recentOpen, () => setRecentOpen((v) => !v), onRefresh, onClear, openPreview),
+    renderStatsSection(tree, collapsedDirs, toggleDir, openPreview),
+    data.preview
+      ? createElement(FloatingPreview, {
+          ctx,
+          store,
+          scope,
+          preview: data.preview,
+          onClose: closePreview,
+        })
+      : null,
+  )
+}

package/lib/state.js

@@ -38,13 +38,17 @@ export async function loadState(file) {
 /** Map a raw operation kind (tool name or client op) to 'read' | 'write' | 'edit' | 'delete'. */
 export function mapOp(op) {
   switch (op) {
-    case 'write': return 'write'
+    case 'write':
+      return 'write'
     case 'edit':
-    case 'str_replace_editor': return 'edit'
-    case 'delete': return 'delete'
+    case 'str_replace_editor':
+      return 'edit'
+    case 'delete':
+      return 'delete'
     case 'read':
     case 'read_image':
-    default: return 'read'
+    default:
+      return 'read'
   }
 }
 
@@ -91,8 +95,9 @@ function pushRecent(recent, path, op, time) {
 
 /** A record target is valid when both ids are non-empty strings (no NUL). */
 function isValidRecordTarget(sessionId, path) {
-  return typeof sessionId === 'string' && sessionId !== ''
-    && typeof path === 'string' && path !== '' && !path.includes('\0')
+  return (
+    typeof sessionId === 'string' && sessionId !== '' && typeof path === 'string' && path !== '' && !path.includes('\0')
+  )
 }
 
 /** 'write' → create/modify by the known-file registry; 'edit' → modify; else read. */
@@ -119,7 +124,8 @@ function bumpCount(counts, finalOp, firstSeen, timestamp) {
  * Returns { state, trimmed } where trimmed reports whether anything changed.
  */
 export function trimLoadedState(loaded) {
-  if (loaded.sessions === undefined || loaded.sessions === null || typeof loaded.sessions !== 'object') loaded.sessions = {}
+  if (loaded.sessions === undefined || loaded.sessions === null || typeof loaded.sessions !== 'object')
+    loaded.sessions = {}
   let trimmed = false
   for (const session of Object.values(loaded.sessions)) {
     if (Array.isArray(session.recent)) {
@@ -150,7 +156,8 @@ export function trimLoadedState(loaded) {
 export function isRecordedPath(state, sessionId, path) {
   const session = state.sessions[sessionId]
   if (session === undefined) return false
-  if (session.counts !== undefined && typeof session.counts[path] === 'object' && session.counts[path] !== null) return true
+  if (session.counts !== undefined && typeof session.counts[path] === 'object' && session.counts[path] !== null)
+    return true
   // Deleted files no longer exist on disk — a delete history entry must not
   // authorize media preview for them.
   if (Array.isArray(session.recent)) return session.recent.some((entry) => entry.path === path && entry.op !== 'delete')

package/lib/store.js

@@ -4,7 +4,7 @@
  * (tmp+rename) and a teardown flush. The exposed store object carries a live
  * `state` reference so route handlers always read the current document.
  */
-import { rename, writeFile } from 'node:fs/promises'
+import { atomicWriteJson } from 'dsh-shared'
 import { applyRecord, createState, loadState, mapOp, stateFile, trimLoadedState } from './state.js'
 
 /** Build the per-apply store: { state, record, schedulePersist, dispose }. */
@@ -30,16 +30,9 @@ export function createStore(ctx) {
 
 /** Write the current state atomically (serialized through dirtyChain). */
 function persistNow(handle) {
-  const snapshot = JSON.stringify(handle.store.state)
-  const tmp = `${handle.file}.tmp-${process.pid}`
-  handle.dirtyChain = handle.dirtyChain.then(async () => {
-    try {
-      await writeFile(tmp, snapshot, 'utf8')
-      await rename(tmp, handle.file)
-    } catch (error) {
-      handle.ctx.logger?.warn(`[dsh-file-activity] persist failed: ${error instanceof Error ? error.message : String(error)}`)
-    }
-  }).catch(() => {})
+  handle.dirtyChain = handle.dirtyChain
+    .then(() => atomicWriteJson(handle.file, handle.store.state, handle.ctx.logger, '[dsh-file-activity]'))
+    .catch(() => {})
 }
 
 /** Debounced (500ms) schedule of a persist. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-file-activity",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "DSH 侧边栏文件活动插件：按 LRU 记录文件读取/新增/修改事件（最近访问），按绝对路径树形统计（文件统计），点击文件浮窗预览（代码高亮/Markdown/图片/PDF）。DSH web plugin: file activity tracker — LRU recent-access list plus per-file read/create/modify counts in a folder tree, with floating preview.",
   "type": "module",
   "main": "lib/index.js",
@@ -46,7 +46,8 @@
   "peerDependencies": {
     "cordis": "^4.0.0-rc.8",
     "dsh-better-sidebar": "^0.14.0",
-    "react": "^18.2.0"
+    "react": "^18.2.0 || ^19.2.0",
+    "dsh-shared": "^0.1.0"
   },
   "peerDependenciesMeta": {
     "dsh-better-sidebar": {

package/lib/fence.js

@@ -1,57 +0,0 @@
-/**
- * Trust fence for /file-activity routes: only loopback / explicitly trusted
- * hosts may call the plugin's HTTP endpoints (same behavioral contract as the
- * /api gateway). 403-refuses everything else, including cross-site requests.
- */
-function header(headers, name) {
-  const value = headers[name]
-  return typeof value === 'string' ? value : undefined
-}
-
-function parseAuthority(authority) {
-  try {
-    return new URL(`http://${authority}`)
-  } catch {
-    return undefined
-  }
-}
-
-function isLoopbackHostname(hostname) {
-  if (hostname === 'localhost' || hostname === '[::1]') return true
-  const parts = hostname.split('.')
-  return parts.length === 4
-    && parts[0] === '127'
-    && parts.every((part) => /^\d{1,3}$/.test(part) && Number(part) <= 255)
-}
-
-function canonicalAuthority(entry, entryUrl) {
-  const port = entryUrl.port !== '' ? entryUrl.port : new URL(`https://${entry}`).port
-  return port === '' ? entryUrl.hostname : `${entryUrl.hostname}:${port}`
-}
-
-function isTrustedAuthority(hostUrl, trustedHosts) {
-  return trustedHosts.some((entry) => {
-    const entryUrl = parseAuthority(entry)
-    if (entryUrl === undefined) return false
-    return canonicalAuthority(entry, entryUrl) === entryUrl.hostname
-      ? entryUrl.hostname === hostUrl.hostname
-      : entryUrl.host === hostUrl.host
-  })
-}
-
-/** Host-header trust fence (same behavioral contract as the /api gateway). */
-export function isTrustedApiRequest(request, trustedHosts) {
-  const host = header(request.headers, 'host')
-  if (host === undefined) return false
-  const hostUrl = parseAuthority(host)
-  if (hostUrl === undefined) return false
-  if (!isLoopbackHostname(hostUrl.hostname) && !isTrustedAuthority(hostUrl, trustedHosts)) return false
-  if (header(request.headers, 'sec-fetch-site') === 'cross-site') return false
-  const origin = header(request.headers, 'origin')
-  if (origin === undefined) return true
-  try {
-    return new URL(origin).host === hostUrl.host
-  } catch {
-    return false
-  }
-}

package/lib/http.js

@@ -1,34 +0,0 @@
-/**
- * HTTP helpers shared by the /file-activity routes: bounded JSON body
- * reading, JSON responses, and session working-directory resolution.
- */
-
-/** Read a JSON request body (bounded). */
-export async function readJsonBody(request) {
-  let body = ''
-  for await (const chunk of request) {
-    body += chunk
-    if (body.length > 1_000_000) throw new Error('request body too large')
-  }
-  if (body === '') return {}
-  return JSON.parse(body)
-}
-
-export function writeJson(response, status, value) {
-  const payload = JSON.stringify(value)
-  response.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-cache' })
-  response.end(payload)
-}
-
-export function writeError(response, error) {
-  const message = error instanceof Error ? error.message : String(error)
-  writeJson(response, 400, { ok: false, error: { message } })
-}
-
-/** Session working directory, mirroring better-sidebar's resolution. */
-export function sessionCwdOf(ctx, sessionId) {
-  const session = ctx.sessions.get(sessionId)
-  const headerCwd = session?.header?.cwd
-  if (typeof headerCwd === 'string' && headerCwd !== '') return headerCwd
-  return process.cwd()
-}

package/lib/parts/icons.part.js

@@ -1,48 +0,0 @@
-    // ── icons (inline, stroke=currentColor, matching better-sidebar) ──────
-    const ICON_STROKE = 1.8
-    const iconSvg = (children, size) =>
-      createElement('svg', {
-        width: size, height: size, viewBox: '0 0 24 24', fill: 'none',
-        stroke: 'currentColor', strokeWidth: ICON_STROKE, strokeLinecap: 'round', strokeLinejoin: 'round',
-        'aria-hidden': 'true',
-      }, children.map((child, i) => (child === null || child === undefined || typeof child === 'boolean')
-        ? child
-        : createElement(child.type, { key: i, ...child.props })))
-
-    const icon = {
-      clock: (size = 16) => iconSvg([
-        createElement('circle', { cx: 12, cy: 12, r: 9 }),
-        createElement('path', { d: 'M12 7v5l3 2' }),
-      ], size),
-      refresh: (size = 16) => iconSvg([
-        createElement('path', { d: 'M21 12a9 9 0 1 1-2.64-6.36' }),
-        createElement('polyline', { points: '21 3 21 9 15 9' }),
-      ], size),
-      trash: (size = 16) => iconSvg([
-        createElement('path', { d: 'M3 6h18' }),
-        createElement('path', { d: 'M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6' }),
-        createElement('path', { d: 'M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2' }),
-      ], size),
-      chevronRight: (size = 14) => iconSvg([
-        createElement('polyline', { points: '9 6 15 12 9 18' }),
-      ], size),
-      chevronDown: (size = 14) => iconSvg([
-        createElement('polyline', { points: '6 9 12 15 18 9' }),
-      ], size),
-      file: (size = 16) => iconSvg([
-        createElement('path', { d: 'M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z' }),
-        createElement('path', { d: 'M14 2v6h6' }),
-      ], size),
-      folder: (size = 16) => iconSvg([
-        createElement('path', { d: 'M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z' }),
-      ], size),
-      external: (size = 15) => iconSvg([
-        createElement('path', { d: 'M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6' }),
-        createElement('polyline', { points: '15 3 21 3 21 9' }),
-        createElement('line', { x1: 10, y1: 14, x2: 21, y2: 3 }),
-      ], size),
-      close: (size = 15) => iconSvg([
-        createElement('line', { x1: 18, y1: 6, x2: 6, y2: 18 }),
-        createElement('line', { x1: 6, y1: 6, x2: 18, y2: 18 }),
-      ], size),
-    }