@byline/host-tanstack-start 4.15.0 → 4.17.0

package/src/admin-shell/chrome/admin-menu-drawer.tsx

@@ -13,12 +13,14 @@ 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 { collectionAbilityKey, getAdminConfig } from '@byline/core'
+import { ANALYTICS_ABILITIES } from '@byline/admin/analytics'
+import { documentAbilityKey, getAdminConfig } from '@byline/core'
 import { useTranslation } from '@byline/i18n/react'
 import {
   ActivityIcon,
+  AnalyticsIcon,
   CalendarIcon,
-  HomeIcon,
+  DashboardIcon,
   RolesIcon,
   SettingsSlidersIcon,
   Tooltip,
@@ -78,8 +80,10 @@ function MenuItem({ to, label, icon, pathname, compact }: MenuItemProps) {
 }
 
 export function AdminMenuDrawer({
+  analyticsEnabled = false,
   scheduledPublicationEnabled = false,
 }: {
+  analyticsEnabled?: boolean
   scheduledPublicationEnabled?: boolean
 }): React.JSX.Element | null {
   const pathname = useRouterState({ select: (s) => s.location.pathname })
@@ -96,12 +100,13 @@ export function AdminMenuDrawer({
   const canReadRoles = has(ADMIN_ROLES_ABILITIES.read)
   const canReadPermissions = has(ADMIN_PERMISSIONS_ABILITIES.read)
   const canReadActivity = has(ADMIN_ACTIVITY_ABILITIES.read)
+  const canReadAnalytics = analyticsEnabled && has(ANALYTICS_ABILITIES.read)
   const canSeeScheduledPublications =
     scheduledPublicationEnabled &&
     getAdminConfig().collections.some(
       (collection) =>
-        has(collectionAbilityKey(collection.path, 'changeStatus')) &&
-        has(collectionAbilityKey(collection.path, 'publish'))
+        has(documentAbilityKey(collection, 'changeStatus')) &&
+        has(documentAbilityKey(collection, 'publish'))
     )
   const showAdminSection = canReadUsers || canReadRoles || canReadPermissions || canReadActivity
 
@@ -139,10 +144,19 @@ export function AdminMenuDrawer({
           <MenuItem
             to={getAdminRoutePath()}
             label={t('chrome.menu.dashboard')}
-            icon={<HomeIcon width="20px" height="20px" />}
+            icon={<DashboardIcon width="20px" height="20px" />}
             pathname={pathname}
             compact={compact}
           />
+          {canReadAnalytics && (
+            <MenuItem
+              to={getAdminRoutePath('analytics')}
+              label={t('chrome.menu.analytics')}
+              icon={<AnalyticsIcon width="20px" height="20px" />}
+              pathname={pathname}
+              compact={compact}
+            />
+          )}
           {canSeeScheduledPublications && (
             <MenuItem
               to={getAdminRoutePath('scheduled-publications')}

package/src/admin-shell/chrome/dashboard.test.tsx

@@ -0,0 +1,199 @@
+/**
+ * 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 React from 'react'
+import { act } from 'react'
+
+import { defineAdminConfig, defineSingleton, type MultiCollectionDefinition } from '@byline/core'
+import { createRoot } from 'react-dom/client'
+import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'
+
+const abilityState = vi.hoisted(() => ({
+  isSuperAdmin: false,
+  abilities: [] as string[],
+}))
+
+vi.mock('../../integrations/abilities.jsx', () => ({
+  useAbilities: () => ({
+    isSuperAdmin: abilityState.isSuperAdmin,
+    abilities: abilityState.abilities,
+    has: () => false,
+    hasAny: () => false,
+  }),
+}))
+
+vi.mock('@byline/i18n/react', () => ({
+  useTranslation: () => ({
+    t: (key: string, values?: Record<string, string | number>) => {
+      if (key === 'dashboard.totalCount') return `${values?.count} total`
+      if (key === 'dashboard.collectionDescription') return `Manage ${values?.label}`
+      return key
+    },
+  }),
+}))
+
+vi.mock('@byline/ui/react', () => {
+  type Props = { children?: React.ReactNode; className?: string }
+  const element = (tag: keyof React.JSX.IntrinsicElements) =>
+    function Element({ children, ...props }: Props) {
+      const Component = tag
+      return <Component {...props}>{children}</Component>
+    }
+  const Card = element('article') as ReturnType<typeof element> & {
+    Header: ReturnType<typeof element>
+    Title: ReturnType<typeof element>
+    Description: ReturnType<typeof element>
+    Content: ReturnType<typeof element>
+  }
+  Card.Header = element('header')
+  Card.Title = element('h3')
+  Card.Description = element('p')
+  Card.Content = element('div')
+  return { Card, Container: element('div'), Section: element('section') }
+})
+
+vi.mock('./loose-router.js', () => ({
+  Link: ({
+    to = '',
+    params = {},
+    search: _search,
+    children,
+    ...props
+  }: React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    to?: string
+    params?: Record<string, string>
+    search?: unknown
+  }) => {
+    let href = to
+    for (const [name, value] of Object.entries(params)) {
+      href = href.replace(`$${name}`, value)
+    }
+    return (
+      <a href={href} {...props}>
+        {children}
+      </a>
+    )
+  },
+}))
+
+import { AdminDashboard } from './dashboard.js'
+
+const articles: MultiCollectionDefinition = {
+  path: 'articles',
+  labels: { singular: 'Article', plural: 'Articles' },
+  fields: [{ name: 'title', label: 'Title', type: 'text' }],
+  showStats: true,
+}
+
+const settings = defineSingleton({
+  path: 'site-settings',
+  label: 'Site settings',
+  fields: [{ name: 'title', label: 'Title', type: 'text' }],
+})
+
+function renderDashboard(statsMap: Record<string, Array<{ status: string; count: number }>> = {}) {
+  const container = document.createElement('div')
+  document.body.append(container)
+  const root = createRoot(container)
+  act(() => root.render(<AdminDashboard statsMap={statsMap} />))
+  return {
+    container,
+    dispose() {
+      act(() => root.unmount())
+      container.remove()
+    },
+  }
+}
+
+describe('AdminDashboard document resources', () => {
+  beforeAll(() => {
+    ;(
+      globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT?: boolean }
+    ).IS_REACT_ACT_ENVIRONMENT = true
+  })
+
+  afterAll(() => {
+    delete (globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT?: boolean })
+      .IS_REACT_ACT_ENVIRONMENT
+  })
+
+  beforeEach(() => {
+    abilityState.isSuperAdmin = false
+    abilityState.abilities = []
+    defineAdminConfig({
+      routes: { admin: '/internal/cms' },
+      collections: [articles, settings],
+      admin: [
+        { slug: articles.path, group: 'content' },
+        { singleton: true, slug: settings.path, group: 'content' },
+      ],
+      collectionGroups: [{ name: 'content', label: 'Content' }],
+      i18n: {
+        admin: { defaultLocale: 'en', locales: [] },
+        content: { defaultLocale: 'en', locales: [] },
+      },
+    })
+  })
+
+  it('shows a singleton only for its kind-aware read ability', () => {
+    abilityState.abilities = ['singletons.site-settings.read']
+    const allowed = renderDashboard()
+    expect(allowed.container.textContent).toContain('Site settings')
+    expect(allowed.container.textContent).not.toContain('Articles')
+    allowed.dispose()
+
+    abilityState.abilities = ['collections.site-settings.read']
+    const staleNamespace = renderDashboard()
+    expect(staleNamespace.container.textContent).not.toContain('Site settings')
+    staleNamespace.dispose()
+  })
+
+  it('shows both resource kinds to a super admin in registry order', () => {
+    abilityState.isSuperAdmin = true
+    const view = renderDashboard({ articles: [{ status: 'draft', count: 3 }] })
+
+    const titles = [...view.container.querySelectorAll('.byline-dashboard-title-text')].map(
+      (element) => element.textContent
+    )
+    expect(titles).toEqual(['Articles', 'Site settings'])
+    expect(view.container.querySelector('.byline-dashboard-group-heading')?.textContent).toBe(
+      'Content'
+    )
+    view.dispose()
+  })
+
+  it('links a singleton under the custom admin base without collection stats', () => {
+    abilityState.isSuperAdmin = true
+    const view = renderDashboard({
+      articles: [{ status: 'draft', count: 3 }],
+      'site-settings': [{ status: 'published', count: 99 }],
+    })
+
+    const link = view.container.querySelector<HTMLAnchorElement>(
+      'a[href="/internal/cms/singletons/site-settings"]'
+    )
+    const card = link?.closest('article')
+    expect(link).not.toBeNull()
+    expect(card?.querySelector('.byline-dashboard-stat-tile')).toBeNull()
+    expect(card?.querySelector('.byline-dashboard-title-meta')).toBeNull()
+    expect(card?.textContent).not.toContain('99')
+    expect(card?.textContent?.match(/Manage Site settings/g)).toHaveLength(1)
+    expect(
+      view.container.querySelector('a[href="/internal/cms/collections/articles"]')
+    ).not.toBeNull()
+    expect(view.container.querySelector('.byline-dashboard-stat-tile')).not.toBeNull()
+    view.dispose()
+  })
+
+  it('hides an update-only singleton role from the dashboard', () => {
+    abilityState.abilities = ['singletons.site-settings.update']
+    const view = renderDashboard()
+    expect(view.container.textContent).not.toContain('Site settings')
+    view.dispose()
+  })
+})

package/src/admin-shell/chrome/dashboard.tsx

@@ -6,12 +6,13 @@
  * Copyright (c) Infonomic Company Limited
  */
 
-import type { CollectionDefinition, WorkflowStatus } from '@byline/core'
+import type { MultiCollectionDefinition, SingletonDefinition, WorkflowStatus } from '@byline/core'
 import {
   filterReadableCollections,
   getAdminConfig,
   getWorkflowStatuses,
   groupCollectionsForAdmin,
+  isSingleton,
 } from '@byline/core'
 import { useTranslation } from '@byline/i18n/react'
 import { Card, Container, Section } from '@byline/ui/react'
@@ -68,7 +69,7 @@ function CollectionCard({
   collection,
   stats,
 }: {
-  collection: CollectionDefinition
+  collection: MultiCollectionDefinition
   stats: CollectionStatusCount[] | undefined
 }) {
   const { t } = useTranslation('byline-admin')
@@ -134,6 +135,35 @@ function CollectionCard({
   )
 }
 
+function SingletonCard({ singleton }: { singleton: SingletonDefinition }) {
+  const { t } = useTranslation('byline-admin')
+  const destination = getAdminRoutePath('singletons', '$singleton')
+  const params = { singleton: singleton.path }
+
+  return (
+    <Card>
+      <Link
+        to={destination}
+        params={params}
+        className={cx('byline-dashboard-card-link', styles.cardLink)}
+      >
+        <Card.Header>
+          <div className={cx('byline-dashboard-card-header', styles.cardHeader)}>
+            <Card.Title className={cx('byline-dashboard-card-title', styles.cardTitle)}>
+              <span className={cx('byline-dashboard-title-text', styles.titleText)}>
+                {singleton.label}
+              </span>
+            </Card.Title>
+            <Card.Description className="muted">
+              {t('dashboard.collectionDescription', { label: singleton.label })}
+            </Card.Description>
+          </div>
+        </Card.Header>
+      </Link>
+    </Card>
+  )
+}
+
 interface AdminDashboardProps {
   statsMap: Record<string, CollectionStatusCount[]>
 }
@@ -173,13 +203,17 @@ export function AdminDashboard({ statsMap }: AdminDashboardProps) {
               </h2>
             )}
             <div className={cx('byline-dashboard-grid', styles.grid)}>
-              {bucket.collections.map((collection) => (
-                <CollectionCard
-                  key={collection.path}
-                  collection={collection}
-                  stats={statsMap[collection.path]}
-                />
-              ))}
+              {bucket.collections.map((resource) =>
+                isSingleton(resource) ? (
+                  <SingletonCard key={resource.path} singleton={resource} />
+                ) : (
+                  <CollectionCard
+                    key={resource.path}
+                    collection={resource}
+                    stats={statsMap[resource.path]}
+                  />
+                )
+              )}
             </div>
           </section>
         ))}

package/src/admin-shell/collections/api.tsx

@@ -6,7 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 
-import type { CollectionDefinition } from '@byline/core'
+import type { MultiCollectionDefinition } from '@byline/core'
 import type { AnyCollectionSchemaTypes } from '@byline/core/zod-schemas'
 import { useTranslation } from '@byline/i18n/react'
 import { Container, Section } from '@byline/ui/react'
@@ -32,7 +32,7 @@ export const ApiView = ({
   contentLocales,
   defaultContentLocale,
 }: {
-  collectionDefinition: CollectionDefinition
+  collectionDefinition: MultiCollectionDefinition
   initialData: AnyCollectionSchemaTypes['UpdateType']
   /** Currently active locale from the route search param (undefined → all). */
   locale?: string

package/src/admin-shell/collections/create.tsx

@@ -9,7 +9,7 @@
 import { useState } from 'react'
 
 import { FormRenderer } from '@byline/admin/react'
-import type { CollectionAdminConfig, CollectionDefinition } from '@byline/core'
+import type { CollectionAdminConfig, MultiCollectionDefinition } from '@byline/core'
 import { useTranslation } from '@byline/i18n/react'
 import { Container, Section, useToastManager } from '@byline/ui/react'
 
@@ -30,7 +30,7 @@ export const CreateView = ({
   initialData,
   from,
 }: {
-  collectionDefinition: CollectionDefinition
+  collectionDefinition: MultiCollectionDefinition
   adminConfig?: CollectionAdminConfig
   // biome-ignore lint/suspicious/noExplicitAny: shape is collection-specific
   initialData?: Record<string, any>
@@ -105,6 +105,10 @@ export const CreateView = ({
         status: 'failed',
         message: description,
       })
+
+      // Rethrow so FormRenderer keeps the form dirty. The toast above has
+      // already told the editor what went wrong.
+      throw err
     }
   }
 

package/src/admin-shell/collections/edit.tsx

@@ -9,7 +9,7 @@
 import { useState } from 'react'
 
 import { FormRenderer } from '@byline/admin/react'
-import type { CollectionAdminConfig, CollectionDefinition } from '@byline/core'
+import type { CollectionAdminConfig, MultiCollectionDefinition } from '@byline/core'
 import {
   getDefaultStatus,
   getWorkflow,
@@ -56,7 +56,7 @@ export const EditView = ({
   defaultContentLocale,
   returnSearch,
 }: {
-  collectionDefinition: CollectionDefinition
+  collectionDefinition: MultiCollectionDefinition
   adminConfig?: CollectionAdminConfig
   initialData: AnyCollectionSchemaTypes['UpdateType']
   locale?: string
@@ -623,6 +623,10 @@ export const EditView = ({
       })
 
       setEditState({ status: 'failed', message: description })
+
+      // Rethrow so FormRenderer keeps the form dirty. The toast above has
+      // already told the editor what went wrong.
+      throw err
     }
   }
 

package/src/admin-shell/collections/history.module.css

@@ -1,5 +1,5 @@
 /**
- * HistoryView — list of past versions for a collection document.
+ * Shared version-history presentation for collection documents and singletons.
  *
  * Override handles:
  *   .byline-coll-history-head     — title + view-menu row