@stacksjs/defaults 0.70.57 → 0.70.59

package/app/Actions/Dashboard/ServiceHealthAction.ts

@@ -0,0 +1,243 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'ServiceHealthAction',
+  description: 'Returns service health and configuration data for the services page.',
+  method: 'GET',
+  async handle() {
+    const { readFileSync, accessSync } = await import('node:fs')
+    const { join } = await import('node:path')
+    const projectRoot = process.cwd()
+
+    function readConfig(name: string): string {
+      try {
+        return readFileSync(join(projectRoot, 'config', name), 'utf-8')
+      }
+      catch { return '' }
+    }
+
+    function extractValue(content: string, pattern: RegExp): string {
+      const m = content.match(pattern)
+      return m ? m[1].trim().replace(/['"]/g, '') : ''
+    }
+
+    function fileExists(p: string): boolean {
+      try { accessSync(p); return true }
+      catch { return false }
+    }
+
+    // Infrastructure Services
+    const infra: Array<Record<string, unknown>> = []
+
+    // Database
+    const dbConf = readConfig('database.ts')
+    const dbDriver = extractValue(dbConf, /default:\s*['"](\w+)['"]/) || 'sqlite'
+    const dbFile = extractValue(dbConf, /filename:\s*['"]([^'"]+)['"]/) || 'database/stacks.sqlite'
+    const dbHost = extractValue(dbConf, /host:\s*['"]([^'"]+)['"]/) || 'localhost'
+    const dbPort = extractValue(dbConf, /port:\s*(\d+)/) || ''
+    infra.push({
+      name: 'Database',
+      configFile: 'database.ts',
+      category: 'data',
+      driver: dbDriver,
+      status: dbDriver === 'sqlite' && fileExists(join(projectRoot, dbFile)) ? 'running' : 'configured',
+      detail: dbDriver === 'sqlite' ? dbFile : `${dbHost}${dbPort ? `:${dbPort}` : ''}`,
+      fields: [{ key: 'default', label: 'Driver', value: dbDriver, options: 'sqlite,mysql,postgres,dynamodb' }],
+    })
+
+    // Cache
+    const cacheConf = readConfig('cache.ts')
+    const cacheDriver = extractValue(cacheConf, /driver:\s*['"](\w+)['"]/) || 'memory'
+    const redisHost = extractValue(cacheConf, /host:\s*['"]([^'"]+)['"]/) || '127.0.0.1'
+    const redisPort = extractValue(cacheConf, /port:\s*(\d+)/) || '6379'
+    infra.push({
+      name: 'Cache',
+      configFile: 'cache.ts',
+      category: 'data',
+      driver: cacheDriver,
+      status: cacheDriver === 'memory' ? 'running' : 'configured',
+      detail: cacheDriver === 'redis' ? `${redisHost}:${redisPort}` : 'In-Memory',
+      fields: [{ key: 'driver', label: 'Driver', value: cacheDriver, options: 'memory,redis' }],
+    })
+
+    // Queue
+    const queueConf = readConfig('queue.ts')
+    const queueDriver = extractValue(queueConf, /default:\s*['"](\w+)['"]/) || 'sync'
+    const queueDetail = queueDriver === 'redis' ? 'Redis (bun-queue)' : queueDriver === 'database' ? 'Database' : queueDriver === 'sqs' ? 'AWS SQS' : 'Sync (dev)'
+    infra.push({
+      name: 'Queue',
+      configFile: 'queue.ts',
+      category: 'data',
+      driver: queueDriver,
+      status: 'configured',
+      detail: queueDetail,
+      fields: [{ key: 'default', label: 'Driver', value: queueDriver, options: 'sync,database,redis,sqs,memory' }],
+    })
+
+    // Search
+    const searchConf = readConfig('search-engine.ts')
+    const searchDriver = extractValue(searchConf, /driver:\s*['"]([^'"]+)['"]/) || 'opensearch'
+    infra.push({
+      name: 'Search',
+      configFile: 'search-engine.ts',
+      category: 'data',
+      driver: searchDriver,
+      status: 'configured',
+      detail: searchDriver,
+      fields: [{ key: 'driver', label: 'Driver', value: searchDriver, options: 'opensearch,meilisearch,algolia,typesense' }],
+    })
+
+    // Storage
+    const storageConf = readConfig('filesystems.ts')
+    const storageDriver = extractValue(storageConf, /driver:\s*['"](\w+)['"]/) || 'bun'
+    const storageDetail = storageDriver === 's3' ? 'AWS S3' : storageDriver === 'bun' ? 'Bun Native' : 'Local FS'
+    infra.push({
+      name: 'Storage',
+      configFile: 'filesystems.ts',
+      category: 'data',
+      driver: storageDriver,
+      status: 'configured',
+      detail: storageDetail,
+      fields: [{ key: 'driver', label: 'Driver', value: storageDriver, options: 'bun,local,s3,memory' }],
+    })
+
+    // Email
+    const emailConf = readConfig('email.ts')
+    const emailMode = /mode:\s*['"]server['"]/.test(emailConf) ? 'server' : 'serverless'
+    const emailDomain = extractValue(emailConf, /domain:\s*['"]([^'"]+)['"]/) || ''
+    infra.push({
+      name: 'Email',
+      configFile: 'email.ts',
+      category: 'communication',
+      driver: emailMode === 'server' ? 'Zig Server' : 'Serverless',
+      status: emailDomain ? 'running' : 'configured',
+      detail: emailDomain || 'Not configured',
+      fields: [
+        { key: 'domain', label: 'Domain', value: emailDomain, options: '' },
+        { key: 'mode', label: 'Mode', value: emailMode, options: 'server,serverless' },
+      ],
+    })
+
+    // Realtime
+    const realtimeConf = readConfig('realtime.ts')
+    const rtPort = extractValue(realtimeConf, /port:\s*(\d+)/) || '6001'
+    const rtDriver = extractValue(realtimeConf, /driver:\s*['"](\w+)['"]/) || 'socket'
+    infra.push({
+      name: 'Realtime',
+      configFile: 'realtime.ts',
+      category: 'communication',
+      driver: 'WebSocket',
+      status: 'configured',
+      detail: `Port ${rtPort}`,
+      fields: [
+        { key: 'port', label: 'Port', value: rtPort, options: '' },
+        { key: 'driver', label: 'Driver', value: rtDriver, options: 'socket,pusher,bun,reverb,ably' },
+      ],
+    })
+
+    // AI
+    const aiConf = readConfig('ai.ts')
+    const aiModel = extractValue(aiConf, /default:\s*['"]([^'"]+)['"]/) || ''
+    infra.push({
+      name: 'AI',
+      configFile: 'ai.ts',
+      category: 'compute',
+      driver: 'Bedrock',
+      status: aiModel ? 'configured' : 'not set',
+      detail: aiModel || 'Not configured',
+      fields: [{ key: 'default', label: 'Model', value: aiModel, options: '' }],
+    })
+
+    // System Dependencies
+    const systemDeps: Array<{ name: string, version: string }> = []
+    const depsConf = readConfig('deps.ts')
+    const depPattern = /['"]([^'"]+)['"]\s*:\s*['"]([^'"]+)['"]/g
+    let depMatch
+    // eslint-disable-next-line no-cond-assign
+    while ((depMatch = depPattern.exec(depsConf)) !== null) {
+      const depName = depMatch[1]
+      const depVer = depMatch[2]
+      if (depName.includes('.') || depName === 'redis' || depName === 'mailpit') {
+        systemDeps.push({ name: depName, version: depVer })
+      }
+    }
+
+    // Third-Party API Services
+    const apiServices: Array<Record<string, unknown>> = []
+    const svcConf = readConfig('services.ts')
+    const keyPattern = /^ {2}(\w[\w]*)\s*:\s*\{/gm
+    let svcMatch
+    // eslint-disable-next-line no-cond-assign
+    while ((svcMatch = keyPattern.exec(svcConf)) !== null) {
+      const svcName = svcMatch[1]
+      const blockStart = svcMatch.index
+      let braceCount = 0
+      let blockEnd = blockStart
+      let inBlock = false
+      for (let i = blockStart; i < svcConf.length; i++) {
+        if (svcConf[i] === '{') { braceCount++; inBlock = true }
+        if (svcConf[i] === '}') { braceCount-- }
+        if (inBlock && braceCount === 0) { blockEnd = i; break }
+      }
+      const block = svcConf.substring(blockStart, blockEnd + 1)
+
+      const svcFields: Array<Record<string, string>> = []
+      const fieldPattern = /(\w+)\s*:\s*(?:env\.(\w+)\s*\?\?\s*)?['"]?([^'",\n}]*)['"]?/g
+      let fm
+      // eslint-disable-next-line no-cond-assign
+      while ((fm = fieldPattern.exec(block)) !== null) {
+        const fName = fm[1]
+        if (['maxRetries', 'retryTimeout'].includes(fName)) continue
+        const fValue = fm[3] ? fm[3].trim().replace(/['"]/g, '') : ''
+        const envVar = fm[2] || ''
+        svcFields.push({ key: fName, label: fName, value: fValue, env: envVar })
+      }
+
+      const hasEnvRef = /env\./.test(block)
+      let category = 'other'
+      if (['algolia', 'meilisearch'].includes(svcName)) category = 'search'
+      else if (['aws', 'digitalOcean', 'hetzner'].includes(svcName)) category = 'cloud'
+      else if (['github', 'google', 'facebook', 'twitter'].includes(svcName)) category = 'auth'
+      else if (['mailgun', 'mailtrap', 'sendgrid', 'ses', 'smtp'].includes(svcName)) category = 'email'
+      else if (['slack', 'discord', 'teams'].includes(svcName)) category = 'messaging'
+      else if (['expo', 'fcm'].includes(svcName)) category = 'push'
+      else if (['openai', 'anthropic', 'ollama'].includes(svcName)) category = 'ai'
+      else if (['stripe'].includes(svcName)) category = 'payment'
+
+      apiServices.push({ name: svcName, category, configured: hasEnvRef, fields: svcFields })
+    }
+
+    const categoryLabels: Record<string, string> = {
+      auth: 'Authentication',
+      cloud: 'Cloud',
+      email: 'Email',
+      messaging: 'Messaging',
+      push: 'Push Notifications',
+      ai: 'AI',
+      payment: 'Payments',
+      search: 'Search',
+      other: 'Other',
+    }
+    const categoryOrder = ['auth', 'cloud', 'email', 'messaging', 'push', 'ai', 'payment', 'search', 'other']
+    const apiCategories: Record<string, Array<Record<string, unknown>>> = {}
+    for (const s of apiServices) {
+      const cat = s.category as string
+      if (!apiCategories[cat]) apiCategories[cat] = []
+      apiCategories[cat].push(s)
+    }
+    const orderedApiGroups = categoryOrder
+      .filter(cat => apiCategories[cat] && apiCategories[cat].length > 0)
+      .map(cat => ({ key: cat, label: categoryLabels[cat] || cat, items: apiCategories[cat] }))
+
+    const configuredApi = apiServices.filter(s => s.configured).length
+
+    const stats = [
+      { label: 'Infrastructure', value: String(infra.length) },
+      { label: 'API Services', value: String(apiServices.length) },
+      { label: 'System Deps', value: String(systemDeps.length) },
+      { label: 'Configured', value: `${configuredApi}/${apiServices.length}` },
+    ]
+
+    return { infra, systemDeps, orderedApiGroups, stats }
+  },
+})

package/app/Actions/Dashboard/Settings/MailSettingsGetAction.ts

@@ -0,0 +1,20 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'MailSettingsGetAction',
+  description: 'Returns the current mail settings.',
+  method: 'GET',
+  async handle() {
+    return {
+      data: {
+        from: '',
+        to: '',
+        driver: 'SMTP',
+        host: '',
+        port: 587,
+        username: '',
+        password: '',
+      },
+    }
+  },
+})

package/app/Actions/Dashboard/Settings/MailSettingsUpdateAction.ts

@@ -0,0 +1,10 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'MailSettingsUpdateAction',
+  description: 'Updates the mail settings.',
+  method: 'PUT',
+  async handle() {
+    return { success: true, message: 'Mail settings updated' }
+  },
+})

package/app/Actions/Dashboard/Settings/SettingsIndexAction.ts

@@ -0,0 +1,40 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'SettingsIndexAction',
+  description: 'Returns application settings for the dashboard settings page.',
+  method: 'GET',
+  async handle() {
+    const generalSettings = [
+      { key: 'Site Name', value: 'Stacks', type: 'text' },
+      { key: 'Site URL', value: 'https://stacks.dev', type: 'text' },
+      { key: 'Admin Email', value: 'admin@stacks.dev', type: 'email' },
+      { key: 'Timezone', value: 'America/New_York', type: 'select' },
+      { key: 'Language', value: 'English', type: 'select' },
+    ]
+
+    const securitySettings = [
+      { key: 'Two-Factor Authentication', value: true, type: 'toggle' },
+      { key: 'Session Timeout', value: '30 minutes', type: 'select' },
+      { key: 'Password Requirements', value: 'Strong', type: 'select' },
+      { key: 'IP Whitelist', value: 'Disabled', type: 'toggle' },
+    ]
+
+    const notificationSettings = [
+      { key: 'Email Notifications', value: true, type: 'toggle' },
+      { key: 'Push Notifications', value: true, type: 'toggle' },
+      { key: 'Weekly Digest', value: false, type: 'toggle' },
+      { key: 'Error Alerts', value: true, type: 'toggle' },
+    ]
+
+    const integrations = [
+      { name: 'Stripe', status: 'connected', icon: 'creditcard' },
+      { name: 'SendGrid', status: 'connected', icon: 'envelope' },
+      { name: 'Cloudflare', status: 'connected', icon: 'cloud' },
+      { name: 'GitHub', status: 'connected', icon: 'chevron.left.forwardslash.chevron.right' },
+      { name: 'Slack', status: 'not_connected', icon: 'bubble.left.and.bubble.right' },
+    ]
+
+    return { generalSettings, securitySettings, notificationSettings, integrations }
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateAiConfig.ts

@@ -0,0 +1,27 @@
+import { Action } from '@stacksjs/actions'
+import { schema } from '@stacksjs/validation'
+
+export default new Action({
+  name: 'UpdateAiConfig',
+  description: 'Updates the AI config.',
+  path: '/dashboard/settings/ai',
+  method: 'POST',
+
+  validations: {
+    default: {
+      rule: schema.enum(['meta.llama2-70b-chat-v1', 'meta.llama2-70b-chat-v2']),
+      message:
+        '`default` must refer to a valid AI model. Choose from `meta.llama2-70b-chat-v1` or `meta.llama2-70b-chat-v2`.',
+    },
+
+    models: {
+      rule: schema.enum(['meta.llama2-70b-chat-v1', 'meta.llama2-70b-chat-v2']),
+      message:
+        '`models` must refer to a valid AI model. Choose from `meta.llama2-70b-chat-v1` or `meta.llama2-70b-chat-v2`.',
+    },
+  },
+
+  async handle() {
+    // generate the file update here/write to disk
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateAnalyticsConfig.ts

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+import { Action } from '@stacksjs/actions'
+import { projectPath } from '@stacksjs/path'
+
+export default new Action({
+  name: 'UpdateAnalyticsConfig',
+  description: 'Updates the analytics configuration.',
+  method: 'POST',
+  apiResponse: true,
+
+  async handle(request) {
+    try {
+      const updates = request.all()
+      const filePath = projectPath('config/analytics.ts')
+      let content = readFileSync(filePath, 'utf-8')
+
+      for (const [key, value] of Object.entries(updates)) {
+        const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        const pattern = new RegExp(
+          `(${escapedKey}\\s*:\\s*)(?:'[^']*'|"[^"]*"|\\d+(?:\\.\\d+)?|true|false)`,
+        )
+
+        if (pattern.test(content)) {
+          const isNum = /^\d+(?:\.\d+)?$/.test(String(value))
+          const isBool = value === true || value === false || value === 'true' || value === 'false'
+          const replacement = isNum || isBool ? String(value) : `'${String(value).replace(/'/g, "\\'")}'`
+          content = content.replace(pattern, `$1${replacement}`)
+        }
+      }
+
+      writeFileSync(filePath, content, 'utf-8')
+      return { success: true, message: 'Analytics configuration updated.' }
+    }
+    catch (e: any) {
+      return { success: false, error: e.message }
+    }
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateAppConfig.ts

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+import { Action } from '@stacksjs/actions'
+import { projectPath } from '@stacksjs/path'
+
+export default new Action({
+  name: 'UpdateAppConfig',
+  description: 'Updates the app configuration.',
+  method: 'POST',
+  apiResponse: true,
+
+  async handle(request) {
+    try {
+      const updates = request.all()
+      const filePath = projectPath('config/app.ts')
+      let content = readFileSync(filePath, 'utf-8')
+
+      for (const [key, value] of Object.entries(updates)) {
+        const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        const pattern = new RegExp(
+          `(${escapedKey}\\s*:\\s*)(?:'[^']*'|"[^"]*"|\\d+(?:\\.\\d+)?|true|false)`,
+        )
+
+        if (pattern.test(content)) {
+          const isNum = /^\d+(?:\.\d+)?$/.test(String(value))
+          const isBool = value === true || value === false || value === 'true' || value === 'false'
+          const replacement = isNum || isBool ? String(value) : `'${String(value).replace(/'/g, "\\'")}'`
+          content = content.replace(pattern, `$1${replacement}`)
+        }
+      }
+
+      writeFileSync(filePath, content, 'utf-8')
+      return { success: true, message: 'App configuration updated.' }
+    }
+    catch (e: any) {
+      return { success: false, error: e.message }
+    }
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateCacheConfig.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'UpdateCacheConfig',
+  description: 'Updates the cache config.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateCliConfig.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'UpdateCliConfig',
+  description: 'Updates the CLI config.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateCloudConfig.ts

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+import { Action } from '@stacksjs/actions'
+import { projectPath } from '@stacksjs/path'
+
+export default new Action({
+  name: 'UpdateCloudConfig',
+  description: 'Updates the cloud configuration.',
+  method: 'POST',
+  apiResponse: true,
+
+  async handle(request) {
+    try {
+      const updates = request.all()
+      const filePath = projectPath('config/cloud.ts')
+      let content = readFileSync(filePath, 'utf-8')
+
+      for (const [key, value] of Object.entries(updates)) {
+        const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        const pattern = new RegExp(
+          `(${escapedKey}\\s*:\\s*)(?:'[^']*'|"[^"]*"|\\d+(?:\\.\\d+)?|true|false)`,
+        )
+
+        if (pattern.test(content)) {
+          const isNum = /^\d+(?:\.\d+)?$/.test(String(value))
+          const isBool = value === true || value === false || value === 'true' || value === 'false'
+          const replacement = isNum || isBool ? String(value) : `'${String(value).replace(/'/g, "\\'")}'`
+          content = content.replace(pattern, `$1${replacement}`)
+        }
+      }
+
+      writeFileSync(filePath, content, 'utf-8')
+      return { success: true, message: 'Cloud configuration updated.' }
+    }
+    catch (e: any) {
+      return { success: false, error: e.message }
+    }
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateDatabaseConfig.ts

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+import { Action } from '@stacksjs/actions'
+import { projectPath } from '@stacksjs/path'
+
+export default new Action({
+  name: 'UpdateDatabaseConfig',
+  description: 'Updates the database configuration.',
+  method: 'POST',
+  apiResponse: true,
+
+  async handle(request) {
+    try {
+      const updates = request.all()
+      const filePath = projectPath('config/database.ts')
+      let content = readFileSync(filePath, 'utf-8')
+
+      for (const [key, value] of Object.entries(updates)) {
+        const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        const pattern = new RegExp(
+          `(${escapedKey}\\s*:\\s*)(?:'[^']*'|"[^"]*"|\\d+(?:\\.\\d+)?|true|false)`,
+        )
+
+        if (pattern.test(content)) {
+          const isNum = /^\d+(?:\.\d+)?$/.test(String(value))
+          const isBool = value === true || value === false || value === 'true' || value === 'false'
+          const replacement = isNum || isBool ? String(value) : `'${String(value).replace(/'/g, "\\'")}'`
+          content = content.replace(pattern, `$1${replacement}`)
+        }
+      }
+
+      writeFileSync(filePath, content, 'utf-8')
+      return { success: true, message: 'Database configuration updated.' }
+    }
+    catch (e: any) {
+      return { success: false, error: e.message }
+    }
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateDnsConfig.ts

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+import { Action } from '@stacksjs/actions'
+import { projectPath } from '@stacksjs/path'
+
+export default new Action({
+  name: 'UpdateDnsConfig',
+  description: 'Updates the DNS configuration.',
+  method: 'POST',
+  apiResponse: true,
+
+  async handle(request) {
+    try {
+      const updates = request.all()
+      const filePath = projectPath('config/dns.ts')
+      let content = readFileSync(filePath, 'utf-8')
+
+      for (const [key, value] of Object.entries(updates)) {
+        const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        const pattern = new RegExp(
+          `(${escapedKey}\\s*:\\s*)(?:'[^']*'|"[^"]*"|\\d+(?:\\.\\d+)?|true|false)`,
+        )
+
+        if (pattern.test(content)) {
+          const isNum = /^\d+(?:\.\d+)?$/.test(String(value))
+          const isBool = value === true || value === false || value === 'true' || value === 'false'
+          const replacement = isNum || isBool ? String(value) : `'${String(value).replace(/'/g, "\\'")}'`
+          content = content.replace(pattern, `$1${replacement}`)
+        }
+      }
+
+      writeFileSync(filePath, content, 'utf-8')
+      return { success: true, message: 'DNS configuration updated.' }
+    }
+    catch (e: any) {
+      return { success: false, error: e.message }
+    }
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateDocsConfig.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'UpdateDocsConfig',
+  description: 'Updates the docs config.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateEmailConfig.ts

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+import { Action } from '@stacksjs/actions'
+import { projectPath } from '@stacksjs/path'
+
+export default new Action({
+  name: 'UpdateEmailConfig',
+  description: 'Updates the email configuration.',
+  method: 'POST',
+  apiResponse: true,
+
+  async handle(request) {
+    try {
+      const updates = request.all()
+      const filePath = projectPath('config/email.ts')
+      let content = readFileSync(filePath, 'utf-8')
+
+      for (const [key, value] of Object.entries(updates)) {
+        const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        const pattern = new RegExp(
+          `(${escapedKey}\\s*:\\s*)(?:'[^']*'|"[^"]*"|\\d+(?:\\.\\d+)?|true|false)`,
+        )
+
+        if (pattern.test(content)) {
+          const isNum = /^\d+(?:\.\d+)?$/.test(String(value))
+          const isBool = value === true || value === false || value === 'true' || value === 'false'
+          const replacement = isNum || isBool ? String(value) : `'${String(value).replace(/'/g, "\\'")}'`
+          content = content.replace(pattern, `$1${replacement}`)
+        }
+      }
+
+      writeFileSync(filePath, content, 'utf-8')
+      return { success: true, message: 'Email configuration updated.' }
+    }
+    catch (e: any) {
+      return { success: false, error: e.message }
+    }
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateEnvConfig.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'UpdateEnvConfig',
+  description: 'Updates the env config.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateErrorsConfig.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'UpdateErrorsConfig',
+  description: 'Updates the errors config.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateFileSystemsConfig.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'UpdateFileSystemsConfig',
+  description: 'Updates the file systems config.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})

package/app/Actions/Dashboard/Settings/UpdateGitConfig.ts

@@ -0,0 +1,11 @@
+import { Action } from '@stacksjs/actions'
+
+export default new Action({
+  name: 'UpdateGitConfig',
+  description: 'Updates the git config.',
+  apiResponse: true,
+
+  async handle() {
+    //
+  },
+})