@stacksjs/defaults 0.70.355 → 0.70.356

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

@@ -1,7 +1,7 @@
 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 BoardRow {
   id: number
@@ -70,8 +70,7 @@ export default new Action({
       return { boards }
     }
     catch (err) {
-      console.error('[dashboard/kanban] BoardsIndexAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'BoardsIndexAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/BoardsReorderAction.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 {
   /**
@@ -67,8 +67,7 @@ export default new Action({
       return { reordered: ids.length }
     }
     catch (err) {
-      console.error('[dashboard/kanban] BoardsReorderAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'BoardsReorderAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/CardAssigneesSyncAction.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 {
   userIds?: unknown
@@ -94,8 +94,7 @@ export default new Action({
       return { cardId, assignees }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardAssigneesSyncAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardAssigneesSyncAction')
     }
   },
 })

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

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

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

@@ -3,7 +3,7 @@ import { Action } from '@stacksjs/actions'
 import { Card, CardComment } from '@stacksjs/orm'
 import { cardCommentResponse } from './kanban-comment'
 import { refreshModel } from './kanban-model'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface CommentInput {
   body?: unknown
@@ -52,8 +52,7 @@ export default new Action({
       }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardCommentStoreAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardCommentStoreAction')
     }
   },
 })

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

@@ -3,7 +3,7 @@ import { Action } from '@stacksjs/actions'
 import { CardComment, User } from '@stacksjs/orm'
 import { cardCommentResponse } from './kanban-comment'
 import { modelNullableNumber, refreshModel } from './kanban-model'
-import { kanbanError } from './kanban-response'
+import { kanbanActionError, kanbanError } from './kanban-response'
 
 interface CommentInput {
   body?: unknown
@@ -37,8 +37,7 @@ export default new Action({
       return { comment: cardCommentResponse(updated, author) }
     }
     catch (error) {
-      console.error('[dashboard/kanban] CardCommentUpdateAction failed:', error)
-      return kanbanError(error instanceof Error ? error.message : 'unknown error', 500)
+      return kanbanActionError(error, 'CardCommentUpdateAction')
     }
   },
 })

package/app/Actions/Dashboard/Kanban/CardDestroyAction.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/cards/:id`.
@@ -37,8 +37,7 @@ export default new Action({
       return { deleted: true, id }
     }
     catch (err) {
-      console.error('[dashboard/kanban] CardDestroyAction failed:', err)
-      return kanbanError(err instanceof Error ? err.message : 'unknown error', 500)
+      return kanbanActionError(err, 'CardDestroyAction')
     }
   },
 })

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)
+    }
   },
 })