@stacksjs/defaults 0.70.355 → 0.70.357

package/app/Actions/Dashboard/Kanban/CardLabelsSyncAction.ts

@@ -1,7 +1,7 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface SyncInput {
   labelIds?: unknown
@@ -92,8 +92,7 @@ export default new Action({
       return { cardId, labels }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardLabelsSyncAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardLabelsSyncAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/CardShowAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
 import { modelBoolean } from './kanban-model'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface CardRow {
   id: number
@@ -118,8 +118,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardShowAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardShowAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/CardStoreAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
 import { BoardColumn, Card } from '@stacksjs/orm'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface CardInput {
   columnId?: unknown
@@ -90,8 +90,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardStoreAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardStoreAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/CardUpdateAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { Card } from '@stacksjs/orm'
 import { modelBoolean, modelNullableString, modelNumber, modelString, modelValue, refreshModel } from './kanban-model'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface CardInput {
   title?: unknown
@@ -81,8 +81,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardUpdateAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardUpdateAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/CardsReorderAction.ts

@@ -1,7 +1,7 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface ColumnReorder {
   columnId: number
@@ -135,8 +135,7 @@ export default new Action({
       return { moved: allCardIds.size, boardId }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardsReorderAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardsReorderAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/ColumnDestroyAction.ts

@@ -1,7 +1,7 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 /**
  * `DELETE /api/dashboard/kanban/columns/:id`.
@@ -48,8 +48,7 @@ export default new Action({
       return { deleted: true, id }
     }
     catch (err) {
-      console.error('[dashboard/kanban] ColumnDestroyAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'ColumnDestroyAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/ColumnStoreAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
 import { Board, BoardColumn } from '@stacksjs/orm'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface ColumnInput {
   boardId?: unknown
@@ -75,8 +75,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] ColumnStoreAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'ColumnStoreAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/ColumnUpdateAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { BoardColumn } from '@stacksjs/orm'
 import { modelNullableString, modelNumber, modelString, modelValue, refreshModel } from './kanban-model'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface ColumnInput {
   name?: unknown
@@ -80,8 +80,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] ColumnUpdateAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'ColumnUpdateAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/ColumnsReorderAction.ts

@@ -1,7 +1,7 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface ReorderInput {
   boardId?: unknown
@@ -75,8 +75,7 @@ export default new Action({
       return { reordered: ids.length }
     }
     catch (err) {
-      console.error('[dashboard/kanban] ColumnsReorderAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'ColumnsReorderAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/LabelDestroyAction.ts

@@ -1,7 +1,7 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 /**
  * `DELETE /api/dashboard/kanban/labels/:id`.
@@ -30,8 +30,7 @@ export default new Action({
       return { deleted: true, id }
     }
     catch (err) {
-      console.error('[dashboard/kanban] LabelDestroyAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'LabelDestroyAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/LabelStoreAction.ts

@@ -1,7 +1,7 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { Board, Label } from '@stacksjs/orm'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface LabelInput {
   boardId?: unknown
@@ -51,8 +51,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] LabelStoreAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'LabelStoreAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/LabelUpdateAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { Label } from '@stacksjs/orm'
 import { modelNumber, modelString, refreshModel } from './kanban-model'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface LabelInput {
   name?: unknown
@@ -74,8 +74,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] LabelUpdateAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'LabelUpdateAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/UsersListAction.ts

@@ -1,6 +1,6 @@
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 /**
  * `GET /api/dashboard/kanban/users`.
@@ -30,8 +30,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] UsersListAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'UsersListAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/kanban-response.ts

@@ -3,3 +3,8 @@ import { response } from '@stacksjs/router'
 export function kanbanError(error: string, status: number): Response {
   return response.json({ error }, status)
 }
+
+export function kanbanActionError(error: unknown, action: string): Response {
+  console.error(`[dashboard/kanban] ${action} failed:`, error)
+  return kanbanError('The Kanban request could not be completed.', 500)
+}

package/app/Actions/Dashboard/Library/CreateComponent.ts

@@ -3,12 +3,14 @@ import { existsSync } from 'node:fs'
 import { Action, createComponent as scaffoldComponent } from '@stacksjs/actions'
 import { userComponentsPath } from '@stacksjs/path'
 import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { componentSourceRows } from './library-source'
 
 export default new Action({
   name: 'CreateComponent',
   description: 'Creates a new STX component.',
   method: 'POST',
+  apiResponse: true,
 
   async handle(request: RequestInstance) {
     const name = String(request.get('name') || '').trim()
@@ -16,13 +18,20 @@ export default new Action({
     if (!/^[A-Z][A-Za-z0-9]*$/.test(name))
       return response.json({ message: 'Use a PascalCase component name.' }, 422)
 
-    const destination = userComponentsPath(`${name}.stx`)
-    if (existsSync(destination))
-      return response.json({ message: 'A component with that name already exists.' }, 409)
+    try {
+      const destination = userComponentsPath(`${name}.stx`)
+      if (existsSync(destination))
+        return response.json({ message: 'A component with that name already exists.' }, 409)
 
-    await scaffoldComponent({ name })
+      await scaffoldComponent({ name })
 
-    const created = componentSourceRows().find(component => component.name === name)
-    return response.json({ component: created }, 201)
+      const created = componentSourceRows().find(component => component.name === name)
+      if (!created)
+        throw new Error(`Scaffolded component ${name} could not be found in resources/components.`)
+      return response.json({ component: created }, 201)
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'The component could not be created.', 'CreateComponent', 500)
+    }
   },
 })

package/app/Actions/Dashboard/Library/CreateFunction.ts

@@ -3,12 +3,14 @@ import { existsSync } from 'node:fs'
 import { Action, createFunction as scaffoldFunction } from '@stacksjs/actions'
 import { userFunctionsPath } from '@stacksjs/path'
 import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { functionSourceRows } from './library-source'
 
 export default new Action({
   name: 'CreateFunction',
   description: 'Creates a new function.',
   method: 'POST',
+  apiResponse: true,
 
   async handle(request: RequestInstance) {
     const name = String(request.get('name') || '').trim().toLowerCase()
@@ -16,13 +18,20 @@ export default new Action({
     if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(name))
       return response.json({ message: 'Use a lowercase kebab-case function name.' }, 422)
 
-    const destination = userFunctionsPath(`${name}.ts`)
-    if (existsSync(destination))
-      return response.json({ message: 'A function with that name already exists.' }, 409)
+    try {
+      const destination = userFunctionsPath(`${name}.ts`)
+      if (existsSync(destination))
+        return response.json({ message: 'A function with that name already exists.' }, 409)
 
-    await scaffoldFunction({ name })
+      await scaffoldFunction({ name })
 
-    const created = functionSourceRows().find(fn => fn.name === name)
-    return response.json({ function: created }, 201)
+      const created = functionSourceRows().find(fn => fn.name === name)
+      if (!created)
+        throw new Error(`Scaffolded function ${name} could not be found in resources/functions.`)
+      return response.json({ function: created }, 201)
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'The function could not be created.', 'CreateFunction', 500)
+    }
   },
 })

package/app/Actions/Dashboard/Library/DependencyIndexAction.ts

@@ -1,94 +1,105 @@
 import { Action } from '@stacksjs/actions'
 import { existsSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
+import { dashboardOperationalError } from '../dashboard-response'
 
-export default new Action({
-  name: 'DependencyIndexAction',
-  description: 'Returns dependency data for the dashboard.',
-  method: 'GET',
-  async handle() {
-    const projectRoot = process.cwd()
-    const lockPath = join(projectRoot, 'bun.lock')
+function dependencySnapshot() {
+  const projectRoot = process.cwd()
+  const lockPath = join(projectRoot, 'bun.lock')
 
-    const declared: Array<Record<string, unknown>> = []
-    const transitive: Array<Record<string, unknown>> = []
-    let workspaceCount = 0
-    let thirdPartyCount = 0
-    let transitiveCount = 0
-    let totalCount = 0
+  const declared: Array<Record<string, unknown>> = []
+  const transitive: Array<Record<string, unknown>> = []
+  let workspaceCount = 0
+  let thirdPartyCount = 0
+  let transitiveCount = 0
+  let totalCount = 0
 
-    if (!existsSync(lockPath)) {
-      return {
-        available: false,
-        source: 'bun.lock',
-        declared,
-        thirdParty: [],
-        workspace: [],
-        transitive,
-        stats: [],
-        totalCount,
-        transitiveCount,
-        workspaceCount,
-        thirdPartyCount,
-      }
+  if (!existsSync(lockPath)) {
+    return {
+      available: false,
+      source: 'bun.lock',
+      declared,
+      thirdParty: [],
+      workspace: [],
+      transitive,
+      stats: [],
+      totalCount,
+      transitiveCount,
+      workspaceCount,
+      thirdPartyCount,
     }
+  }
 
-    const declaredSet: Record<string, boolean> = {}
-    const lockfile = Bun.JSONC.parse(readFileSync(lockPath, 'utf-8')) as {
-      workspaces?: Record<string, { name?: string, dependencies?: Record<string, string>, devDependencies?: Record<string, string> }>
-      packages?: Record<string, [string, ...unknown[]]>
-    }
-    const workspaces = lockfile.workspaces || {}
-    const workspaceNames = new Set(
-      Object.values(workspaces)
-        .map(workspace => workspace.name)
-        .filter((name): name is string => Boolean(name)),
-    )
+  const declaredSet: Record<string, boolean> = {}
+  const lockfile = Bun.JSONC.parse(readFileSync(lockPath, 'utf-8')) as {
+    workspaces?: Record<string, { name?: string, dependencies?: Record<string, string>, devDependencies?: Record<string, string> }>
+    packages?: Record<string, [string, ...unknown[]]>
+  }
+  const workspaces = lockfile.workspaces || {}
+  const workspaceNames = new Set(
+    Object.values(workspaces)
+      .map(workspace => workspace.name)
+      .filter((name): name is string => Boolean(name)),
+  )
 
-    for (const wsKey of Object.keys(workspaces)) {
-      const ws = workspaces[wsKey]
-      const allDeps = { ...ws.dependencies, ...ws.devDependencies }
-      for (const depName of Object.keys(allDeps)) {
-        if (declaredSet[depName]) continue
-        declaredSet[depName] = true
-        const version = allDeps[depName]
-        const isWorkspace = workspaceNames.has(depName)
-        declared.push({ name: depName, version, isWorkspace, isScoped: depName.includes('/') })
-      }
+  for (const wsKey of Object.keys(workspaces)) {
+    const ws = workspaces[wsKey]
+    const allDeps = { ...ws.dependencies, ...ws.devDependencies }
+    for (const depName of Object.keys(allDeps)) {
+      if (declaredSet[depName]) continue
+      declaredSet[depName] = true
+      const version = allDeps[depName]
+      const isWorkspace = workspaceNames.has(depName)
+      declared.push({ name: depName, version, isWorkspace, isScoped: depName.includes('/') })
     }
-    declared.sort((a, b) => String(a.name).localeCompare(String(b.name)))
+  }
+  declared.sort((a, b) => String(a.name).localeCompare(String(b.name)))
 
-    const transitiveSet = new Set<string>()
-    for (const value of Object.values(lockfile.packages || {})) {
-      const resolution = value[0]
-      if (resolution.includes('@workspace:')) continue
-      const versionSeparator = resolution.startsWith('@')
-        ? resolution.indexOf('@', 1)
-        : resolution.lastIndexOf('@')
-      if (versionSeparator <= 0) continue
-      const name = resolution.slice(0, versionSeparator)
-      const version = resolution.slice(versionSeparator + 1)
-      if (declaredSet[name] || transitiveSet.has(name)) continue
-      transitiveSet.add(name)
-      transitive.push({ name, version, isScoped: name.includes('/') })
-    }
-    transitive.sort((a, b) => String(a.name).localeCompare(String(b.name)))
+  const transitiveSet = new Set<string>()
+  for (const value of Object.values(lockfile.packages || {})) {
+    const resolution = value[0]
+    if (resolution.includes('@workspace:')) continue
+    const versionSeparator = resolution.startsWith('@')
+      ? resolution.indexOf('@', 1)
+      : resolution.lastIndexOf('@')
+    if (versionSeparator <= 0) continue
+    const name = resolution.slice(0, versionSeparator)
+    const version = resolution.slice(versionSeparator + 1)
+    if (declaredSet[name] || transitiveSet.has(name)) continue
+    transitiveSet.add(name)
+    transitive.push({ name, version, isScoped: name.includes('/') })
+  }
+  transitive.sort((a, b) => String(a.name).localeCompare(String(b.name)))
+
+  workspaceCount = declared.filter(p => p.isWorkspace).length
+  thirdPartyCount = declared.length - workspaceCount
+  transitiveCount = transitive.length
+  totalCount = declared.length + transitiveCount
 
-    workspaceCount = declared.filter(p => p.isWorkspace).length
-    thirdPartyCount = declared.length - workspaceCount
-    transitiveCount = transitive.length
-    totalCount = declared.length + transitiveCount
+  const thirdParty = declared.filter(p => !p.isWorkspace)
+  const workspace = declared.filter(p => p.isWorkspace)
 
-    const thirdParty = declared.filter(p => !p.isWorkspace)
-    const workspace = declared.filter(p => p.isWorkspace)
+  const stats = [
+    { label: 'Declared', value: String(declared.length) },
+    { label: 'Third-Party', value: String(thirdPartyCount) },
+    { label: 'Workspace', value: String(workspaceCount) },
+    { label: 'Transitive', value: String(transitiveCount) },
+  ]
 
-    const stats = [
-      { label: 'Declared', value: String(declared.length) },
-      { label: 'Third-Party', value: String(thirdPartyCount) },
-      { label: 'Workspace', value: String(workspaceCount) },
-      { label: 'Transitive', value: String(transitiveCount) },
-    ]
+  return { available: true, source: 'bun.lock', declared, thirdParty, workspace, transitive, stats, totalCount, transitiveCount, workspaceCount, thirdPartyCount }
+}
 
-    return { available: true, source: 'bun.lock', declared, thirdParty, workspace, transitive, stats, totalCount, transitiveCount, workspaceCount, thirdPartyCount }
+export default new Action({
+  name: 'DependencyIndexAction',
+  description: 'Returns dependency data for the dashboard.',
+  method: 'GET',
+  apiResponse: true,
+  async handle() {
+    try {
+      return dependencySnapshot()
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'Dependency data could not be loaded.', 'DependencyIndexAction')
+    }
   },
 })

package/app/Actions/Dashboard/Library/GetAverageReleaseTime.ts

@@ -1,5 +1,6 @@
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
+import { dashboardOperationalError } from '../dashboard-response'
 
 export default new Action({
   name: 'GetAverageReleaseTime',
@@ -7,24 +8,29 @@ export default new Action({
   apiResponse: true,
 
   async handle() {
-    const rows = await db
-      .selectFrom('releases')
-      .select(['created_at'])
-      .whereNotNull('created_at')
-      .orderBy('created_at')
-      .execute() as unknown as Array<{ created_at: string }>
+    try {
+      const rows = await db
+        .selectFrom('releases')
+        .select(['created_at'])
+        .whereNotNull('created_at')
+        .orderBy('created_at')
+        .execute() as unknown as Array<{ created_at: string }>
 
-    const timestamps = rows
-      .map(row => new Date(row.created_at).getTime())
-      .filter(Number.isFinite)
+      const timestamps = rows
+        .map(row => new Date(row.created_at).getTime())
+        .filter(Number.isFinite)
 
-    if (timestamps.length < 2)
-      return { averageSeconds: null, intervals: 0 }
+      if (timestamps.length < 2)
+        return { averageSeconds: null, intervals: 0 }
 
-    const elapsed = timestamps.slice(1).reduce((total, value, index) => total + value - timestamps[index]!, 0)
-    return {
-      averageSeconds: Math.round(elapsed / (timestamps.length - 1) / 1000),
-      intervals: timestamps.length - 1,
+      const elapsed = timestamps.slice(1).reduce((total, value, index) => total + value - timestamps[index]!, 0)
+      return {
+        averageSeconds: Math.round(elapsed / (timestamps.length - 1) / 1000),
+        intervals: timestamps.length - 1,
+      }
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'Average release time could not be loaded.', 'GetAverageReleaseTime')
     }
   },
 })

package/app/Actions/Dashboard/Library/GetComponents.ts

@@ -1,20 +1,27 @@
 import { Action } from '@stacksjs/actions'
+import { dashboardOperationalError } from '../dashboard-response'
 import { componentSourceRows } from './library-source'
 
 export default new Action({
   name: 'GetComponents',
   description: 'Gets your UI components.',
   method: 'GET',
+  apiResponse: true,
 
   async handle() {
-    const components = componentSourceRows()
-    const categories = ['All', ...new Set(components.map(component => component.category))]
+    try {
+      const components = componentSourceRows()
+      const categories = ['All', ...new Set(components.map(component => component.category))]
 
-    return {
-      components,
-      categories,
-      totalBytes: components.reduce((sum, component) => sum + component.bytes, 0),
-      sourceRoot: 'resources/components',
+      return {
+        components,
+        categories,
+        totalBytes: components.reduce((sum, component) => sum + component.bytes, 0),
+        sourceRoot: 'resources/components',
+      }
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'Component library could not be loaded.', 'GetComponents')
     }
   },
 })

package/app/Actions/Dashboard/Library/GetDownloadCount.ts

@@ -1,5 +1,6 @@
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
+import { dashboardOperationalError } from '../dashboard-response'
 
 export default new Action({
   name: 'GetDownloadCount',
@@ -7,11 +8,19 @@ export default new Action({
   apiResponse: true,
 
   async handle() {
-    const row = await db
-      .selectFrom('releases')
-      .select(db.fn.sum('downloads').as('downloads'))
-      .executeTakeFirst() as { downloads?: number | string | null } | undefined
+    try {
+      const row = await db
+        .selectFrom('releases')
+        .select(db.fn.sum('downloads').as('downloads'))
+        .executeTakeFirst() as { downloads?: number | string | null } | undefined
+      const downloads = Number(row?.downloads || 0)
+      if (!Number.isSafeInteger(downloads) || downloads < 0)
+        throw new TypeError('Release download total must be a non-negative integer.')
 
-    return { downloads: Number(row?.downloads || 0), source: 'releases.downloads' }
+      return { downloads, source: 'releases.downloads' }
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'Release download count could not be loaded.', 'GetDownloadCount')
+    }
   },
 })