@meith/web 0.36.1 → 0.37.0

package/src/theme/preview.fixture.ts

@@ -0,0 +1,304 @@
+import { renderMarkdown } from '@meith/markdown'
+import type { SlotModels, SlotName } from '@meith/theme-kit'
+
+import { SLOT_FIXTURES } from './contract.fixture'
+
+const base = SLOT_FIXTURES
+const zero = { value: 0, label: '0' }
+const guest = base.Shell.model.viewer
+const thread = base.ThreadView.model.thread
+const post = base.PostBit.model.post
+const forum = base.ForumRow.model.forum
+const selection = {
+  name: 'ids',
+  value: '4102',
+  formId: 'fixture-selection',
+  label: 'Select for moderation',
+}
+
+export const SLOT_VARIANTS: {
+  readonly [K in SlotName]?: Readonly<Record<string, Partial<SlotModels[K]>>>
+} = {
+  Header: {
+    guest: { viewer: guest },
+    staff: {
+      viewer: { ...base.Header.model.viewer, canAccessAdminCp: true, canAccessModCp: true },
+    },
+  },
+  UserPanel: {
+    guest: {
+      viewer: guest,
+      links: [
+        { label: 'Log in', href: '/login' },
+        { label: 'Register', href: '/register' },
+      ],
+      unreadNotifications: zero,
+      unreadMessages: zero,
+      children: null,
+    },
+    staff: {
+      viewer: { ...base.UserPanel.model.viewer, canAccessAdminCp: true },
+      links: [
+        { label: 'Admin CP', href: '/admin' },
+        { label: 'Moderator CP', href: '/modcp' },
+      ],
+      unreadNotifications: { value: 124, label: '124' },
+    },
+  },
+  Notice: {
+    info: { kind: 'info', message: 'Welcome to the community.' },
+    success: { kind: 'success', message: 'Your changes were saved.' },
+    error: { kind: 'error', message: 'Your changes could not be saved.' },
+  },
+  BoardIndex: {
+    empty: {
+      markAllReadAction: null,
+      regions: { categories: null, stats: null, online: null, latest: null },
+    },
+  },
+  ForumRow: {
+    empty: {
+      forum: {
+        ...forum,
+        isUnread: false,
+        threadCount: zero,
+        postCount: zero,
+        lastPost: null,
+        subforums: [],
+      },
+    },
+    link: {
+      forum: {
+        ...forum,
+        type: 'link',
+        title: 'Community website',
+        href: 'https://meith.dev',
+        lastPost: null,
+        subforums: [],
+      },
+    },
+    long: {
+      forum: {
+        ...forum,
+        title:
+          'Community projects, questions, resources and announcements for everyone working together',
+        description:
+          'A longer description tests wrapping on narrow screens without hiding the activity counts or subforum navigation.',
+      },
+    },
+  },
+  ForumDisplay: {
+    empty: {
+      forum: { ...forum, threadCount: zero, postCount: zero, lastPost: null },
+      regions: { threads: null, pagination: null, subforums: null },
+    },
+  },
+  ThreadRow: {
+    read: {
+      thread: { ...thread, isSticky: false, isUnread: false, prefix: null, visibility: 'visible' },
+    },
+    locked: { thread: { ...thread, isLocked: true } },
+    moved: { thread: { ...thread, isMoved: true } },
+    unapproved: { thread: { ...thread, visibility: 'unapproved' }, select: selection },
+    deleted: { thread: { ...thread, visibility: 'deleted' }, select: selection },
+    long: {
+      thread: {
+        ...thread,
+        title:
+          'How should we organise the next community gathering when members are travelling from several different time zones?',
+      },
+    },
+  },
+  ThreadView: {
+    guest: { replyHref: null, markReadAction: null, watch: null },
+    locked: { thread: { ...thread, isLocked: true }, replyHref: null, watch: null },
+    poll: {},
+  },
+  PostBit: {
+    unapproved: { post: { ...post, visibility: 'unapproved' }, select: selection },
+    deleted: { post: { ...post, visibility: 'deleted' }, select: selection },
+    ignored: {
+      post: {
+        ...post,
+        bodyHtml: '',
+        quoteSource: '',
+        attachments: [],
+        ignored: { authorUsername: post.author.username, revealHref: '/fixtures?slot=PostBit' },
+      },
+    },
+    guest: {
+      post: {
+        ...post,
+        author: {
+          ...post.author,
+          userId: null,
+          profileHref: null,
+          avatarUrl: null,
+          signatureHtml: null,
+          groups: [],
+          fields: [],
+          isOnline: false,
+        },
+        attachments: [],
+        editedNote: null,
+      },
+    },
+    rich: {
+      post: {
+        ...post,
+        bodyHtml: renderMarkdown(
+          '## Formatting and media\n\n**Bold**, *italic*, ~~removed~~ and [linked text](/).\n\n> A nested conversation.\n>\n> > The earlier reply.\n\n- One item\n- Another item\n\n1. First step\n2. Next step\n\n- [x] Checked task\n- [ ] Open task\n\n```ts\nconst greeting = "Hello, community";\n```\n\n| Day | Activity |\n| --- | --- |\n| Friday | Meetup |\n\n:::spoiler\nThe shed is green.\n:::\n\nLongUnbrokenContentToCheckWrapping0123456789LongUnbrokenContentToCheckWrapping0123456789LongUnbrokenContentToCheckWrapping0123456789',
+        ).html,
+        author: {
+          ...post.author,
+          reputation: { value: 1240, label: '1,240' },
+          badge: { src: '/placeholder-logo.svg', darkSrc: null, alt: 'Community helper' },
+        },
+        attachments: [
+          ...post.attachments,
+          {
+            id: 56,
+            filename: 'robots.txt',
+            size: '124 B',
+            isImage: false,
+            href: '/robots.txt',
+            thumbnailHref: null,
+            width: null,
+            height: null,
+          },
+        ],
+      },
+    },
+  },
+  PostActions: {
+    guest: {
+      actions: {
+        quoteHref: null,
+        editHref: null,
+        restoreHref: null,
+        reportHref: null,
+        warnHref: null,
+        moderateHref: null,
+        rateHref: null,
+      },
+    },
+    staff: {
+      actions: {
+        ...post.actions,
+        restoreHref: '/fixtures',
+        warnHref: '/fixtures',
+        moderateHref: '/fixtures',
+        rateHref: '/fixtures',
+      },
+    },
+  },
+  PostForm: {
+    thread: { mode: 'thread', heading: 'Post a new thread', errorMessage: null },
+    edit: { mode: 'edit', heading: 'Edit your post', errorMessage: null },
+  },
+  MemberProfile: {
+    minimal: {
+      avatarUrl: null,
+      title: null,
+      groups: [],
+      signatureHtml: null,
+      fields: [],
+      actions: [],
+      lastVisitAt: null,
+      regions: {},
+    },
+  },
+  SearchForm: {
+    blank: {
+      query: '',
+      errorMessage: null,
+      advanced: { ...base.SearchForm.model.advanced!, isOpen: false },
+    },
+  },
+  SearchResults: {
+    empty: {
+      hits: [],
+      nextHref: null,
+      refine: {
+        ...base.SearchResults.model.refine!,
+        summary: 'No matching posts.',
+        choices: [],
+        applied: [],
+      },
+    },
+  },
+  DiscoveryView: {
+    empty: { rows: [], nextHref: null },
+    refused: {
+      rows: [],
+      nextHref: null,
+      refusal: {
+        message: 'Sign in to see your unread threads.',
+        signInHref: '/login',
+        signInLabel: 'Log in',
+      },
+    },
+  },
+  WhoIsOnline: {
+    empty: {
+      guestCount: zero,
+      members: [],
+      memberCount: zero,
+      total: zero,
+      recordCount: zero,
+      recordAt: null,
+    },
+  },
+  LatestThreads: { empty: { threads: [] } },
+  LatestPosts: { empty: { posts: [] } },
+  BoardStats: {
+    empty: {
+      threadCount: zero,
+      postCount: zero,
+      memberCount: zero,
+      newestMember: null,
+      computedAt: null,
+    },
+  },
+  Pagination: {
+    single: {
+      page: 1,
+      pageCount: 1,
+      pages: [{ page: 1, href: '/fixtures?slot=Pagination', isCurrent: true }],
+      previousHref: null,
+      nextHref: null,
+    },
+  },
+  PanelShell: { modcp: { panel: 'modcp' }, admincp: { panel: 'admincp' } },
+  PanelNav: { modcp: { panel: 'modcp' }, admincp: { panel: 'admincp' } },
+  PanelPage: {
+    usercp: { panel: 'usercp' },
+    modcp: { panel: 'modcp' },
+    standalone: { panel: null, frame: 'standalone' },
+  },
+  AuthPage: {
+    login: { alert: null },
+    register: { title: 'Create an account', alert: null },
+    reset: { title: 'Reset your password', alert: null },
+  },
+  ErrorNotice: {
+    forbidden: {
+      status: 403,
+      title: 'Access denied',
+      message: 'You do not have permission to view this page.',
+    },
+    unavailable: {
+      status: 503,
+      title: 'Temporarily unavailable',
+      message: 'Please try again in a few minutes.',
+    },
+  },
+}
+
+export function fixtureModel<K extends SlotName>(name: K, variant = 'default'): SlotModels[K] {
+  return { ...SLOT_FIXTURES[name].model, ...SLOT_VARIANTS[name]?.[variant] }
+}
+
+export function fixtureVariants(name: SlotName): readonly string[] {
+  return ['default', ...Object.keys(SLOT_VARIANTS[name] ?? {})]
+}

package/src/view/system-run-detail.ts

@@ -0,0 +1,33 @@
+export interface RunDetailField {
+  readonly path: readonly string[]
+  readonly value: string | number | boolean | null
+}
+
+export function systemRunDetail(detail: string | null): readonly RunDetailField[] {
+  if (detail === null || detail.trim() === '') return []
+
+  let parsed: unknown
+  try {
+    parsed = JSON.parse(detail)
+  } catch {
+    return [{ path: [], value: detail }]
+  }
+
+  const fields: RunDetailField[] = []
+  const pending = [{ path: [] as string[], value: parsed }]
+  while (pending.length > 0) {
+    const { path, value } = pending.pop()!
+    if (value !== null && typeof value === 'object') {
+      const entries = Array.isArray(value)
+        ? value.map((item, index) => [String(index + 1), item] as const)
+        : Object.entries(value)
+      if (entries.length === 0) fields.push({ path, value: null })
+      for (const [key, item] of entries.reverse()) {
+        pending.push({ path: [...path, key], value: item })
+      }
+    } else {
+      fields.push({ path, value: value as RunDetailField['value'] })
+    }
+  }
+  return fields
+}

package/app/demo/stripe/[[...path]]/route.ts

@@ -1,27 +0,0 @@
-import type { NextRequest } from 'next/server'
-
-import { handleFakeStripe } from '@/server/demo-stripe'
-
-export const dynamic = 'force-dynamic'
-
-async function handle(
-  request: NextRequest,
-  params: Promise<{ path?: string[] }>,
-): Promise<Response> {
-  const { path } = await params
-  return handleFakeStripe(request, (path ?? []).join('/'))
-}
-
-export async function GET(
-  request: NextRequest,
-  context: { params: Promise<{ path?: string[] }> },
-): Promise<Response> {
-  return handle(request, context.params)
-}
-
-export async function POST(
-  request: NextRequest,
-  context: { params: Promise<{ path?: string[] }> },
-): Promise<Response> {
-  return handle(request, context.params)
-}

package/src/components/shell/demo-banner.tsx

@@ -1,41 +0,0 @@
-import { demoBannerModel } from '@/server/demo'
-import { getTranslator } from '@/server/i18n'
-import { splitAround } from '@/view/copy'
-
-export async function DemoBanner() {
-  const banner = await demoBannerModel()
-  if (banner === null) return null
-
-  const t = await getTranslator()
-  const [loginLead, loginTail] = splitAround(t, 'demo.loginAs', 'logins')
-
-  return (
-    <aside
-      className="border-b border-border bg-muted px-4 py-2 text-sm text-muted-foreground"
-      aria-label={t.t('demo.aria')}
-    >
-      <div className="mx-auto flex max-w-6xl flex-wrap items-baseline gap-x-4 gap-y-1">
-        <strong className="font-semibold text-foreground">{t.t('demo.title')}</strong>
-
-        <span>
-          {loginLead}
-          {banner.logins.map((login, index) => (
-            <span key={login.username}>
-              {index > 0 && ', '}
-              <code className="rounded bg-background px-1 py-0.5 font-mono text-foreground">
-                {login.username} / {login.password}
-              </code>
-            </span>
-          ))}
-          {loginTail}
-        </span>
-
-        <span>
-          {banner.resetsIn === null
-            ? t.t('demo.wiped')
-            : t.t('demo.wipedIn', { when: banner.resetsIn })}
-        </span>
-      </div>
-    </aside>
-  )
-}

package/src/server/demo-stripe.ts

@@ -1,104 +0,0 @@
-import 'server-only'
-
-import { env, logger, readPluginEnv } from '@meith/core'
-import {
-  FAKE_STRIPE_MOUNT,
-  type FakeStripeRequest,
-  type FakeStripeResponse,
-  fakeStripe,
-} from '@meith/demo'
-import { signStripePayload } from '@meith/plugin-dues'
-import { resolvePluginSettings } from '@meith/plugin-kit'
-
-import { boardUrl } from './board-url'
-import { activeDefinitions } from './plugin-host'
-import { dispatchPluginRoute } from './plugin-routes'
-import { getSettingOverrides } from './settings'
-
-const DUES = 'dues'
-
-const SETTLED = new Set(['granted', 'already-settled', 'paid-but-grant-refused'])
-
-interface Global {
-  __meithFakeStripe?: Map<string, ReturnType<typeof fakeStripe>>
-}
-
-function instance(publicBase: string): ReturnType<typeof fakeStripe> {
-  const store = (globalThis as Global).__meithFakeStripe ?? new Map()
-  ;(globalThis as Global).__meithFakeStripe = store
-
-  const existing = store.get(publicBase)
-  if (existing !== undefined) return existing
-
-  const made = fakeStripe({ publicBase })
-  store.set(publicBase, made)
-  return made
-}
-
-export async function handleFakeStripe(request: Request, path: string): Promise<Response> {
-  if (!env.DEMO_MODE) return new Response('Not found', { status: 404 })
-
-  const url = new URL(request.url)
-  const call: FakeStripeRequest = {
-    method: request.method,
-    path: path === '' ? '/' : `/${path}`,
-    body: request.method === 'POST' ? await request.text() : '',
-    query: url.searchParams,
-  }
-
-  const outcome = instance(`${await boardUrl()}${FAKE_STRIPE_MOUNT}`).handle(call)
-  if (outcome.event !== null) await deliver(outcome.event)
-  return respond(outcome.response)
-}
-
-function respond(response: FakeStripeResponse): Response {
-  if (response.kind === 'redirect') {
-    return new Response(null, { status: 303, headers: { location: response.to } })
-  }
-
-  const contentType =
-    response.kind === 'json' ? 'application/json; charset=utf-8' : 'text/html; charset=utf-8'
-  const body = response.kind === 'json' ? JSON.stringify(response.body) : response.body
-
-  return new Response(body, {
-    status: response.status,
-    headers: { 'content-type': contentType, 'cache-control': 'no-store' },
-  })
-}
-
-async function deliver(event: unknown): Promise<void> {
-  const definition = activeDefinitions().find((candidate) => candidate.key === DUES)
-  if (definition === undefined) return
-
-  const settings = resolvePluginSettings(definition, await getSettingOverrides(), readPluginEnv)
-  const secret = String(settings.stripe_webhook_secret ?? '')
-  if (secret === '') {
-    logger().warn('the demo Stripe has no webhook secret to sign with')
-    return
-  }
-
-  const body = JSON.stringify(event)
-  const signature = signStripePayload(body, secret, Math.floor(Date.now() / 1000))
-  const board = await boardUrl()
-
-  const response = await dispatchPluginRoute(
-    new Request(`${board}/api/plugins/${DUES}/hook/stripe`, {
-      method: 'POST',
-      body,
-      headers: { 'content-type': 'application/json', 'stripe-signature': signature },
-    }),
-    DUES,
-    ['hook', 'stripe'],
-  )
-
-  const outcome = response.ok
-    ? String(((await response.json()) as { outcome?: unknown }).outcome ?? 'unknown')
-    : 'rejected'
-
-  if (!SETTLED.has(outcome)) {
-    logger().warn(
-      { status: response.status, outcome },
-      'the demo Stripe delivered a webhook the board did not act on',
-    )
-  }
-}

package/src/server/demo-uploads.ts

@@ -1,17 +0,0 @@
-import 'server-only'
-
-import { rm } from 'node:fs/promises'
-
-import { env, logger } from '@meith/core'
-
-export async function clearUploadedFiles(): Promise<void> {
-  if (env.FILESTORE_DRIVER !== 'local') {
-    logger({ module: 'demo' }).warn(
-      { driver: env.FILESTORE_DRIVER },
-      'demo reset left uploads in place: only the local file store is cleared',
-    )
-    return
-  }
-
-  await rm(env.UPLOADS_DIR, { recursive: true, force: true })
-}

package/src/server/demo.ts

@@ -1,59 +0,0 @@
-import 'server-only'
-
-import { env, logger } from '@meith/core'
-import { getDb } from '@meith/db'
-import {
-  assertDemoAccountIsChangeable,
-  type DemoBanner,
-  demoBanner,
-  type FrozenField,
-  nextDemoResetAt,
-} from '@meith/demo'
-
-import { getContainer } from './container'
-
-export async function assertDemoAccountChangeable(
-  userId: number,
-  what: FrozenField,
-): Promise<void> {
-  if (!env.DEMO_MODE) return
-
-  const account = await getContainer().accountStore.accounts.findById(userId)
-  if (account === null) return
-
-  assertDemoAccountIsChangeable(account.username, what)
-}
-
-export async function assertDemoIdentityUnchanged(
-  userId: number,
-  submitted: { readonly username: string; readonly email: string },
-): Promise<void> {
-  if (!env.DEMO_MODE) return
-
-  const account = await getContainer().accountStore.accounts.findById(userId)
-  if (account === null) return
-
-  if (submitted.username.trim().toLowerCase() !== account.usernameLower) {
-    assertDemoAccountIsChangeable(account.username, 'username')
-  }
-  if (submitted.email.trim().toLowerCase() !== account.emailLower) {
-    assertDemoAccountIsChangeable(account.username, 'email')
-  }
-}
-
-export async function demoBannerModel(): Promise<DemoBanner | null> {
-  if (!env.DEMO_MODE) return null
-
-  try {
-    return demoBanner({
-      nextResetAt: await nextDemoResetAt(getDb()),
-      now: new Date(),
-    })
-  } catch (error) {
-    logger({ module: 'demo' }).warn(
-      { err: String(error) },
-      'could not read the next demo reset time',
-    )
-    return demoBanner({ nextResetAt: null, now: new Date() })
-  }
-}