@meith/web 0.27.0 → 0.28.0

package/app/admin/system/page.tsx

@@ -4,6 +4,7 @@ import type { TaskHealthStatus } from '@meith/tasks'
 import { cn } from '@meith/ui'
 
 import {
+  ApplyMigrationsForm,
   ClearCacheForm,
   PruneSessionsForm,
   PruneTokensForm,
@@ -16,6 +17,7 @@ import { PanelPage } from '@/components/shell/panel-page'
 import { adminPageContext } from '@/server/admin'
 import { getTranslator, tr } from '@/server/i18n'
 import { buildSystemHealthView } from '@/server/system-admin'
+import { CODE_VERSION, pendingUpgradeNotice } from '@/server/upgrade-notice'
 import { systemFormsCopy } from '@/view/admin-panel-copy'
 import { formatTime } from '@/view/time'
 
@@ -36,7 +38,11 @@ export default async function AdminSystemPage() {
   if ((await adminPageContext()) === null) return null
 
   const now = new Date()
-  const [translator, view] = await Promise.all([getTranslator(), buildSystemHealthView(now)])
+  const [translator, view, upgradeNotice] = await Promise.all([
+    getTranslator(),
+    buildSystemHealthView(now),
+    pendingUpgradeNotice(),
+  ])
   const copy = systemFormsCopy(translator)
 
   if (view === null) {
@@ -246,6 +252,28 @@ export default async function AdminSystemPage() {
         </ul>
       </section>
 
+      <section className={PANEL_CARD}>
+        <h2 className="font-heading text-lg font-semibold">
+          {translator.t('adminSystem.migrations')}
+        </h2>
+        <p className="text-sm">
+          {translator.t('adminSystem.runningVersion')} <code>{CODE_VERSION}</code>.
+        </p>
+        {upgradeNotice === null ? (
+          <p className="text-sm text-muted-foreground">
+            {translator.t('adminSystem.migrationsUpToDate')}
+          </p>
+        ) : (
+          <>
+            <p className="text-sm text-destructive">{upgradeNotice}</p>
+            <p className="text-sm text-muted-foreground">
+              {translator.t('adminSystem.migrationsHint')}
+            </p>
+            <ApplyMigrationsForm copy={copy} />
+          </>
+        )}
+      </section>
+
       <section className={PANEL_CARD}>
         <h2 className="font-heading text-lg font-semibold">
           {translator.t('adminSystem.recount')}

package/app/admin/themes/page.tsx

@@ -167,8 +167,8 @@ export default async function AdminThemesPage() {
         </p>
         <p className="text-muted-foreground">
           {translator.t('adminThemes.deployBefore')} <em>exist</em>
-          {translator.t('adminThemes.deployAfterExist')} <code className="text-xs">pnpm add</code>{' '}
-          {translator.t('adminThemes.deployAfterAdd')}{' '}
+          {translator.t('adminThemes.deployAfterExist')}{' '}
+          <code className="text-xs">npm install</code> {translator.t('adminThemes.deployAfterAdd')}{' '}
           <code className="text-xs">meith.config.ts</code>
           {translator.t('adminThemes.deployAfterConfig')}{' '}
           <code className="text-xs">defaultTheme</code> {translator.t('adminThemes.deployEnd')}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meith/web",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "The board itself: the Next.js app, and the forum-web bin that materializes it into an external board workspace.",
   "license": "MIT",
   "repository": {
@@ -43,53 +43,53 @@
     "react-dom": "19.2.8",
     "tailwindcss": "^4.3.3",
     "typescript": "7.0.2",
-    "@meith/accounts": "0.27.0",
-    "@meith/admin": "0.27.0",
-    "@meith/antispam": "0.27.0",
-    "@meith/api": "0.27.0",
-    "@meith/attachments": "0.27.0",
-    "@meith/authorization": "0.27.0",
-    "@meith/avatars": "0.27.0",
-    "@meith/core": "0.27.0",
-    "@meith/db": "0.27.0",
-    "@meith/demo": "0.27.0",
-    "@meith/drafts": "0.27.0",
-    "@meith/drivers": "0.27.0",
-    "@meith/events": "0.27.0",
-    "@meith/forums": "0.27.0",
-    "@meith/groups": "0.27.0",
-    "@meith/i18n": "0.27.0",
-    "@meith/import": "0.27.0",
-    "@meith/install": "0.27.0",
-    "@meith/mail": "0.27.0",
-    "@meith/markdown": "0.27.0",
-    "@meith/marketplace": "0.27.0",
-    "@meith/messages": "0.27.0",
-    "@meith/moderation": "0.27.0",
-    "@meith/notifications": "0.27.0",
-    "@meith/plugin-calendar": "0.27.0",
-    "@meith/plugin-dues": "0.27.0",
-    "@meith/plugin-kit": "0.27.0",
-    "@meith/polls": "0.27.0",
-    "@meith/posts": "0.27.0",
-    "@meith/profile-fields": "0.27.0",
-    "@meith/relations": "0.27.0",
-    "@meith/reputation": "0.27.0",
-    "@meith/runtime": "0.27.0",
-    "@meith/search": "0.27.0",
-    "@meith/settings": "0.27.0",
-    "@meith/signatures": "0.27.0",
-    "@meith/subscriptions": "0.27.0",
-    "@meith/tasks": "0.27.0",
-    "@meith/theme-clubhouse": "0.27.0",
-    "@meith/theme-default": "0.27.0",
-    "@meith/theme-kit": "0.27.0",
-    "@meith/theme-midnight": "0.27.0",
-    "@meith/theme-phasebook": "0.27.0",
-    "@meith/theme-raidframe": "0.27.0",
-    "@meith/threads": "0.27.0",
-    "@meith/ui": "0.27.0",
-    "@meith/upgrade": "0.27.0"
+    "@meith/accounts": "0.28.0",
+    "@meith/admin": "0.28.0",
+    "@meith/antispam": "0.28.0",
+    "@meith/api": "0.28.0",
+    "@meith/attachments": "0.28.0",
+    "@meith/authorization": "0.28.0",
+    "@meith/avatars": "0.28.0",
+    "@meith/core": "0.28.0",
+    "@meith/db": "0.28.0",
+    "@meith/demo": "0.28.0",
+    "@meith/drafts": "0.28.0",
+    "@meith/drivers": "0.28.0",
+    "@meith/events": "0.28.0",
+    "@meith/forums": "0.28.0",
+    "@meith/i18n": "0.28.0",
+    "@meith/groups": "0.28.0",
+    "@meith/import": "0.28.0",
+    "@meith/install": "0.28.0",
+    "@meith/mail": "0.28.0",
+    "@meith/markdown": "0.28.0",
+    "@meith/marketplace": "0.28.0",
+    "@meith/messages": "0.28.0",
+    "@meith/moderation": "0.28.0",
+    "@meith/notifications": "0.28.0",
+    "@meith/plugin-calendar": "0.28.0",
+    "@meith/plugin-dues": "0.28.0",
+    "@meith/plugin-kit": "0.28.0",
+    "@meith/polls": "0.28.0",
+    "@meith/posts": "0.28.0",
+    "@meith/profile-fields": "0.28.0",
+    "@meith/relations": "0.28.0",
+    "@meith/reputation": "0.28.0",
+    "@meith/runtime": "0.28.0",
+    "@meith/search": "0.28.0",
+    "@meith/settings": "0.28.0",
+    "@meith/signatures": "0.28.0",
+    "@meith/subscriptions": "0.28.0",
+    "@meith/tasks": "0.28.0",
+    "@meith/theme-clubhouse": "0.28.0",
+    "@meith/theme-default": "0.28.0",
+    "@meith/theme-kit": "0.28.0",
+    "@meith/theme-midnight": "0.28.0",
+    "@meith/theme-phasebook": "0.28.0",
+    "@meith/theme-raidframe": "0.28.0",
+    "@meith/threads": "0.28.0",
+    "@meith/ui": "0.28.0",
+    "@meith/upgrade": "0.28.0"
   },
   "scripts": {
     "dev": "next dev",

package/src/components/admin/system-forms.tsx

@@ -4,6 +4,7 @@ import { useActionState } from 'react'
 
 import { EMPTY_STATE } from '@/server/auth-form-state'
 import {
+  applyUpgradeAction,
   clearCacheAction,
   pruneSessionsAction,
   pruneTokensAction,
@@ -42,6 +43,27 @@ export function PruneSessionsForm({ prunable, copy }: { prunable: number; copy:
   )
 }
 
+export function ApplyMigrationsForm({ copy }: { copy: Copy }) {
+  const [state, action] = useActionState(applyUpgradeAction, EMPTY_STATE)
+
+  return (
+    <form action={action} className="flex flex-col gap-2">
+      <FormError message={state.error} />
+      {state.notice === 'upgraded' && (
+        <Result>
+          {formatFromCopy(copy, 'adminPanel.system.upgradeApplied', {
+            core: state.values?.core ?? '0',
+            plugins: state.values?.plugins === '' ? '—' : (state.values?.plugins ?? '—'),
+          })}
+        </Result>
+      )}
+      <div>
+        <SubmitButton>{fromCopy(copy, 'adminPanel.system.applyMigrations')}</SubmitButton>
+      </div>
+    </form>
+  )
+}
+
 export function PruneTokensForm({ copy }: { copy: Copy }) {
   const [state, action] = useActionState(pruneTokensAction, EMPTY_STATE)
 

package/src/server/system-admin-actions.ts

@@ -6,12 +6,13 @@ import { NotFoundError, ValidationError } from '@meith/core'
 import { drivers } from '@meith/drivers'
 import { msg } from '@meith/i18n'
 
-import { recordAdminAction, requireAdmin } from './admin'
+import { recordAdminAction, requireAdmin, requireFreshAdmin } from './admin'
 import type { FormState } from './auth-form-state'
 import { clearableTag } from './cache-targets'
 import { formStateReporter } from './form-state-reporter'
 import { requireSearch } from './search'
 import { requireMaintenance, requireRecount } from './system-admin'
+import { applyPendingUpgrade } from './upgrade-notice'
 
 const SWEEP_LIMIT = 5_000
 
@@ -89,6 +90,28 @@ export async function reindexSearchAction(): Promise<FormState> {
   }
 }
 
+export async function applyUpgradeAction(): Promise<FormState> {
+  try {
+    await requireFreshAdmin()
+
+    const result = await applyPendingUpgrade()
+
+    refreshSystemScreen()
+    revalidatePath('/admin')
+    await recordAdminAction({
+      action: 'system.upgrade_applied',
+      detail: { coreMigrations: result.coreMigrations, plugins: result.plugins },
+    })
+
+    return {
+      notice: 'upgraded',
+      values: { core: String(result.coreMigrations), plugins: result.plugins.join(', ') },
+    }
+  } catch (err) {
+    return toFormState(err)
+  }
+}
+
 export async function clearCacheAction(_prev: FormState, form: FormData): Promise<FormState> {
   try {
     await requireAdmin()

package/src/server/upgrade-notice.ts

@@ -1,12 +1,94 @@
 import 'server-only'
 
-import { env, logger } from '@meith/core'
-import { appliedPluginMigrations, getDb, readVersion } from '@meith/db'
+import { env, logger, ValidationError } from '@meith/core'
+import {
+  appliedPluginMigrations,
+  applyPluginMigration,
+  getDb,
+  PostgresNavigationRepository,
+  readVersion,
+  recordVersion,
+  runMigrations,
+} from '@meith/db'
+import { msg } from '@meith/i18n'
+import { pluginNavigationPlacements } from '@meith/plugin-kit'
+import { runPluginLifecycle } from '@meith/runtime'
 import { planUpgrade, type UpgradeState, upgradeNotice } from '@meith/upgrade'
 
 import { activeDefinitions } from './plugin-host'
 
-export const CODE_VERSION = '0.27.0'
+export const CODE_VERSION = '0.28.0'
+
+export interface UpgradeApplied {
+  readonly coreMigrations: number
+  readonly plugins: readonly string[]
+}
+
+export async function applyPendingUpgrade(): Promise<UpgradeApplied> {
+  const db = getDb()
+  const definitions = activeDefinitions()
+
+  const applied: Record<string, readonly string[]> = {}
+  for (const plugin of definitions) {
+    applied[plugin.key] = await appliedPluginMigrations(db, plugin.key)
+  }
+
+  const state: UpgradeState = {
+    recordedVersion: (await readVersion(db, 'core')) ?? CODE_VERSION,
+    codeVersion: CODE_VERSION,
+    pendingCoreMigrations: [],
+    plugins: definitions.map((plugin) => ({
+      key: plugin.key,
+      version: plugin.version,
+      dependsOn: plugin.dependsOn ?? [],
+      migrationIds: (plugin.migrations ?? []).map((migration) => migration.id),
+    })),
+    appliedPluginMigrations: applied,
+  }
+
+  const plan = planUpgrade(state)
+  if (plan.refusal !== null || plan.orderFailure !== null) {
+    const notice = upgradeNotice(plan, state)
+    throw notice === null
+      ? new ValidationError(msg('error.app.board-cannot-be-upgraded'))
+      : new ValidationError(notice)
+  }
+
+  const fresh = new Set<string>()
+  for (const plugin of definitions) {
+    if ((await readVersion(db, `plugin:${plugin.key}`)) === null) fresh.add(plugin.key)
+  }
+
+  const coreMigrations = await runMigrations()
+
+  const touched: string[] = []
+  for (const definition of definitions) {
+    let changed = false
+    for (const migration of definition.migrations ?? []) {
+      const ran = await applyPluginMigration(db, definition.key, migration.id, migration.statements)
+      if (ran) changed = true
+    }
+    if (fresh.has(definition.key) && definition.onInstall !== undefined) {
+      const { ran } = await runPluginLifecycle({ db, plugin: definition, phase: 'install' })
+      if (ran) changed = true
+    }
+    await recordVersion(db, `plugin:${definition.key}`, definition.version)
+    if (changed) touched.push(definition.key)
+  }
+
+  await new PostgresNavigationRepository(db).syncPluginItems(
+    pluginNavigationPlacements(definitions).map((item) => ({
+      key: item.key,
+      href: item.href,
+      audience: item.audience,
+      parentKey: item.parentKey,
+    })),
+  )
+
+  await recordVersion(db, 'core', CODE_VERSION)
+
+  return { coreMigrations, plugins: touched }
+}
 
 export async function pendingUpgradeNotice(): Promise<string | null> {
   if (env.DATA_SOURCE !== 'postgres') return null

package/src/view/admin-panel-copy.ts

@@ -60,6 +60,7 @@ export function systemFormsCopy(t: Translator = untranslated()): Readonly<Record
         'adminPanel.system.jobIdHint',
         'adminPanel.system.retry',
         'adminPanel.system.nothingToIndex',
+        'adminPanel.system.applyMigrations',
       ],
       t,
     ),
@@ -73,6 +74,7 @@ export function systemFormsCopy(t: Translator = untranslated()): Readonly<Record
         'adminPanel.system.indexFinished',
         'adminPanel.system.indexMore',
         'adminPanel.system.indexNext',
+        'adminPanel.system.upgradeApplied',
       ],
       t,
     ),