@stacksjs/defaults 0.70.354 → 0.70.356

package/app/Actions/Dashboard/Buddy/BuddyChatAction.ts

@@ -4,6 +4,7 @@ import { Action } from '@stacksjs/actions'
 import { buddyState, createAIClient } from '@stacksjs/ai'
 import { config } from '@stacksjs/config'
 import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { buddySystemPrompt, isBuddyProviderConfigured, publicBuddyHistory, resolveBuddyProvider } from './buddy-chat'
 
 export default new Action({
@@ -49,9 +50,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Buddy could not answer the question.',
-      }, 502)
+      return dashboardOperationalError(error, 'Buddy could not answer the question.', 'BuddyChatAction', 502)
     }
   },
 })

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

@@ -1,6 +1,8 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { dashboard as dashboardConfig } from '@stacksjs/config'
 import { fetchRunJobs } from '@stacksjs/github'
+import { response } from '@stacksjs/router'
 
 /**
  * `GET /api/dashboard/ci/repos/:owner/:name/runs/:runId/jobs`
@@ -19,27 +21,26 @@ export default new Action({
   description: 'Job-level breakdown for a single workflow run (drilldown expand).',
   method: 'GET',
   apiResponse: true,
-  async handle(request) {
+  async handle(request: RequestInstance) {
     const ci = dashboardConfig?.ci
 
     if (!ci?.enabled) {
       return { jobs: [], disabled: true }
     }
 
-    const owner = String((request as any)?.params?.owner ?? (request as any)?.param?.('owner') ?? '').trim()
-    const repo = String((request as any)?.params?.name ?? (request as any)?.param?.('name') ?? '').trim()
-    const runIdRaw = (request as any)?.params?.runId ?? (request as any)?.param?.('runId') ?? null
-    const runId = Number(runIdRaw)
+    const owner = request.getParam('owner').trim()
+    const repo = request.getParam('name').trim()
+    const runId = Number(request.getParam('runId'))
     if (!owner || !repo) {
-      return { error: 'Both `owner` and `name` route params are required.', status: 400 }
+      return response.json({ message: 'Both owner and name route parameters are required.' }, 400)
     }
     if (!Number.isFinite(runId) || runId <= 0) {
-      return { error: '`runId` must be a positive integer.', status: 400 }
+      return response.json({ message: 'The run ID must be a positive integer.' }, 400)
     }
 
     const allowedOrgs = ci.orgs ?? []
     if (allowedOrgs.length > 0 && !allowedOrgs.includes(owner)) {
-      return { error: 'Org not in `config.dashboard.ci.orgs`.', status: 403 }
+      return response.json({ message: 'This organization is not configured for CI tracking.' }, 403)
     }
 
     try {
@@ -48,13 +49,7 @@ export default new Action({
     }
     catch (err) {
       console.error('[dashboard/ci] RepoRunJobsAction failed:', err)
-      return {
-        owner,
-        repo,
-        runId,
-        jobs: [],
-        error: err instanceof Error ? err.message : 'unknown error',
-      }
+      return response.json({ message: 'Workflow jobs could not be loaded.' }, 502)
     }
   },
 })

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

@@ -1,6 +1,9 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { dashboard as dashboardConfig } from '@stacksjs/config'
 import { fetchWorkflowRuns } from '@stacksjs/github'
+import { response } from '@stacksjs/router'
+import { dashboardRequestValue } from '../dashboard-request'
 
 /**
  * `GET /api/dashboard/ci/repos/:owner/:name/runs?limit=N`
@@ -23,32 +26,32 @@ export default new Action({
   description: 'Latest N workflow runs for a single repo (drilldown).',
   method: 'GET',
   apiResponse: true,
-  async handle(request) {
+  async handle(request: RequestInstance) {
     const ci = dashboardConfig?.ci
 
     if (!ci?.enabled) {
       return { owner: null, repo: null, runs: [], disabled: true }
     }
 
-    const owner = String((request as any)?.params?.owner ?? (request as any)?.param?.('owner') ?? '').trim()
-    const repo = String((request as any)?.params?.name ?? (request as any)?.param?.('name') ?? '').trim()
+    const owner = request.getParam('owner').trim()
+    const repo = request.getParam('name').trim()
     if (!owner || !repo) {
-      return { error: 'Both `owner` and `name` route params are required.', status: 400 }
+      return response.json({ message: 'Both owner and name route parameters are required.' }, 400)
     }
 
     // Scope check: only fetch runs for orgs the user explicitly
     // configured. Stops the endpoint from being a generic GH proxy.
     const allowedOrgs = ci.orgs ?? []
     if (allowedOrgs.length > 0 && !allowedOrgs.includes(owner)) {
-      return { error: 'Org not in `config.dashboard.ci.orgs`.', status: 403 }
+      return response.json({ message: 'This organization is not configured for CI tracking.' }, 403)
     }
 
-    const url = new URL(request.url ?? `http://localhost/`)
-    const rawLimit = Number(url.searchParams.get('limit') ?? '20')
+    const rawLimit = Number(dashboardRequestValue(request, 'limit', '20'))
     const limit = Number.isFinite(rawLimit) && rawLimit > 0
       ? Math.min(Math.floor(rawLimit), 100)
       : 20
-    const branch = url.searchParams.get('branch') || undefined
+    const branchValue = dashboardRequestValue(request, 'branch')
+    const branch = branchValue || undefined
 
     try {
       const runs = await fetchWorkflowRuns(owner, repo, { limit, branch })
@@ -56,12 +59,7 @@ export default new Action({
     }
     catch (err) {
       console.error('[dashboard/ci] RepoRunsAction failed:', err)
-      return {
-        owner,
-        repo,
-        runs: [],
-        error: err instanceof Error ? err.message : 'unknown error',
-      }
+      return response.json({ message: 'Workflow runs could not be loaded.' }, 502)
     }
   },
 })

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

@@ -1,5 +1,8 @@
+import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { dashboard as dashboardConfig } from '@stacksjs/config'
+import { response } from '@stacksjs/router'
+import { dashboardRequestValue } from '../dashboard-request'
 import { fetchRunnerHistory } from './runner-pressure-monitor'
 
 /**
@@ -12,33 +15,31 @@ import { fetchRunnerHistory } from './runner-pressure-monitor'
  * configured retention window — older samples aren't available
  * because they've been pruned.
  *
- * Soft-errors to an empty samples array on any failure so the
- * sparkline gracefully degrades to "no history yet" instead of
- * yelling at the user.
+ * Operational failures use a real 503 response so the client can
+ * distinguish unavailable history from a valid empty sample set.
  */
 export default new Action({
   name: 'Dashboard CI Runner History',
   description: 'Recent runner-sample history for one org (sparkline data).',
   method: 'GET',
   apiResponse: true,
-  async handle(request) {
+  async handle(request: RequestInstance) {
     const ci = dashboardConfig?.ci
     if (!ci?.enabled || !ci.alerts?.enabled) {
       return { org: null, samples: [], disabled: true }
     }
 
-    const url = new URL(request.url ?? 'http://localhost/')
-    const org = String(url.searchParams.get('org') ?? '').trim()
+    const org = dashboardRequestValue(request, 'org')
     if (!org) {
-      return { error: '`org` query param is required.', status: 400 }
+      return response.json({ message: 'The org query parameter is required.' }, 400)
     }
 
     const allowedOrgs = ci.orgs ?? []
     if (allowedOrgs.length > 0 && !allowedOrgs.includes(org)) {
-      return { error: 'Org not in `config.dashboard.ci.orgs`.', status: 403 }
+      return response.json({ message: 'This organization is not configured for CI tracking.' }, 403)
     }
 
-    const rawLimit = Number(url.searchParams.get('limit') ?? '60')
+    const rawLimit = Number(dashboardRequestValue(request, 'limit', '60'))
     const limit = Number.isFinite(rawLimit) && rawLimit > 0
       ? Math.min(Math.floor(rawLimit), 500)
       : 60
@@ -52,7 +53,7 @@ export default new Action({
     }
     catch (err) {
       console.error('[dashboard/ci] RunnerHistoryAction failed:', err)
-      return { org, samples: [], error: err instanceof Error ? err.message : 'unknown error' }
+      return response.json({ message: 'Runner history could not be loaded.' }, 503)
     }
   },
 })

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/Cloud/CloudIndexAction.ts

@@ -1,12 +1,19 @@
 import { Action } from '@stacksjs/actions'
 import { tsCloud } from '~/config/cloud'
+import { dashboardOperationalError } from '../dashboard-response'
 import { getDashboardCloudSnapshot } from './cloud-overview'
 
 export default new Action({
   name: 'CloudIndexAction',
   description: 'Returns configured cloud infrastructure and persisted deployment state.',
   method: 'GET',
+  apiResponse: true,
   async handle() {
-    return getDashboardCloudSnapshot(tsCloud)
+    try {
+      return await getDashboardCloudSnapshot(tsCloud)
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'Cloud infrastructure could not be loaded.', 'CloudIndexAction')
+    }
   },
 })

package/app/Actions/Dashboard/Cloud/ServerlessIndexAction.ts

@@ -1,20 +1,27 @@
 import { Action } from '@stacksjs/actions'
 import { tsCloud } from '~/config/cloud'
+import { dashboardOperationalError } from '../dashboard-response'
 import { getDashboardCloudSnapshot } from './cloud-overview'
 
 export default new Action({
   name: 'ServerlessIndexAction',
   description: 'Returns serverless services derived from environment application manifests.',
   method: 'GET',
+  apiResponse: true,
   async handle() {
-    const snapshot = await getDashboardCloudSnapshot(tsCloud)
-    return {
-      project: snapshot.project,
-      environments: snapshot.environments.filter(environment => environment.serverless),
-      services: snapshot.serverlessServices,
-      links: snapshot.serverlessLinks,
-      events: snapshot.events.filter(event => event.service.toLowerCase().includes('serverless')),
-      generatedAt: snapshot.generatedAt,
+    try {
+      const snapshot = await getDashboardCloudSnapshot(tsCloud)
+      return {
+        project: snapshot.project,
+        environments: snapshot.environments.filter(environment => environment.serverless),
+        services: snapshot.serverlessServices,
+        links: snapshot.serverlessLinks,
+        events: snapshot.events.filter(event => event.service.toLowerCase().includes('serverless')),
+        generatedAt: snapshot.generatedAt,
+      }
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'Serverless infrastructure could not be loaded.', 'ServerlessIndexAction')
     }
   },
 })

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

@@ -1,6 +1,6 @@
 import { Action } from '@stacksjs/actions'
 import { Category } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { normalizeCommerceCategoryRecord, summarizeCommerceCategories } from './commerce-category-records'
 
 export default new Action({
@@ -24,9 +24,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Category records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Category records could not be read.', 'CommerceCategoriesAction')
     }
   },
 })

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

@@ -1,6 +1,6 @@
 import { Action } from '@stacksjs/actions'
 import { Coupon, Product } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { normalizeCouponRecord, summarizeCoupons } from './coupon-records'
 import { commerceIdentifier, commerceValue } from './commerce-record'
 
@@ -26,9 +26,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Coupon records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Coupon records could not be read.', 'CommerceCouponsAction')
     }
   },
 })

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

@@ -1,7 +1,7 @@
 import { Action } from '@stacksjs/actions'
 import { config } from '@stacksjs/config'
 import { Customer } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import {
   normalizeCommerceCustomerCurrency,
   normalizeCommerceCustomerRecord,
@@ -25,9 +25,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Customer records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Customer records could not be read.', 'CommerceCustomersAction')
     }
   },
 })

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

@@ -1,7 +1,7 @@
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions'
 import { Customer, Order, OrderItem, Product } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import {
   buildCommerceDashboard,
   commerceDashboardQueryStart,
@@ -56,9 +56,7 @@ export default new Action({
       )
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Commerce overview records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Commerce overview records could not be read.', 'CommerceDashboardAction')
     }
   },
 })

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

@@ -1,7 +1,7 @@
 import { Action } from '@stacksjs/actions'
 import { config } from '@stacksjs/config'
 import { DeliveryRoute, Driver, ShippingMethod, ShippingZone } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { buildDeliveryOverview } from './commerce-delivery'
 
 export default new Action({
@@ -28,9 +28,7 @@ export default new Action({
       )
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Delivery records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Delivery records could not be read.', 'CommerceDeliveryAction')
     }
   },
 })

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

@@ -1,6 +1,6 @@
 import { Action } from '@stacksjs/actions'
 import { Customer, GiftCard } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { normalizeGiftCardRecord, summarizeGiftCards } from './gift-card-records'
 import { commerceIdentifier, commerceValue } from './commerce-record'
 
@@ -26,9 +26,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Gift card records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Gift card records could not be read.', 'CommerceGiftCardsAction')
     }
   },
 })

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

@@ -1,7 +1,7 @@
 import { Action } from '@stacksjs/actions'
 import { config } from '@stacksjs/config'
 import { Coupon, Customer, Order, OrderItem } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import {
   addOrderItemQuantity,
   normalizeCommerceOrderRecord,
@@ -54,9 +54,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Order records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Order records could not be read.', 'CommerceOrdersAction')
     }
   },
 })

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

@@ -1,6 +1,6 @@
 import { Action } from '@stacksjs/actions'
 import { Customer, Order, Payment } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import { commerceIdentifier, commerceValue } from './commerce-record'
 import { normalizePaymentRecord, summarizePayments } from './payment-records'
 
@@ -32,9 +32,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Payment records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Payment records could not be read.', 'CommercePaymentsAction')
     }
   },
 })

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

@@ -1,7 +1,7 @@
 import { Action } from '@stacksjs/actions'
 import { config } from '@stacksjs/config'
 import { Category, Customer, Manufacturer, Product, TaxRate } from '@stacksjs/orm'
-import { response } from '@stacksjs/router'
+import { dashboardOperationalError } from '../dashboard-response'
 import {
   isCommercePosCustomerActive,
   normalizeCommercePosCustomer,
@@ -63,9 +63,7 @@ export default new Action({
       }
     }
     catch (error) {
-      return response.json({
-        message: error instanceof Error ? error.message : 'Point of sale records could not be read.',
-      }, 503)
+      return dashboardOperationalError(error, 'Point of sale records could not be read.', 'CommercePosAction')
     }
   },
 })