betterstart-cli 0.0.116 → 0.0.118

package/dist/assets/adapters/next/templates/init/admin-globals.css

@@ -80,6 +80,26 @@
     );
 }
 
+@theme {
+  --breakpoint-xs: 480px;
+  --spacing-entity-editor: 300px;
+  --spacing-table-cell: 300px;
+  --spacing-form-settings-name: 200px;
+  --spacing-form-settings-recipients: 240px;
+  --spacing-auth-login-panel: 540px;
+  --spacing-auth-reset-panel: 520px;
+  --spacing-auth-forgot-panel: 460px;
+  --spacing-media-dialog: 700px;
+  --spacing-media-tile: 180px;
+  --spacing-media-thumb: 100px;
+  --spacing-gallery-item: 184px;
+  --spacing-date-range-trigger: 206px;
+  --spacing-date-range-popover: 282px;
+  --spacing-source-editor: 240px;
+  --grid-template-columns-entity-form: 1fr 360px;
+  --grid-template-columns-audit-detail: 120px 1fr;
+}
+
 :root {
   --card: oklch(1 0 0);
   --card-foreground: oklch(0.145 0 0);

package/dist/assets/adapters/next/templates/init/components/shared/data-table/data-grid-row.tsx

@@ -3,7 +3,37 @@
 import type * as React from 'react'
 import { cn } from '@admin/utils/shared/cn'
 
-function DataGridRow({ className, style, ...props }: React.ComponentProps<'div'>) {
+const INTERACTIVE_ROW_SELECTOR = 'button, a, input, [role="checkbox"], [role="switch"]'
+
+type DataGridRowProps = React.ComponentProps<'div'> & {
+  onActivate?: () => void
+}
+
+function DataGridRow({
+  className,
+  style,
+  onActivate,
+  onClick,
+  onKeyDown,
+  ...props
+}: DataGridRowProps) {
+  function handleClick(event: React.MouseEvent<HTMLDivElement>) {
+    onClick?.(event)
+    const target = event.target
+    if (!onActivate || !(target instanceof HTMLElement)) return
+    if (!event.currentTarget.contains(target)) return
+    if (target.closest(INTERACTIVE_ROW_SELECTOR)) return
+    onActivate()
+  }
+
+  function handleKeyDown(event: React.KeyboardEvent<HTMLDivElement>) {
+    onKeyDown?.(event)
+    if (!onActivate || event.target !== event.currentTarget) return
+    if (event.key !== 'Enter' && event.key !== ' ') return
+    event.preventDefault()
+    onActivate()
+  }
+
   return (
     <div
       role="row"
@@ -14,6 +44,8 @@ function DataGridRow({ className, style, ...props }: React.ComponentProps<'div'>
       )}
       style={{ ...style, gridColumn: '1 / -1', gridTemplateColumns: 'subgrid' }}
       tabIndex={-1}
+      onClick={handleClick}
+      onKeyDown={handleKeyDown}
       {...props}
     />
   )

package/dist/assets/adapters/next/templates/init/components/shared/media/media-gallery-dialog.tsx

@@ -99,7 +99,7 @@ export function MediaGalleryDialog({
         onOpenChange(next)
       }}
     >
-      <DialogContent className="flex h-[80svh] max-h-[700px] min-h-0 max-w-3xl flex-col gap-0 overflow-hidden">
+      <DialogContent className="flex h-[80svh] max-h-media-dialog min-h-0 max-w-3xl flex-col gap-0 overflow-hidden">
         <DialogHeader>
           <DialogTitle>Select file</DialogTitle>
           <DialogDescription>
@@ -128,7 +128,7 @@ export function MediaGalleryDialog({
                 progress={progress}
                 isUploading={isUploading}
                 accept={accept}
-                className="h-[180px]"
+                className="h-media-tile"
               />
             </TabsUi.TabsContent>
 
@@ -136,7 +136,7 @@ export function MediaGalleryDialog({
               <MediaUrlImporter
                 onImportFromUrl={uploadFromUrl}
                 accept={accept}
-                className="h-[180px]"
+                className="h-media-tile"
               />
             </TabsUi.TabsContent>
           </TabsUi.Tabs>

package/dist/assets/adapters/next/templates/init/components/shared/media/media-preview.tsx

@@ -12,6 +12,8 @@ interface MediaPreviewProps {
   showMetadata?: boolean
 }
 
+const MEDIA_PREVIEW_IMAGE_SIZES = '200px'
+
 export function MediaPreview({ media, isFilled = false, showMetadata = false }: MediaPreviewProps) {
   const { hasImageFailed, markImageFailed } = useFailedImageUrl(media.url)
 
@@ -26,7 +28,7 @@ export function MediaPreview({ media, isFilled = false, showMetadata = false }:
             'object-contain': !isFilled
           })}
           fill
-          sizes="200px"
+          sizes={MEDIA_PREVIEW_IMAGE_SIZES}
           unoptimized
           loading="lazy"
           decoding="async"

package/dist/assets/adapters/next/templates/init/hooks/use-copy-to-clipboard.ts

@@ -22,7 +22,6 @@ export function useCopyToClipboard(delay = 2000): [CopyFn, boolean] {
       clearResetTimer()
 
       if (typeof navigator === 'undefined' || !navigator.clipboard) {
-        console.warn('Clipboard not supported')
         setIsCopied(false)
         return false
       }
@@ -35,8 +34,7 @@ export function useCopyToClipboard(delay = 2000): [CopyFn, boolean] {
           resetTimerRef.current = null
         }, delay)
         return true
-      } catch (error) {
-        console.warn('Copy failed', error)
+      } catch {
         setIsCopied(false)
         return false
       }

package/dist/assets/adapters/next/templates/init/hooks/use-field-error-visible.ts

@@ -0,0 +1,25 @@
+'use client'
+
+import type { FieldPath, FieldValues, UseFormReturn } from 'react-hook-form'
+import { useWatch } from 'react-hook-form'
+
+function hasValue(value: unknown): boolean {
+  if (value === null || value === undefined) return false
+  if (typeof value === 'string') return value.trim().length > 0
+  if (Array.isArray(value)) return value.length > 0
+
+  return true
+}
+
+export function useFieldErrorVisible<TValues extends FieldValues>(
+  form: UseFormReturn<TValues>,
+  name: FieldPath<TValues>
+): boolean {
+  const value = useWatch({ control: form.control, name })
+  const { error, isTouched } = form.getFieldState(name, form.formState)
+
+  if (!error) return false
+  if (form.formState.isSubmitted) return true
+
+  return isTouched && hasValue(value)
+}

package/dist/assets/adapters/next/templates/init/hooks/use-media.ts

@@ -69,7 +69,7 @@ export function useMediaSelection(mode: 'single' | 'multi') {
     [mode]
   )
 
-  const reset = React.useCallback(() => setSelectedMap(new Map()), [])
+  const reset = () => setSelectedMap(emptySelection())
 
   const getSelection = React.useCallback(() => {
     const values = [...selectedMap.values()]

package/dist/assets/adapters/next/templates/init/hooks/use-upload.ts

@@ -190,11 +190,17 @@ export function useUpload(options: UseUploadOptions = {}): UseUploadReturn {
           formData.append('allowedTypes', validationConfig.allowedTypes.join(','))
         }
 
-        const response = await fetch('/api/admin/upload', {
-          method: 'POST',
-          body: formData,
-          signal: abortController.signal
-        })
+        let response: Response
+        try {
+          response = await fetch('/api/admin/upload', {
+            method: 'POST',
+            body: formData,
+            signal: abortController.signal
+          })
+        } catch (error) {
+          if (error instanceof Error && error.name === 'AbortError') throw error
+          throw new Error('Upload failed. Check your connection and try again.')
+        }
 
         const result = (await response.json()) as UploadFileResult
 

package/dist/assets/adapters/next/templates/init/lib/actions/audit/cleanup-audit-logs.ts

@@ -51,6 +51,7 @@ export async function cleanupAuditLogs(): Promise<CleanupAuditLogsResult> {
 
     return { success: true, deletedCount: deletedRows.length, cutoff }
   } catch (error) {
+    console.error('Failed to clean up audit logs:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to clean up audit logs')

package/dist/assets/adapters/next/templates/init/lib/actions/audit/query-audit-logs.ts

@@ -1,4 +1,4 @@
-import type { AuditLogEntry, AuditLogPage, AuditLogQuery } from '@admin/actions/audit/types'
+import type { AuditLogPage, AuditLogQuery } from '@admin/actions/audit/types'
 import { clampPage } from '@admin/actions/audit/clamp-page'
 import { getAuditLogOrderBy } from '@admin/actions/audit/get-audit-log-order-by'
 import { normalizePageSize } from '@admin/actions/audit/normalize-page-size'
@@ -62,7 +62,7 @@ export async function queryAuditLogs(query: AuditLogQuery = {}): Promise<AuditLo
   const resolvedPageSize = pageSize ?? total
 
   return {
-    auditLogs: rows as AuditLogEntry[],
+    auditLogs: rows,
     total,
     page,
     pageSize: resolvedPageSize,

package/dist/assets/adapters/next/templates/init/lib/actions/audit/record-audit-event.ts

@@ -6,7 +6,6 @@ import db from '@admin/db'
 import { auditLog } from '@admin/db/schema'
 
 const MAX_TARGET_TYPE_LENGTH = 100
-const MAX_SOURCE_TYPE_LENGTH = 50
 
 function truncate(value: string | null | undefined, maxLength: number): string | null {
   if (!value) return null
@@ -24,7 +23,7 @@ export async function recordAuditEvent(event: AdminEventContext): Promise<void>
     actorEmail: event.user?.email ?? null,
     actorName: event.user?.name ?? null,
     actorRole: typeof event.user?.role === 'string' ? event.user.role : null,
-    sourceType: truncate(event.sourceType, MAX_SOURCE_TYPE_LENGTH) ?? 'server_action',
+    sourceType: event.sourceType ?? 'server_action',
     ipAddress: truncate(event.ipAddress, MAX_IP_LENGTH),
     userAgent: truncate(event.userAgent, MAX_USER_AGENT_LENGTH),
     changedFields: normalizeChangedFields(event.changedFields),

package/dist/assets/adapters/next/templates/init/lib/actions/auth/client.ts

@@ -1,12 +1,15 @@
 'use client'
 
+import type { auth } from '@admin/auth/server'
+import { inferAdditionalFields } from 'better-auth/client/plugins'
 import { createAuthClient } from 'better-auth/react'
 
 export const authClient = createAuthClient({
   baseURL:
     process.env.NEXT_PUBLIC_BETTERSTART_AUTH_URL ||
     (typeof window !== 'undefined' ? window.location.origin : ''),
-  basePath: '/api/admin/auth'
+  basePath: '/api/admin/auth',
+  plugins: [inferAdditionalFields<typeof auth>()]
 })
 
 export const { signIn, signUp, signOut, useSession } = authClient

package/dist/assets/adapters/next/templates/init/lib/actions/entity-versions/get-entity-versions.ts

@@ -3,6 +3,7 @@
 import type { EntityVersionWithAuthor } from './types'
 import db from '@admin/db'
 import { entityVersions, user } from '@admin/db/schema'
+import { isRecord } from '@admin/utils/shared/is-record'
 import { and, desc, eq } from 'drizzle-orm'
 import { alias } from 'drizzle-orm/pg-core'
 import { cacheLife, cacheTag } from 'next/cache'
@@ -40,7 +41,10 @@ export async function getEntityVersions(
       .where(and(eq(entityVersions.entityType, entityType), eq(entityVersions.entityId, entityId)))
       .orderBy(desc(entityVersions.version), desc(entityVersions.createdAt))
 
-    return rows as EntityVersionWithAuthor[]
+    return rows.map((row) => ({
+      ...row,
+      data: isRecord(row.data) ? row.data : {}
+    }))
   } catch (error) {
     console.error('Error fetching entity versions:', error)
     return []

package/dist/assets/adapters/next/templates/init/lib/actions/forms/get-all-form-settings.ts

@@ -13,7 +13,7 @@ export async function getAllFormSettings(): Promise<FormSettingsData[]> {
 
   try {
     const settings = await db.select().from(formSettings)
-    return settings as FormSettingsData[]
+    return settings
   } catch (error) {
     console.error('Error fetching all form settings:', error)
     return []

package/dist/assets/adapters/next/templates/init/lib/actions/media/create-media.ts

@@ -43,7 +43,7 @@ export async function createMedia(data: CreateMediaInput): Promise<CreateMediaRe
         user: actor,
         timestamp: now,
         sourceType: 'admin_ui' as const,
-        changedFields: getTouchedFieldNames(data as unknown as Record<string, unknown>),
+        changedFields: getTouchedFieldNames(data),
         metadata: { contentType: media.contentType, size: media.size },
         ...auditRequestMetadata
       })
@@ -52,6 +52,7 @@ export async function createMedia(data: CreateMediaInput): Promise<CreateMediaRe
       ? { success: true, media }
       : { success: false, error: 'Failed to create media record' }
   } catch (error) {
+    console.error('Failed to create media record:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to create media record')

package/dist/assets/adapters/next/templates/init/lib/actions/media/delete-media-bulk.ts

@@ -45,6 +45,7 @@ export async function deleteMediaBulk(ids: string[]): Promise<DeleteMediaBulkRes
     }
     return { success: true, deletedCount: deletedRows.length }
   } catch (error) {
+    console.error('Failed to delete media:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to delete media')

package/dist/assets/adapters/next/templates/init/lib/actions/media/delete-media.ts

@@ -36,6 +36,7 @@ export async function deleteMedia(id: string): Promise<DeleteMediaResult> {
     })
     return { success: true }
   } catch (error) {
+    console.error('Failed to delete media:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to delete media')

package/dist/assets/adapters/next/templates/init/lib/actions/media/update-media.ts

@@ -41,15 +41,13 @@ export async function updateMedia(
       user: actor,
       timestamp: now,
       sourceType: 'admin_ui' as const,
-      changedFields: getChangedFieldNames(
-        previousMedia as unknown as Record<string, unknown>,
-        data as Record<string, unknown>
-      ),
+      changedFields: getChangedFieldNames(previousMedia, data),
       metadata: { contentType: previousMedia?.contentType ?? null },
       ...auditRequestMetadata
     })
     return { success: true }
   } catch (error) {
+    console.error('Failed to update media:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to update media')

package/dist/assets/adapters/next/templates/init/lib/actions/profile/change-own-password.ts

@@ -52,6 +52,7 @@ export async function changeOwnPassword(
 
     return { success: true }
   } catch (error) {
+    console.error('Failed to change password:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to change password')

package/dist/assets/adapters/next/templates/init/lib/actions/profile/update-email.ts

@@ -67,6 +67,7 @@ export async function updateEmail(
 
     return { success: true }
   } catch (error) {
+    console.error('Failed to update email:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to update email')

package/dist/assets/adapters/next/templates/init/lib/actions/upload/upload-files.ts

@@ -90,6 +90,7 @@ export async function uploadFiles(
 
     return { success: true, files: uploadedFiles }
   } catch (error) {
+    console.error('Failed to upload files:', error)
     return { success: false, error: toActionError(error, 'Failed to upload files') }
   }
 }

package/dist/assets/adapters/next/templates/init/lib/actions/upload/upload-media-from-url.ts

@@ -22,12 +22,21 @@ export async function uploadMediaFromUrl(
       return { success: false, error: 'Only HTTP and HTTPS URLs are allowed' }
     }
 
-    const response = await fetch(mediaUrl, {
-      headers: {
-        'User-Agent': 'Mozilla/5.0 (compatible; BetterStartMediaFetcher/1.0)'
-      },
-      signal: AbortSignal.timeout(REMOTE_FETCH_TIMEOUT_MS)
-    })
+    let response: Response
+    try {
+      response = await fetch(mediaUrl, {
+        headers: {
+          'User-Agent': 'Mozilla/5.0 (compatible; BetterStartMediaFetcher/1.0)'
+        },
+        signal: AbortSignal.timeout(REMOTE_FETCH_TIMEOUT_MS)
+      })
+    } catch (error) {
+      console.error('Failed to fetch remote media:', error)
+      return {
+        success: false,
+        error: "Couldn't reach that URL. Check the link and try again."
+      }
+    }
 
     if (!response.ok) {
       return {
@@ -129,6 +138,7 @@ export async function uploadMediaFromUrl(
       ]
     }
   } catch (error) {
+    console.error('Failed to upload media from URL:', error)
     return { success: false, error: toActionError(error, 'Failed to upload media from URL') }
   }
 }

package/dist/assets/adapters/next/templates/init/lib/actions/users/change-user-password.ts

@@ -70,6 +70,7 @@ export async function changeUserPassword(
 
     return { success: true }
   } catch (error) {
+    console.error('Failed to change user password:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to change user password')

package/dist/assets/adapters/next/templates/init/lib/actions/users/create-user.ts

@@ -48,7 +48,7 @@ export async function createUser(input: CreateUserInput): Promise<CreateUserResu
       user: actor,
       timestamp: now,
       sourceType: 'admin_ui' as const,
-      changedFields: getTouchedFieldNames(input as unknown as Record<string, unknown>),
+      changedFields: getTouchedFieldNames(input),
       metadata: { role: input.role },
       ...auditRequestMetadata
     })
@@ -66,6 +66,7 @@ export async function createUser(input: CreateUserInput): Promise<CreateUserResu
       }
     }
   } catch (error) {
+    console.error('Failed to create user:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to create user')

package/dist/assets/adapters/next/templates/init/lib/actions/users/delete-user.ts

@@ -39,6 +39,7 @@ export async function deleteUser(userId: string): Promise<DeleteUserResult> {
     })
     return { success: true }
   } catch (error) {
+    console.error('Failed to delete user:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to delete user')

package/dist/assets/adapters/next/templates/init/lib/actions/users/types.ts

@@ -15,7 +15,7 @@ export interface UsersPage {
   total: number
 }
 
-export interface CreateUserInput {
+export type CreateUserInput = {
   email: string
   name: string
   password: string

package/dist/assets/adapters/next/templates/init/lib/actions/users/update-user-role.ts

@@ -43,6 +43,7 @@ export async function updateUserRole(
 
     return { success: true }
   } catch (error) {
+    console.error('Failed to update user role:', error)
     return {
       success: false,
       error: toActionError(error, 'Failed to update user role')

package/dist/assets/adapters/next/templates/init/lib/db/core/schema.ts

@@ -1,3 +1,8 @@
+import type {
+  AuditLogAction,
+  AuditLogCategory,
+  AuditLogSourceType
+} from '@admin/actions/audit/types'
 import { sql } from 'drizzle-orm'
 import {
   boolean,
@@ -193,8 +198,8 @@ export const auditLog = pgTable(
   'AuditLog',
   {
     id: uuid().defaultRandom().primaryKey().notNull(),
-    category: varchar('category', { length: 50 }).notNull(),
-    action: varchar('action', { length: 50 }).notNull(),
+    category: varchar('category', { length: 50 }).notNull().$type<AuditLogCategory>(),
+    action: varchar('action', { length: 50 }).notNull().$type<AuditLogAction>(),
     targetType: varchar('target_type', { length: 100 }).notNull(),
     targetId: text('target_id'),
     targetLabel: text('target_label'),
@@ -204,14 +209,17 @@ export const auditLog = pgTable(
     actorEmail: text('actor_email'),
     actorName: text('actor_name'),
     actorRole: text('actor_role'),
-    sourceType: varchar('source_type', { length: 50 }).notNull().default('server_action'),
+    sourceType: varchar('source_type', { length: 50 })
+      .notNull()
+      .default('server_action')
+      .$type<AuditLogSourceType>(),
     ipAddress: varchar('ip_address', { length: 100 }),
     userAgent: varchar('user_agent', { length: 500 }),
     changedFields: text('changed_fields')
       .array()
       .notNull()
       .default(sql`ARRAY[]::text[]`),
-    metadata: jsonb('metadata'),
+    metadata: jsonb('metadata').$type<Record<string, unknown>>(),
     createdAt: timestamp('created_at', { precision: 3, mode: 'string' })
       .default(sql`CURRENT_TIMESTAMP`)
       .notNull()

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

@@ -40,11 +40,11 @@ export function registerHook<Event extends LifecycleHookEvent>(
   }
 }
 
-export function getRegisteredHooks<Event extends LifecycleHookEvent>(
+export function getRegisteredHooks(
   entityType: string,
-  event: Event
-): LifecycleHookHandler<Event>[] {
-  return [...((lifecycleHooks.get(entityType)?.get(event) ?? []) as LifecycleHookHandler<Event>[])]
+  event: LifecycleHookEvent
+): LifecycleHookHandler<LifecycleHookEvent>[] {
+  return [...(lifecycleHooks.get(entityType)?.get(event) ?? [])]
 }
 
 export function getLifecycleHookSummary(): Record<

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

@@ -5,15 +5,11 @@ import type {
   LifecycleHookAbort,
   LifecycleHookContext
 } from './types'
+import { isRecord } from '@admin/utils/shared/is-record'
 import { getRegisteredAdminHooks, getRegisteredHooks } from './registry'
 
 function isLifecycleHookAbort(value: unknown): value is LifecycleHookAbort {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    'abort' in value &&
-    (value as { abort: unknown }).abort === true
-  )
+  return isRecord(value) && value.abort === true
 }
 
 function createAbortError(event: BeforeLifecycleHookEvent, context: LifecycleHookContext): Error {
@@ -98,7 +94,7 @@ function toAdminEventContext(
 }
 
 function runSettledHook<Context>(
-  handler: (context: Context) => void | Promise<void>,
+  handler: (context: Context) => void,
   context: Context
 ): Promise<void> {
   try {

package/dist/assets/adapters/next/templates/init/pages/container-layout.tsx

@@ -0,0 +1,3 @@
+export default function ContainerLayout({ children }: { children: React.ReactNode }) {
+  return <div className="container mx-auto">{children}</div>
+}