@stacksjs/defaults 0.70.58 → 0.70.59

package/app/Actions/Commerce/TaxRateUpdateAction.ts

@@ -0,0 +1,24 @@
+import { Action } from '@stacksjs/actions'
+import { tax } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'TaxRate Update',
+  description: 'TaxRate Update ORM Action',
+  method: 'PATCH',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    const data = {
+      name: request.get('name'),
+      rate: request.get<number>('rate'),
+      type: request.get('type'),
+      country: request.get('country'),
+      region: request.get('region'),
+    }
+
+    const model = await tax.update(id, data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Commerce/WaitlistProductAnalyticsAction.ts

@@ -0,0 +1,29 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Analytics',
+  description: 'WaitlistProduct Analytics Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const startDate = request.getParam<Date>('startDate')
+    const endDate = request.getParam<Date>('endDate')
+
+    const [
+      countBySource,
+      countByAllQuantities,
+      conversionRates,
+    ] = await Promise.all([
+      waitlists.products.fetchCountBySource(startDate, endDate),
+      waitlists.products.fetchCountByAllQuantities(startDate, endDate),
+      waitlists.products.fetchConversionRates(startDate, endDate),
+    ])
+
+    return response.json({
+      countBySource,
+      countByAllQuantities,
+      conversionRates,
+    })
+  },
+})

package/app/Actions/Commerce/WaitlistProductDestroyAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Destroy',
+  description: 'WaitlistProduct Destroy ORM Action',
+  method: 'DELETE',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    await waitlists.products.destroy(id)
+
+    return response.json({ message: 'WaitlistProduct deleted successfully' })
+  },
+})

package/app/Actions/Commerce/WaitlistProductIndexAction.ts

@@ -0,0 +1,14 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Index',
+  description: 'WaitlistProduct Index ORM Action',
+  method: 'GET',
+  async handle() {
+    const results = await waitlists.products.fetchAll()
+
+    return response.json(results)
+  },
+})

package/app/Actions/Commerce/WaitlistProductQuantityDistributionAction.ts

@@ -0,0 +1,32 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Quantity Distribution',
+  description: 'WaitlistProduct Quantity Distribution Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const startDate = request.getParam<Date>('startDate')
+    const endDate = request.getParam<Date>('endDate')
+
+    const quantityDistribution = await waitlists.products.fetchCountByAllQuantities(startDate, endDate)
+
+    // Transform the data into a format suitable for the graph
+    const data = Object.entries(quantityDistribution).map(([quantity, count]) => ({
+      quantity: Number(quantity),
+      count,
+    }))
+
+    // Sort by quantity for consistent x-axis ordering
+    data.sort((a, b) => a.quantity - b.quantity)
+
+    return response.json({
+      data,
+      // Add some metadata that might be useful for the graph
+      totalOrders: Object.values(quantityDistribution).reduce((sum, count) => sum + count, 0),
+      minQuantity: Math.min(...data.map(d => d.quantity)),
+      maxQuantity: Math.max(...data.map(d => d.quantity)),
+    })
+  },
+})

package/app/Actions/Commerce/WaitlistProductShowAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Show',
+  description: 'WaitlistProduct Show ORM Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    const model = await waitlists.products.fetchById(id)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Commerce/WaitlistProductStatusAction.ts

@@ -0,0 +1,37 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Status Statistics',
+  description: 'WaitlistProduct Status Statistics Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const startDate = request.getParam<Date>('startDate')
+    const endDate = request.getParam<Date>('endDate')
+
+    const [
+      totalCount,
+      waitingCount,
+      notifiedCount,
+      purchasedCount,
+      conversionRates,
+    ] = await Promise.all([
+      waitlists.products.fetchCountBetweenDates(startDate, endDate),
+      waitlists.products.fetchCountByStatus('waiting', startDate, endDate),
+      waitlists.products.fetchCountByStatus('notified', startDate, endDate),
+      waitlists.products.fetchCountByStatus('purchased', startDate, endDate),
+      waitlists.products.fetchConversionRates(startDate, endDate),
+    ])
+
+    return response.json({
+      totalCount,
+      statusCounts: {
+        waiting: waitingCount,
+        notified: notifiedCount,
+        purchased: purchasedCount,
+      },
+      conversionRates,
+    })
+  },
+})

package/app/Actions/Commerce/WaitlistProductStoreAction.ts

@@ -0,0 +1,27 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Store',
+  description: 'WaitlistProduct Store ORM Action',
+  method: 'POST',
+  async handle(request: RequestInstance) {
+    await request.validate()
+
+    const data = {
+      product_id: request.get<number>('product_id'),
+      customer_id: request.get<number>('customer_id'),
+      name: request.get('name'),
+      email: request.get('email'),
+      quantity: request.get<number>('quantity'),
+      notification_preference: request.get('notification_preference'),
+      source: request.get('source'),
+      status: request.get('status'),
+    }
+
+    const model = await waitlists.products.store(data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Commerce/WaitlistProductTimeSeriesAction.ts

@@ -0,0 +1,25 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Time Series',
+  description: 'WaitlistProduct Time Series Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const startDate = request.getParam<Date>('startDate')
+    const endDate = request.getParam<Date>('endDate')
+
+    const timeSeriesData = await waitlists.products.fetchCountByDateGrouped(startDate, endDate)
+
+    return response.json({
+      data: timeSeriesData,
+      // Add some metadata that might be useful for the graph
+      totalDays: timeSeriesData.length,
+      totalWaitlists: timeSeriesData.reduce((sum, { count }) => sum + count, 0),
+      averageWaitlistsPerDay: timeSeriesData.length > 0
+        ? timeSeriesData.reduce((sum, { count }) => sum + count, 0) / timeSeriesData.length
+        : 0,
+    })
+  },
+})

package/app/Actions/Commerce/WaitlistProductUpdateAction.ts

@@ -0,0 +1,29 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistProduct Update',
+  description: 'WaitlistProduct Update ORM Action',
+  method: 'PATCH',
+  async handle(request: RequestInstance) {
+    await request.validate()
+
+    const id = request.getParam('id')
+
+    const data = {
+      product_id: request.get<number>('product_id'),
+      customer_id: request.get<number>('customer_id'),
+      name: request.get('name'),
+      email: request.get('email'),
+      quantity: request.get<number>('quantity'),
+      notification_preference: request.get('notification_preference'),
+      source: request.get('source'),
+      status: request.get('status'),
+    }
+
+    const model = await waitlists.products.update(id, data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Commerce/WaitlistRestaurantDashboardAction.ts

@@ -0,0 +1,29 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistRestaurant Dashboard',
+  description: 'Get restaurant dashboard statistics',
+  method: 'GET',
+  async handle() {
+    const [
+      waitTimeStats,
+      seatedStats,
+      noShowStats,
+      timeSeriesStats,
+    ] = await Promise.all([
+      waitlists.restaurant.fetchCurrentWaitTimes(),
+      waitlists.restaurant.fetchSeatedStats(),
+      waitlists.restaurant.fetchNoShowStats(new Date(Date.now() - 24 * 60 * 60 * 1000), new Date()),
+      waitlists.restaurant.fetchTimeSeriesStats(),
+    ])
+
+    return response.json({
+      waitTimeStats,
+      seatedStats,
+      noShowStats,
+      timeSeriesStats,
+    })
+  },
+})

package/app/Actions/Commerce/WaitlistRestaurantDestroyAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistRestaurant Destroy',
+  description: 'WaitlistRestaurant Destroy ORM Action',
+  method: 'DELETE',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    await waitlists.restaurant.destroy(id)
+
+    return response.json({ message: 'WaitlistRestaurant deleted successfully' })
+  },
+})

package/app/Actions/Commerce/WaitlistRestaurantIndexAction.ts

@@ -0,0 +1,14 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistRestaurant Index',
+  description: 'WaitlistRestaurant Index ORM Action',
+  method: 'GET',
+  async handle() {
+    const results = await waitlists.restaurant.fetchAll()
+
+    return response.json(results)
+  },
+})

package/app/Actions/Commerce/WaitlistRestaurantShowAction.ts

@@ -0,0 +1,16 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistRestaurant Show',
+  description: 'WaitlistRestaurant Show ORM Action',
+  method: 'GET',
+  async handle(request: RequestInstance) {
+    const id = request.getParam('id')
+
+    const model = await waitlists.restaurant.fetchById(id)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Commerce/WaitlistRestaurantStoreAction.ts

@@ -0,0 +1,31 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistRestaurant Store',
+  description: 'WaitlistRestaurant Store ORM Action',
+  method: 'POST',
+  async handle(request: RequestInstance) {
+    await request.validate()
+
+    const data = {
+      restaurant_id: request.get<number>('restaurant_id'),
+      customer_id: request.get<number>('customer_id'),
+      name: request.get('name'),
+      email: request.get('email'),
+      quantity: request.get<number>('quantity'),
+      notification_preference: request.get('notification_preference'),
+      source: request.get('source'),
+      status: request.get('status'),
+      party_size: request.get<number>('party_size'),
+      check_in_time: request.get<number>('check_in_time'),
+      table_preference: request.get('table_preference'),
+      quoted_wait_time: request.get<number>('quoted_wait_time'),
+    }
+
+    const model = await waitlists.restaurant.store(data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/Commerce/WaitlistRestaurantUpdateAction.ts

@@ -0,0 +1,33 @@
+import { Action } from '@stacksjs/actions'
+import { waitlists } from '@stacksjs/commerce'
+import { response } from '@stacksjs/router'
+
+export default new Action({
+  name: 'WaitlistRestaurant Update',
+  description: 'WaitlistRestaurant Update ORM Action',
+  method: 'PATCH',
+  async handle(request: RequestInstance) {
+    await request.validate()
+
+    const id = request.getParam('id')
+
+    const data = {
+      restaurant_id: request.get<number>('restaurant_id'),
+      customer_id: request.get<number>('customer_id'),
+      name: request.get('name'),
+      email: request.get('email'),
+      quantity: request.get<number>('quantity'),
+      notification_preference: request.get('notification_preference'),
+      source: request.get('source'),
+      status: request.get('status'),
+      party_size: request.get<number>('party_size'),
+      check_in_time: request.get<number>('check_in_time'),
+      table_preference: request.get('table_preference'),
+      quoted_wait_time: request.get<number>('quoted_wait_time'),
+    }
+
+    const model = await waitlists.restaurant.update(id, data)
+
+    return response.json(model)
+  },
+})

package/app/Actions/ContactAction.ts

@@ -0,0 +1,72 @@
+import { Action } from '@stacksjs/actions'
+import { config } from '@stacksjs/config'
+import { mail } from '@stacksjs/email'
+import { rateLimit } from '@stacksjs/router'
+
+/**
+ * Default `/api/contact` handler.
+ *
+ * Receives a name + email + message from the public contact form and
+ * forwards it to the team inbox. Rate-limited and CSRF-skipped (the
+ * form is rendered as static HTML without a token round-trip), with
+ * a stricter quota than `/api/email/subscribe` because each call hits
+ * the outbound mailer directly.
+ *
+ * Apps that want a richer flow (ticketing, autoresponders, Slack
+ * notifications) should override this in `app/Actions/ContactAction.ts`
+ * via `./buddy publish:action ContactAction`.
+ */
+export default new Action({
+  name: 'ContactAction',
+  description: 'Forward public contact-form submissions to the team inbox',
+  method: 'POST',
+
+  async handle(request: RequestInstance) {
+    // Stricter than subscribe: every accepted call sends an outbound
+    // email, so abuse here directly maps to mailer cost. Five per
+    // minute per IP gives a real human room to retry while a scripted
+    // flood tops out fast.
+    await rateLimit('contact-form', 5).per('minute')
+
+    const name = String(request.get('name') || '').trim()
+    const email = String(request.get('email') || '').trim()
+    const message = String(request.get('message') || '').trim()
+
+    if (!email.includes('@'))
+      return { success: false, message: 'A valid email is required' }
+    if (!message)
+      return { success: false, message: 'A message is required' }
+
+    const appName = config.app.name || 'Stacks'
+    const fromAddress = config.email.from?.address || 'hello@stacksjs.com'
+    // The team inbox: prefer a configured `support` address, fall
+    // back to the same `from` address (safe — real apps will set both).
+    const toAddress = (config.email as any)?.support?.address || fromAddress
+
+    // Plain-text body so it lands cleanly in any inbox client. Reply-To
+    // is the visitor's address so a reply goes straight back to them
+    // without a copy-paste step.
+    const text = [
+      `From: ${name || '(no name)'} <${email}>`,
+      '',
+      message,
+    ].join('\n')
+
+    try {
+      await mail.send({
+        to: [toAddress],
+        from: { name: appName, address: fromAddress },
+        replyTo: email,
+        subject: `[contact] ${name || email}`,
+        text,
+      })
+    }
+    catch (err) {
+      const errMessage = err instanceof Error ? err.message : String(err)
+      console.error('[ContactAction] mail.send failed:', errMessage)
+      return { success: false, message: 'We could not send your message. Try again in a moment.' }
+    }
+
+    return { success: true }
+  },
+})

package/app/Actions/Dashboard/Actions/CreateAction.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'CreateAction',
+  description: 'Creates a new action.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})

package/app/Actions/Dashboard/Actions/GetActionCount.ts

@@ -0,0 +1,12 @@
+import { Action } from '@stacksjs/actions'
+// import { Action as ActionModel } from '@stacksjs/orm'
+
+export default new Action({
+  name: 'GetActionCount',
+  description: 'Gets the total number of actions.',
+  apiResponse: true,
+
+  async handle() {
+    // return ActionModel.count()
+  },
+})

package/app/Actions/Dashboard/Actions/GetActions.ts

@@ -0,0 +1,19 @@
+import { Action } from '@stacksjs/actions'
+// import { Action as ActionModel } from '@stacksjs/orm'
+
+export default new Action({
+  name: 'GetActions',
+  description: 'Gets your actions.',
+  method: 'GET',
+  async handle() {
+    // TODO: replace with ActionModel.all() when ORM is ready
+    return {
+      actions: [
+        { name: 'SendWelcomeEmail', type: 'email', runs: 1247, avgTime: '234ms', status: 'active' },
+        { name: 'ProcessPayment', type: 'payment', runs: 892, avgTime: '1.2s', status: 'active' },
+        { name: 'GenerateReport', type: 'report', runs: 156, avgTime: '4.5s', status: 'active' },
+        { name: 'SyncInventory', type: 'sync', runs: 48, avgTime: '12s', status: 'paused' },
+      ],
+    }
+  },
+})

package/app/Actions/Dashboard/Analytics/BlogAnalyticsAction.ts

@@ -0,0 +1,58 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'BlogAnalyticsAction',
+  description: 'Returns blog analytics data from ts-analytics filtered for blog paths.',
+  method: 'GET',
+  async handle() {
+    try {
+      const { AnalyticsQueryAPI, AnalyticsStore } = await import('ts-analytics')
+      const store = new AnalyticsStore({ tableName: 'analytics' })
+
+      const now = new Date()
+      const thirtyDaysAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000)
+      const dateRange = { start: thirtyDaysAgo, end: now }
+      const period = AnalyticsQueryAPI.determinePeriod(dateRange)
+      const periodStart = AnalyticsStore.getPeriodStart(now, period)
+
+      const topPagesCmd = store.getTopPagesCommand('default', period, periodStart, 50)
+      const topPagesResult = (topPagesCmd as unknown as { Items?: unknown[] })?.Items ?? []
+
+      const allPages = AnalyticsQueryAPI.processTopPages(
+        topPagesResult as Parameters<typeof AnalyticsQueryAPI.processTopPages>[0],
+        1,
+      )
+
+      // Filter for blog paths
+      const blogPages = allPages.filter(p => p.name.startsWith('/blog'))
+
+      const totalViews = blogPages.reduce((sum, p) => sum + p.value, 0)
+      const avgTimeOnPage = 0
+
+      const stats = [
+        { label: 'Total Views', value: totalViews.toLocaleString(), change: '' },
+        { label: 'Avg Read Time', value: avgTimeOnPage > 0 ? `${Math.floor(avgTimeOnPage / 60000)}m ${Math.floor((avgTimeOnPage % 60000) / 1000)}s` : '-', change: '' },
+        { label: 'Blog Posts Tracked', value: String(blogPages.length), change: '' },
+        { label: 'Top Post Views', value: blogPages.length > 0 ? blogPages[0].value.toLocaleString() : '0', change: '' },
+      ]
+
+      const topPosts = blogPages.slice(0, 10).map(p => ({
+        title: p.name,
+        views: p.value.toLocaleString(),
+        comments: 0,
+        shares: 0,
+        published: '',
+      }))
+
+      return {
+        stats,
+        topPosts,
+        categories: [],
+        authors: [],
+      }
+    }
+    catch {
+      return { stats: [], topPosts: [], categories: [], authors: [] }
+    }
+  },
+})

package/app/Actions/Dashboard/Analytics/BrowserAnalyticsAction.ts

@@ -0,0 +1,42 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'BrowserAnalyticsAction',
+  description: 'Returns browser analytics data from ts-analytics device stats.',
+  method: 'GET',
+  async handle() {
+    try {
+      const { AnalyticsQueryAPI, AnalyticsStore } = await import('ts-analytics')
+      const store = new AnalyticsStore({ tableName: 'analytics' })
+
+      const now = new Date()
+      const thirtyDaysAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000)
+      const dateRange = { start: thirtyDaysAgo, end: now }
+      const period = AnalyticsQueryAPI.determinePeriod(dateRange)
+      const periodStart = AnalyticsStore.getPeriodStart(now, period)
+
+      const deviceStatsCmd = store.getDeviceStatsCommand('default', period, periodStart, 'browser')
+      const deviceResult = (deviceStatsCmd as unknown as { Items?: unknown[] })?.Items ?? []
+
+      const totalVisitors = (deviceResult as any[]).reduce((sum: number, d: any) => sum + (d.visitors || 0), 0)
+
+      const browsers = AnalyticsQueryAPI.processTopDevices(
+        deviceResult as Parameters<typeof AnalyticsQueryAPI.processTopDevices>[0],
+        'browser',
+        totalVisitors,
+      )
+
+      return {
+        browsers: browsers.map(b => ({
+          name: b.name,
+          sessions: b.value,
+          percentage: Math.round(b.percentage * 10) / 10,
+          version: '',
+        })),
+      }
+    }
+    catch {
+      return { browsers: [] }
+    }
+  },
+})