betterstart-cli 0.0.11 → 0.0.13

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/runner.ts

@@ -1,5 +1,6 @@
-import { getRegisteredHooks } from './registry'
+import { getRegisteredAdminHooks, getRegisteredHooks } from './registry'
 import type {
+  AdminEventContext,
   AfterLifecycleHookEvent,
   BeforeLifecycleHookEvent,
   LifecycleHookAbort,
@@ -33,19 +34,122 @@ export async function runBeforeHooks(
   }
 }
 
-export function runAfterHooks(event: AfterLifecycleHookEvent, context: LifecycleHookContext): void {
-  const handlers = getRegisteredHooks(context.entityType, event)
+function getAdminActionFromLifecycleEvent(
+  event: AfterLifecycleHookEvent
+): AdminEventContext['action'] | null {
+  if (event === 'afterCreate') return 'create'
+  if (event === 'afterUpdate') return 'update'
+  if (event === 'afterDelete') return 'delete'
+  if (event === 'afterPublish') return 'publish'
+  if (event === 'afterUnpublish') return 'unpublish'
+  return null
+}
+
+function getTargetLabel(data: Record<string, unknown> | undefined): string | null {
+  if (!data) return null
+
+  for (const fieldName of ['title', 'name', 'label', 'slug', 'email', 'filename']) {
+    const value = data[fieldName]
+    if (typeof value === 'string' && value.trim()) return value
+  }
+
+  return null
+}
+
+function getChangedFieldsFromLifecycleContext(
+  event: AfterLifecycleHookEvent,
+  context: LifecycleHookContext
+): string[] {
+  if (context.changedFields) return context.changedFields
+  if (event === 'afterDelete') return []
+
+  return Object.keys(context.input ?? {})
+    .filter((fieldName) => fieldName !== 'id')
+    .sort((a, b) => a.localeCompare(b))
+}
+
+function toAdminEventContext(
+  event: AfterLifecycleHookEvent,
+  context: LifecycleHookContext
+): AdminEventContext | null {
+  const action = getAdminActionFromLifecycleEvent(event)
+  if (!action) return null
+
+  return {
+    category: 'entity',
+    action,
+    targetType: context.entityType,
+    targetId: context.entityId ?? null,
+    targetLabel: context.targetLabel ?? getTargetLabel(context.data),
+    user: context.user,
+    timestamp: context.timestamp,
+    sourceType: context.sourceType ?? 'admin_ui',
+    ipAddress: context.ipAddress ?? null,
+    userAgent: context.userAgent ?? null,
+    changedFields: getChangedFieldsFromLifecycleContext(event, context),
+    metadata: {
+      entityType: context.entityType,
+      ...(context.metadata ?? {})
+    }
+  }
+}
+
+function runSettledHook<Context>(
+  handler: (context: Context) => void | Promise<void>,
+  context: Context
+): Promise<void> {
+  try {
+    return Promise.resolve(handler(context))
+  } catch (error) {
+    return Promise.reject(error)
+  }
+}
+
+export function runAdminEventHooks(context: AdminEventContext): void {
+  const handlers = getRegisteredAdminHooks({
+    category: context.category,
+    action: context.action
+  })
   if (handlers.length === 0) return
 
-  void Promise.allSettled(handlers.map((handler) => handler(context))).then((results) => {
-    for (const result of results) {
-      if (result.status === 'rejected') {
-        console.error('Lifecycle hook failed:', {
-          entityType: context.entityType,
-          event,
-          error: result.reason
-        })
+  void Promise.allSettled(handlers.map((handler) => runSettledHook(handler, context))).then(
+    (results) => {
+      for (const result of results) {
+        if (result.status === 'rejected') {
+          console.error('Admin event hook failed:', {
+            category: context.category,
+            action: context.action,
+            targetType: context.targetType,
+            targetId: context.targetId,
+            error: result.reason
+          })
+        }
       }
     }
-  })
+  )
+}
+
+export function runAfterHooks(event: AfterLifecycleHookEvent, context: LifecycleHookContext): void {
+  const handlers = getRegisteredHooks(context.entityType, event)
+
+  if (handlers.length > 0) {
+    void Promise.allSettled(handlers.map((handler) => runSettledHook(handler, context))).then(
+      (results) => {
+        for (const result of results) {
+          if (result.status === 'rejected') {
+            console.error('Lifecycle hook failed:', {
+              entityType: context.entityType,
+              event,
+              error: result.reason
+            })
+          }
+        }
+      }
+    )
+  }
+
+  const adminEvent = toAdminEventContext(event, context)
+  if (adminEvent) {
+    runAdminEventHooks(adminEvent)
+  }
 }

package/dist/assets/adapters/next/templates/init/lib/lifecycle-hooks/types.ts

@@ -1,3 +1,8 @@
+import type {
+  AuditLogAction,
+  AuditLogCategory,
+  AuditLogSourceType
+} from '@admin/actions/audit/types'
 import type { User } from '@admin/auth'
 
 export type LifecycleHookEvent =
@@ -22,6 +27,32 @@ export interface LifecycleHookContext {
   entityId?: string | undefined
   input?: Record<string, unknown> | undefined
   data?: Record<string, unknown> | undefined
+  changedFields?: string[] | undefined
+  sourceType?: AuditLogSourceType | undefined
+  ipAddress?: string | null | undefined
+  userAgent?: string | null | undefined
+  targetLabel?: string | null | undefined
+  metadata?: Record<string, unknown> | undefined
+}
+
+export interface AdminEventDescriptor {
+  category?: AuditLogCategory
+  action?: AuditLogAction
+}
+
+export interface AdminEventContext {
+  category: AuditLogCategory
+  action: AuditLogAction
+  targetType: string
+  targetId?: string | null | undefined
+  targetLabel?: string | null | undefined
+  user?: User | null | undefined
+  timestamp: string
+  sourceType?: AuditLogSourceType | undefined
+  ipAddress?: string | null | undefined
+  userAgent?: string | null | undefined
+  changedFields?: string[] | undefined
+  metadata?: Record<string, unknown> | undefined
 }
 
 export interface LifecycleHookAbort {
@@ -37,3 +68,5 @@ export type AfterLifecycleHookHandler = (context: LifecycleHookContext) => void
 
 export type LifecycleHookHandler<Event extends LifecycleHookEvent> =
   Event extends BeforeLifecycleHookEvent ? BeforeLifecycleHookHandler : AfterLifecycleHookHandler
+
+export type AdminEventHookHandler = (context: AdminEventContext) => void | Promise<void>

package/dist/assets/adapters/next/templates/init/pages/audit-log/audit-log-detail-drawer.tsx

@@ -0,0 +1,96 @@
+'use client'
+
+import type { AuditLogEntry } from '@admin/actions/audit'
+import { Badge } from '@admin/components/ui/badge'
+import {
+  Drawer,
+  DrawerContent,
+  DrawerDescription,
+  DrawerHeader,
+  DrawerTitle
+} from '@admin/components/ui/drawer'
+import { ScrollArea } from '@admin/components/ui/scroll-area'
+import { AuditLogDetailRow } from './audit-log-detail-row'
+
+interface AuditLogDetailDrawerProps {
+  auditLog: AuditLogEntry | null
+  open: boolean
+  onOpenChange: (open: boolean) => void
+}
+
+function formatDateTime(value: string): string {
+  const date = new Date(value)
+  if (Number.isNaN(date.getTime())) return value
+
+  return new Intl.DateTimeFormat('en-US', {
+    dateStyle: 'medium',
+    timeStyle: 'medium'
+  }).format(date)
+}
+
+function formatMetadata(metadata: Record<string, unknown> | null): string {
+  if (!metadata || Object.keys(metadata).length === 0) return '{}'
+  return JSON.stringify(metadata, null, 2)
+}
+
+export function AuditLogDetailDrawer({ auditLog, open, onOpenChange }: AuditLogDetailDrawerProps) {
+  return (
+    <Drawer direction="right" open={open} onOpenChange={onOpenChange} modal>
+      <DrawerContent className="h-full sm:max-w-xl">
+        <DrawerHeader>
+          <DrawerTitle>Audit Event</DrawerTitle>
+          <DrawerDescription>
+            {auditLog ? `${auditLog.category}.${auditLog.action}` : 'No event selected'}
+          </DrawerDescription>
+        </DrawerHeader>
+        <ScrollArea className="min-h-0 flex-1">
+          {auditLog ? (
+            <div className="p-4">
+              <dl className="rounded-lg border border-border bg-card px-4">
+                <AuditLogDetailRow label="Time" value={formatDateTime(auditLog.createdAt)} />
+                <AuditLogDetailRow label="Category" value={auditLog.category} />
+                <AuditLogDetailRow label="Action" value={auditLog.action} />
+                <AuditLogDetailRow
+                  label="Target"
+                  value={auditLog.targetLabel ?? auditLog.targetId}
+                />
+                <AuditLogDetailRow label="Target Type" value={auditLog.targetType} />
+                <AuditLogDetailRow label="Target ID" value={auditLog.targetId} />
+                <AuditLogDetailRow
+                  label="Actor"
+                  value={auditLog.actorEmail ?? auditLog.actorName ?? auditLog.actorUserId}
+                />
+                <AuditLogDetailRow label="Actor Role" value={auditLog.actorRole} />
+                <AuditLogDetailRow label="Source" value={auditLog.sourceType} />
+                <AuditLogDetailRow label="IP" value={auditLog.ipAddress} />
+                <AuditLogDetailRow label="User Agent" value={auditLog.userAgent} />
+                <AuditLogDetailRow
+                  label="Fields"
+                  value={
+                    auditLog.changedFields.length > 0 ? (
+                      <div className="flex flex-wrap gap-1">
+                        {auditLog.changedFields.map((field) => (
+                          <Badge key={field} variant="secondary">
+                            {field}
+                          </Badge>
+                        ))}
+                      </div>
+                    ) : (
+                      'None'
+                    )
+                  }
+                />
+              </dl>
+              <div className="mt-4 rounded-lg border border-border bg-card p-4">
+                <h3 className="mb-2 text-sm font-medium">Metadata</h3>
+                <pre className="max-h-72 overflow-auto rounded-md bg-muted p-3 text-xs leading-relaxed">
+                  {formatMetadata(auditLog.metadata)}
+                </pre>
+              </div>
+            </div>
+          ) : null}
+        </ScrollArea>
+      </DrawerContent>
+    </Drawer>
+  )
+}

package/dist/assets/adapters/next/templates/init/pages/audit-log/audit-log-detail-row.tsx

@@ -0,0 +1,17 @@
+import type { ReactNode } from 'react'
+
+interface AuditLogDetailRowProps {
+  label: string
+  value: ReactNode
+}
+
+export function AuditLogDetailRow({ label, value }: AuditLogDetailRowProps) {
+  return (
+    <div className="grid grid-cols-[120px_1fr] gap-3 border-b border-border/70 py-3 last:border-b-0">
+      <dt className="text-xs font-medium uppercase tracking-normal text-muted-foreground">
+        {label}
+      </dt>
+      <dd className="min-w-0 text-sm text-foreground break-words">{value || 'Unknown'}</dd>
+    </div>
+  )
+}

package/dist/assets/adapters/next/templates/init/pages/audit-log/audit-log-filters.tsx

@@ -0,0 +1,152 @@
+'use client'
+
+import {
+  AUDIT_LOG_ACTIONS,
+  AUDIT_LOG_CATEGORIES,
+  type AuditLogAction,
+  type AuditLogCategory
+} from '@admin/actions/audit/types'
+import { Button } from '@admin/components/ui/button'
+import { Input } from '@admin/components/ui/input'
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue
+} from '@admin/components/ui/select'
+import { RotateCcw } from 'lucide-react'
+
+const ALL_FILTER_VALUE = '_all'
+
+interface AuditLogFiltersProps {
+  search: string
+  category: string
+  action: string
+  targetType: string
+  actor: string
+  createdAtFrom: string
+  createdAtTo: string
+  activeFilterCount: number
+  onSearchChange: (value: string) => void
+  onCategoryChange: (value: AuditLogCategory | '') => void
+  onActionChange: (value: AuditLogAction | '') => void
+  onTargetTypeChange: (value: string) => void
+  onActorChange: (value: string) => void
+  onCreatedAtFromChange: (value: string) => void
+  onCreatedAtToChange: (value: string) => void
+  onClear: () => void
+}
+
+function formatFilterLabel(value: string): string {
+  return value
+    .split('_')
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(' ')
+}
+
+export function AuditLogFilters({
+  search,
+  category,
+  action,
+  targetType,
+  actor,
+  createdAtFrom,
+  createdAtTo,
+  activeFilterCount,
+  onSearchChange,
+  onCategoryChange,
+  onActionChange,
+  onTargetTypeChange,
+  onActorChange,
+  onCreatedAtFromChange,
+  onCreatedAtToChange,
+  onClear
+}: AuditLogFiltersProps) {
+  return (
+    <div className="flex flex-col gap-2 border-b border-border bg-background px-4 py-3">
+      <div className="grid gap-2 md:grid-cols-[minmax(180px,1.2fr)_repeat(5,minmax(132px,1fr))_auto]">
+        <Input
+          value={search}
+          onChange={(event) => onSearchChange(event.target.value)}
+          placeholder="Search logs"
+          className="h-8"
+        />
+        <Select
+          value={category || ALL_FILTER_VALUE}
+          onValueChange={(value) =>
+            onCategoryChange(value === ALL_FILTER_VALUE ? '' : (value as AuditLogCategory))
+          }
+        >
+          <SelectTrigger className="h-8">
+            <SelectValue placeholder="Category" />
+          </SelectTrigger>
+          <SelectContent>
+            <SelectItem value={ALL_FILTER_VALUE}>All categories</SelectItem>
+            {AUDIT_LOG_CATEGORIES.map((value) => (
+              <SelectItem key={value} value={value}>
+                {formatFilterLabel(value)}
+              </SelectItem>
+            ))}
+          </SelectContent>
+        </Select>
+        <Select
+          value={action || ALL_FILTER_VALUE}
+          onValueChange={(value) =>
+            onActionChange(value === ALL_FILTER_VALUE ? '' : (value as AuditLogAction))
+          }
+        >
+          <SelectTrigger className="h-8">
+            <SelectValue placeholder="Action" />
+          </SelectTrigger>
+          <SelectContent>
+            <SelectItem value={ALL_FILTER_VALUE}>All actions</SelectItem>
+            {AUDIT_LOG_ACTIONS.map((value) => (
+              <SelectItem key={value} value={value}>
+                {formatFilterLabel(value)}
+              </SelectItem>
+            ))}
+          </SelectContent>
+        </Select>
+        <Input
+          value={targetType}
+          onChange={(event) => onTargetTypeChange(event.target.value)}
+          placeholder="Target type"
+          className="h-8"
+        />
+        <Input
+          value={actor}
+          onChange={(event) => onActorChange(event.target.value)}
+          placeholder="Actor"
+          className="h-8"
+        />
+        <div className="grid grid-cols-2 gap-2 md:col-span-2">
+          <Input
+            type="date"
+            value={createdAtFrom}
+            onChange={(event) => onCreatedAtFromChange(event.target.value)}
+            className="h-8"
+            aria-label="Audit log start date"
+          />
+          <Input
+            type="date"
+            value={createdAtTo}
+            onChange={(event) => onCreatedAtToChange(event.target.value)}
+            className="h-8"
+            aria-label="Audit log end date"
+          />
+        </div>
+        <Button
+          type="button"
+          variant="outline"
+          size="icon-sm"
+          disabled={activeFilterCount === 0}
+          onClick={onClear}
+          aria-label="Clear audit log filters"
+        >
+          <RotateCcw />
+        </Button>
+      </div>
+    </div>
+  )
+}