@stacksjs/defaults 0.70.353 → 0.70.355

package/app/Actions/Dashboard/Ci/StatusAction.ts

@@ -1,6 +1,7 @@
 import { Action } from '@stacksjs/actions'
 import { dashboard as dashboardConfig } from '@stacksjs/config'
 import { getDashboardData } from '@stacksjs/github'
+import { response } from '@stacksjs/router'
 import { runCiFailureNotifier } from './failure-notifier'
 import { runRunnerPressureMonitor } from './runner-pressure-monitor'
 
@@ -57,17 +58,7 @@ export default new Action({
       // shape the page can render without leaking the env-var name to
       // every browser viewing the dashboard.
       console.error('[dashboard/ci] snapshot failed:', err)
-      return {
-        repos: [],
-        fetchedAt: new Date().toISOString(),
-        total: 0,
-        passing: 0,
-        failing: 0,
-        pending: 0,
-        noRuns: 0,
-        runners: {},
-        error: err instanceof Error ? err.message : 'unknown error',
-      }
+      return response.json({ message: 'CI status could not be loaded.' }, 502)
     }
   },
 })

package/app/Actions/Dashboard/Commerce/CommercePosCheckoutAction.ts

@@ -1,3 +1,4 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { randomUUIDv7 } from 'bun'
 import { Action } from '@stacksjs/actions'
 import { orders } from '@stacksjs/commerce'

package/app/Actions/Dashboard/Commerce/CommercePrintLogsAction.ts

@@ -2,7 +2,8 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
 import { formatDate, PrintDevice } from '@stacksjs/orm'
-import { request as routerRequest, response } from '@stacksjs/router'
+import { response } from '@stacksjs/router'
+import { dashboardRequestValue } from '../dashboard-request'
 import {
   commerceEnum,
   commerceIdentifier,
@@ -24,9 +25,7 @@ const SORTS = {
 type PrintLogSort = keyof typeof SORTS
 
 function queryValue(request: RequestInstance, key: string): string {
-  const query = ((routerRequest as any).query || {}) as Record<string, string | string[] | undefined>
-  const value = query[key]
-  return String((Array.isArray(value) ? value[0] : value) || request.get(key) || '').trim()
+  return dashboardRequestValue(request, key)
 }
 
 function selectedSort(value: string): PrintLogSort {

package/app/Actions/Dashboard/Commerce/CommerceProductDetailAction.ts

@@ -1,3 +1,4 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { config } from '@stacksjs/config'
 import { Category, Manufacturer, Product, ProductUnit, ProductVariant, Review } from '@stacksjs/orm'

package/app/Actions/Dashboard/Commerce/PaymentRefundAction.ts

@@ -1,3 +1,4 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { payments } from '@stacksjs/commerce'
 import { log } from '@stacksjs/logging'

package/app/Actions/Dashboard/Commerce/ProductUnitDefaultAction.ts

@@ -1,3 +1,4 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { products } from '@stacksjs/commerce'
 import { response } from '@stacksjs/router'

package/app/Actions/Dashboard/Commerce/TaxRateDefaultAction.ts

@@ -1,3 +1,4 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { tax } from '@stacksjs/commerce'
 import { response } from '@stacksjs/router'

package/app/Actions/Dashboard/Commerce/tax-rate-records.ts

@@ -19,6 +19,10 @@ export interface TaxRateRecord {
   region: TaxRateRegion
   status: 'active' | 'inactive'
   isDefault: boolean
+  /** Stable identifier application code matches on, independent of `name`. */
+  code: string
+  /** Whether a qualifying exemption stops this component being charged. */
+  exemptible: boolean
   createdAt: string
 }
 
@@ -50,6 +54,11 @@ export function normalizeTaxRateRecord(record: any): TaxRateRecord {
     ]),
     status: commerceEnum(commerceValue(record, 'status'), source, 'status', ['active', 'inactive']),
     isDefault: commerceBoolean(commerceValue(record, 'is_default', 'isDefault'), source, 'is_default'),
+    // Optional, both of them: a rate created before these columns existed has
+    // neither, and a dashboard that throws on an older row is worse than one
+    // that shows it without a badge.
+    code: String(commerceValue(record, 'code') ?? ''),
+    exemptible: Boolean(commerceValue(record, 'exemptible') ?? false),
     createdAt: commerceTimestamp(commerceValue(record, 'created_at', 'createdAt'), source),
   }
 }

package/app/Actions/Dashboard/Content/author-input.ts

@@ -9,7 +9,7 @@ export interface AuthorInput {
   avatar: string
 }
 
-// eslint-disable-next-line pickier/no-unused-vars
+// eslint-disable-next-line
 export function parseAuthorInput(inputRequest: RequestInstance): { data: AuthorInput } | { message: string } {
   const data = {
     name: str(inputRequest.get('name')).trim(),

package/app/Actions/Dashboard/Content/page-input.ts

@@ -10,7 +10,7 @@ export function parsePublished(value: unknown): boolean {
   return value === true || value === 1 || value === '1' || value === 'true'
 }
 
-// eslint-disable-next-line pickier/no-unused-vars
+// eslint-disable-next-line
 export function parsePageInput(inputRequest: RequestInstance): { data: PageInput } | { message: string } {
   const data = {
     title: str(inputRequest.get('title')).trim(),

package/app/Actions/Dashboard/DashboardStatsAction.ts

@@ -58,7 +58,6 @@ export default new Action({
       const { count: _count, ...metadata } = definition
       return formatDashboardStat(metadata, results[index])
     })
-    // eslint-disable-next-line pickier/no-unused-vars
     const issues = results.flatMap((result, index) => result.status === 'rejected'
       ? [{
           source: definitions[index].title,

package/app/Actions/Dashboard/Deployments/CreateDeployment.ts

@@ -1,8 +1,9 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { join } from 'node:path'
 import process from 'node:process'
 import { Deployment } from '@stacksjs/orm'
-import { request, response } from '@stacksjs/router'
+import { response } from '@stacksjs/router'
 import { booleanValue, deploymentCommandArgs } from './deployment-input'
 
 function gitValue(args: string[]): string {
@@ -22,7 +23,7 @@ export default new Action({
   method: 'POST',
   apiResponse: true,
 
-  async handle() {
+  async handle(request: RequestInstance) {
     const dryRun = booleanValue(request.get('dryRun') || request.get('dry_run'))
     const confirmed = booleanValue(request.get('confirmed'))
     if (!dryRun && !confirmed) {

package/app/Actions/Dashboard/Deployments/GetDeployment.ts

@@ -1,3 +1,4 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { Deployment } from '@stacksjs/orm'
 import { response } from '@stacksjs/router'

package/app/Actions/Dashboard/Deployments/UpdateDeployScript.ts

@@ -1,8 +1,9 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { mkdir, rename, writeFile } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
 import process from 'node:process'
-import { request, response } from '@stacksjs/router'
+import { response } from '@stacksjs/router'
 
 export default new Action({
   name: 'UpdateDeployScript',
@@ -10,7 +11,7 @@ export default new Action({
   method: 'PUT',
   apiResponse: true,
 
-  async handle() {
+  async handle(request: RequestInstance) {
     const content = String(request.get('content') || '')
     if (!content.trim())
       return response.json({ success: false, message: 'Deploy script content is required.' }, { status: 422 })

package/app/Actions/Dashboard/Email/InboxActivityAction.ts

@@ -2,8 +2,9 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
 import { emailSDK } from '@stacksjs/email'
-import { request as routerRequest, response } from '@stacksjs/router'
-import { defaultMailbox } from './mail-preference'
+import { response } from '@stacksjs/router'
+import { dashboardRequestValue } from '../dashboard-request'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 
 const RANGES = ['day', 'week', 'month', 'year'] as const
 type ActivityRange = typeof RANGES[number]
@@ -34,9 +35,7 @@ interface Bucket {
 }
 
 function queryValue(request: RequestInstance, key: string): string {
-  const query = ((routerRequest as any).query || {}) as Record<string, string | string[] | undefined>
-  const value = query[key]
-  return String((Array.isArray(value) ? value[0] : value) || request.get(key) || '').trim()
+  return dashboardRequestValue(request, key)
 }
 
 function startOfHour(date: Date): Date {
@@ -144,23 +143,36 @@ export default new Action({
     const range = RANGES.includes(requestedRange as ActivityRange)
       ? requestedRange as ActivityRange
       : 'week'
-    const mailbox = queryValue(request, 'mailbox') || defaultMailbox()
+    let mailbox: string
+    try {
+      mailbox = dashboardMailbox(request)
+    }
+    catch (error) {
+      return inboxActionError(error, 'Inbox activity could not be loaded.')
+    }
     const buckets = buildBuckets(range, new Date())
     const periodStart = buckets[0]!.start
     const periodEnd = buckets.at(-1)!.end
     const periodLength = periodEnd.getTime() - periodStart.getTime()
     const previousStart = new Date(periodStart.getTime() - periodLength)
 
-    const [inbox, deliveryRows] = await Promise.all([
-      emailSDK.getInbox(mailbox, { limit: 1000 }),
-      db
-        .selectFrom('notification_deliveries')
-        .select(['id', 'recipient', 'subject', 'status', 'sent_at', 'created_at'])
-        .where('channel', '=', 'email')
-        .where('created_at', '>=', previousStart.toISOString())
-        .orderBy('created_at', 'desc')
-        .execute() as Promise<DeliveryRow[]>,
-    ])
+    let inbox
+    let deliveryRows: DeliveryRow[]
+    try {
+      [inbox, deliveryRows] = await Promise.all([
+        emailSDK.getInbox(mailbox, { limit: 1000 }),
+        db
+          .selectFrom('notification_deliveries')
+          .select(['id', 'recipient', 'subject', 'status', 'sent_at', 'created_at'])
+          .where('channel', '=', 'email')
+          .where('created_at', '>=', previousStart.toISOString())
+          .orderBy('created_at', 'desc')
+          .execute() as Promise<DeliveryRow[]>,
+      ])
+    }
+    catch (error) {
+      return inboxActionError(error, 'Inbox activity could not be loaded.')
+    }
 
     const currentInbound = inbox.filter(email => inPeriod(email.date, periodStart, periodEnd))
     const previousInbound = inbox.filter(email => inPeriod(email.date, previousStart, periodStart))

package/app/Actions/Dashboard/Email/InboxAttachmentDownloadAction.ts

@@ -0,0 +1,45 @@
+import type { RequestInstance } from '@stacksjs/types'
+import { Action } from '@stacksjs/actions'
+import {
+  emailSDK,
+  inboxAttachmentContentDisposition,
+  inboxAttachmentContentType,
+} from '@stacksjs/email'
+import { response } from '@stacksjs/router'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
+
+export default new Action({
+  name: 'InboxAttachmentDownloadAction',
+  description: 'Downloads one attachment from a guarded inbound email.',
+  method: 'GET',
+  apiResponse: false,
+
+  async handle(request: RequestInstance) {
+    const messageId = String(request.getParam('id') || '')
+    const attachmentId = String(request.getParam('attachmentId') || '')
+
+    if (!messageId || !attachmentId)
+      return response.json({ message: 'A message ID and attachment ID are required.' }, 422)
+
+    try {
+      const mailbox = dashboardMailbox(request)
+      const result = await emailSDK.getAttachment(mailbox, messageId, attachmentId)
+      if (!result)
+        return response.json({ message: 'Attachment not found.' }, 404)
+
+      return new Response(result.body as BodyInit, {
+        status: 200,
+        headers: {
+          'Cache-Control': 'private, no-store',
+          'Content-Disposition': inboxAttachmentContentDisposition(result.attachment.name),
+          'Content-Length': String(result.body.byteLength),
+          'Content-Type': inboxAttachmentContentType(result.contentType),
+          'X-Content-Type-Options': 'nosniff',
+        },
+      })
+    }
+    catch (error) {
+      return inboxActionError(error, 'The attachment could not be downloaded.')
+    }
+  },
+})

package/app/Actions/Dashboard/Email/InboxDeleteAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { emailSDK } from '@stacksjs/email'
 import { response } from '@stacksjs/router'
-import { defaultMailbox } from './mail-preference'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 
 export default new Action({
   name: 'InboxDeleteAction',
@@ -11,16 +11,21 @@ export default new Action({
   apiResponse: true,
 
   async handle(request: RequestInstance) {
-    const mailbox = String(request.get('mailbox') || defaultMailbox())
     const messageId = String(request.getParam('id') || '')
 
     if (!messageId)
       return response.json({ message: 'A message ID is required.' }, 422)
 
-    const success = await emailSDK.delete(mailbox, messageId)
-    if (!success)
-      return response.json({ message: 'Email not found or it could not be deleted.' }, 404)
+    try {
+      const mailbox = dashboardMailbox(request)
+      const success = await emailSDK.delete(mailbox, messageId)
+      if (!success)
+        return response.json({ message: 'Email not found or it could not be deleted.' }, 404)
 
-    return response.json({ success: true, mailbox, messageId })
+      return response.json({ success: true, mailbox, messageId })
+    }
+    catch (error) {
+      return inboxActionError(error, 'The email could not be deleted.')
+    }
   },
 })

package/app/Actions/Dashboard/Email/InboxIndexAction.ts

@@ -1,7 +1,7 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { emailSDK } from '@stacksjs/email'
-import { response } from '@stacksjs/router'
-import { defaultMailbox } from './mail-preference'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 
 export interface InboxItem {
   messageId: string
@@ -22,9 +22,9 @@ export default new Action({
   method: 'GET',
   apiResponse: true,
 
-  async handle(request: any) {
+  async handle(request: RequestInstance) {
     try {
-      const mailbox = request?.query?.mailbox || defaultMailbox()
+      const mailbox = dashboardMailbox(request)
       const emails = await emailSDK.getInbox(mailbox, { limit: 1000 })
 
       return {
@@ -34,9 +34,7 @@ export default new Action({
       }
     }
     catch (err) {
-      return response.json({
-        message: err instanceof Error ? err.message : 'Inbox messages could not be loaded.',
-      }, 503)
+      return inboxActionError(err, 'Inbox messages could not be loaded.')
     }
   },
 })

package/app/Actions/Dashboard/Email/InboxMarkReadAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { emailSDK } from '@stacksjs/email'
 import { response } from '@stacksjs/router'
-import { defaultMailbox } from './mail-preference'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 
 export default new Action({
   name: 'InboxMarkReadAction',
@@ -11,16 +11,21 @@ export default new Action({
   apiResponse: true,
 
   async handle(request: RequestInstance) {
-    const mailbox = String(request.get('mailbox') || defaultMailbox())
     const messageId = String(request.get('messageId') || '')
 
     if (!messageId)
       return response.json({ message: 'messageId is required.' }, 422)
 
-    const success = await emailSDK.markAsRead(mailbox, messageId)
-    if (!success)
-      return response.json({ message: 'Email not found or its read state could not be updated.' }, 404)
+    try {
+      const mailbox = dashboardMailbox(request)
+      const success = await emailSDK.markAsRead(mailbox, messageId)
+      if (!success)
+        return response.json({ message: 'Email not found or its read state could not be updated.' }, 404)
 
-    return response.json({ success: true, mailbox, messageId })
+      return response.json({ success: true, mailbox, messageId })
+    }
+    catch (error) {
+      return inboxActionError(error, 'The email read state could not be updated.')
+    }
   },
 })

package/app/Actions/Dashboard/Email/InboxMarkUnreadAction.ts

@@ -2,7 +2,7 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { emailSDK } from '@stacksjs/email'
 import { response } from '@stacksjs/router'
-import { defaultMailbox } from './mail-preference'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 
 export default new Action({
   name: 'InboxMarkUnreadAction',
@@ -11,16 +11,21 @@ export default new Action({
   apiResponse: true,
 
   async handle(request: RequestInstance) {
-    const mailbox = String(request.get('mailbox') || defaultMailbox())
     const messageId = String(request.get('messageId') || '')
 
     if (!messageId)
       return response.json({ message: 'messageId is required.' }, 422)
 
-    const success = await emailSDK.markAsUnread(mailbox, messageId)
-    if (!success)
-      return response.json({ message: 'Email not found or its read state could not be updated.' }, 404)
+    try {
+      const mailbox = dashboardMailbox(request)
+      const success = await emailSDK.markAsUnread(mailbox, messageId)
+      if (!success)
+        return response.json({ message: 'Email not found or its read state could not be updated.' }, 404)
 
-    return response.json({ success: true, mailbox, messageId })
+      return response.json({ success: true, mailbox, messageId })
+    }
+    catch (error) {
+      return inboxActionError(error, 'The email read state could not be updated.')
+    }
   },
 })

package/app/Actions/Dashboard/Email/InboxPreferenceShowAction.ts

@@ -2,7 +2,8 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { MailPreference } from '@stacksjs/orm'
 import { response } from '@stacksjs/router'
-import { defaultMailbox, serializeMailPreference } from './mail-preference'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
+import { serializeMailPreference } from './mail-preference'
 
 export default new Action({
   name: 'InboxPreferenceShowAction',
@@ -11,8 +12,13 @@ export default new Action({
   apiResponse: true,
 
   async handle(request: RequestInstance) {
-    const mailbox = String(request.get('mailbox') || defaultMailbox()).trim().toLowerCase()
-    const record = await MailPreference.where('mailbox', '=', mailbox).first()
-    return response.json({ preference: serializeMailPreference(record, mailbox) })
+    try {
+      const mailbox = dashboardMailbox(request)
+      const record = await MailPreference.where('mailbox', '=', mailbox).first()
+      return response.json({ preference: serializeMailPreference(record, mailbox) })
+    }
+    catch (error) {
+      return inboxActionError(error, 'Mail settings could not be loaded.')
+    }
   },
 })

package/app/Actions/Dashboard/Email/InboxPreferenceUpdateAction.ts

@@ -2,8 +2,8 @@ import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { MailPreference } from '@stacksjs/orm'
 import { response } from '@stacksjs/router'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 import {
-  defaultMailbox,
   type MailPreferenceInput,
   mailPreferenceAttributes,
   normalizeStringList,
@@ -132,14 +132,13 @@ export default new Action({
   apiResponse: true,
 
   async handle(request: RequestInstance) {
-    const mailboxValue = request.get('mailbox')
-    const mailbox = (mailboxValue === null || mailboxValue === undefined
-      ? defaultMailbox()
-      : typeof mailboxValue === 'string' ? mailboxValue : '')
-      .trim()
-      .toLowerCase()
-    if (!/^[^\s@<>]+@[^\s@<>]+\.[^\s@<>]+$/.test(mailbox) || mailbox.length > 320)
-      return response.json({ message: 'The mail settings are invalid.', fields: { mailbox: 'Enter a valid mailbox.' } }, 422)
+    let mailbox: string
+    try {
+      mailbox = dashboardMailbox(request)
+    }
+    catch (error) {
+      return inboxActionError(error, 'Mail settings could not be updated.')
+    }
 
     const { fields, input } = inputFromRequest(request, mailbox)
     if (Object.keys(fields).length)

package/app/Actions/Dashboard/Email/InboxShowAction.ts

@@ -1,7 +1,8 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { emailSDK } from '@stacksjs/email'
 import { response } from '@stacksjs/router'
-import { defaultMailbox } from './mail-preference'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 import { sanitizeInboxHtml } from './sanitize-inbox-html'
 
 export default new Action({
@@ -10,10 +11,10 @@ export default new Action({
   method: 'GET',
   apiResponse: true,
 
-  async handle(request: any) {
+  async handle(request: RequestInstance) {
     try {
-      const mailbox = request?.query?.mailbox || defaultMailbox()
-      const messageId = request?.params?.id
+      const mailbox = dashboardMailbox(request)
+      const messageId = String(request.getParam('id') || '')
 
       if (!messageId)
         return response.json({ message: 'A message ID is required.' }, 422)
@@ -28,12 +29,11 @@ export default new Action({
         html: sanitizeInboxHtml(email.html ?? ''),
         text: email.text ?? '',
         metadata: email.metadata,
+        attachments: email.attachments,
       }
     }
     catch (err) {
-      return response.json({
-        message: err instanceof Error ? err.message : 'Email content could not be loaded.',
-      }, 503)
+      return inboxActionError(err, 'Email content could not be loaded.')
     }
   },
 })

package/app/Actions/Dashboard/Email/InboxStatsAction.ts

@@ -1,7 +1,7 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { emailSDK } from '@stacksjs/email'
-import { response } from '@stacksjs/router'
-import { defaultMailbox } from './mail-preference'
+import { dashboardMailbox, inboxActionError } from './inbox-request'
 
 export default new Action({
   name: 'InboxStatsAction',
@@ -9,9 +9,9 @@ export default new Action({
   method: 'GET',
   apiResponse: true,
 
-  async handle(request: any) {
+  async handle(request: RequestInstance) {
     try {
-      const mailbox = request?.query?.mailbox || defaultMailbox()
+      const mailbox = dashboardMailbox(request)
       const stats = await emailSDK.getInboxStats(mailbox)
 
       return {
@@ -20,9 +20,7 @@ export default new Action({
       }
     }
     catch (err) {
-      return response.json({
-        message: err instanceof Error ? err.message : 'Inbox statistics could not be loaded.',
-      }, 503)
+      return inboxActionError(err, 'Inbox statistics could not be loaded.')
     }
   },
 })

package/app/Actions/Dashboard/Email/inbox-request.ts

@@ -0,0 +1,33 @@
+import type { RequestInstance } from '@stacksjs/types'
+import { config } from '@stacksjs/config'
+import { inboxMailboxPath, InvalidInboxMailboxError } from '@stacksjs/email'
+import { response } from '@stacksjs/router'
+import { defaultMailbox } from './mail-preference'
+
+function configuredMailDomain(): string {
+  const email = (config as any)?.email || {}
+  const fromAddress = String(email.from?.address || '').trim()
+  const fromDomain = fromAddress.includes('@') ? fromAddress.split('@').at(-1) : ''
+  return String(email.domain || fromDomain || 'stacksjs.com').trim().toLowerCase()
+}
+
+export function dashboardMailbox(request: RequestInstance): string {
+  const value = request.get('mailbox')
+  if (value !== null && value !== undefined && typeof value !== 'string')
+    throw new InvalidInboxMailboxError()
+
+  return inboxMailboxPath(value?.trim() || defaultMailbox(), configuredMailDomain()).address
+}
+
+export function inboxActionError(error: unknown, fallback: string): Response {
+  if (error instanceof InvalidInboxMailboxError) {
+    return response.json({
+      message: 'Enter a mailbox on the configured email domain.',
+      fields: { mailbox: 'Enter a mailbox on the configured email domain.' },
+    }, 422)
+  }
+
+  return response.json({
+    message: fallback,
+  }, 503)
+}

package/app/Actions/Dashboard/Infrastructure/LogIndexAction.ts

@@ -1,15 +1,14 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { db } from '@stacksjs/database'
-import { request as routerRequest, response } from '@stacksjs/router'
+import { response } from '@stacksjs/router'
+import { dashboardRequestValue } from '../dashboard-request'
 import { DASHBOARD_LOG_TYPES, normalizeDashboardLog, summarizeDashboardLogTypes } from './log-dashboard'
 
 const RANGES = ['1', '7', '30', '90', 'all'] as const
 
 function queryValue(request: RequestInstance, key: string): string {
-  const query = ((routerRequest as any).query || {}) as Record<string, string | string[] | undefined>
-  const value = query[key]
-  return String((Array.isArray(value) ? value[0] : value) || request.get(key) || '').trim()
+  return dashboardRequestValue(request, key)
 }
 
 export default new Action({

package/app/Actions/Dashboard/Infrastructure/ServerShowAction.ts

@@ -1,3 +1,4 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { response } from '@stacksjs/router'
 import { tsCloud } from '~/config/cloud'
@@ -9,12 +10,8 @@ export default new Action({
   description: 'Returns one configured server or persisted deployment.',
   method: 'GET',
   apiResponse: true,
-  async handle(request) {
-    const identifier = String(
-      (request as any)?.params?.id
-      ?? (request as any)?.param?.('id')
-      ?? '',
-    )
+  async handle(request: RequestInstance) {
+    const identifier = request.getParam('id')
     if (!identifier)
       return response.json({ error: 'A server identifier is required.' }, 400)