fix: capture native HTTP metadata and bootstrap search projections

Author: chrisbbreuer

config/server.ts

@@ -10,6 +10,8 @@ import type { ServerConfig } from '@stacksjs/types'
  * Discord or GitHub Discussions.
  */
 export default {
+  // Opt in after publishing the native Request model and migrating its table.
+  captureRequests: false,
   /**
    * **API Proxy**
    *

database/types.d.ts

@@ -1399,7 +1399,7 @@ declare module '@stacksjs/database' {
       created_at: string
       updated_at: string | null
       deleted_at: string | null
-      method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD"
+      method: string
       path: string
       status_code: number
       duration_ms: number

docs/guide/buddy/commands.md

@@ -5072,7 +5072,7 @@ List index settings
 
 | Option | Description | Contract | Default |
 | --- | --- | --- | --- |
-| `-m`, `--model` | Target a specific model | value, optional | `false` |
+| `-m`, `--model` | Target a specific model | value, required | `false` |
 | `--verbose` | Enable verbose output | boolean, optional | `false` |
 
 ### `search-engine:update`
@@ -5086,7 +5086,7 @@ Indexes database data to search engine
 
 | Option | Description | Contract | Default |
 | --- | --- | --- | --- |
-| `-m`, `--model` | Target a specific model | value, optional | `""` |
+| `-m`, `--model` | Target a specific model | value, required | `false` |
 | `-f`, `--flush` | Flushes all data from search engine | value, optional | `false` |
 | `-s`, `--settings` | Update index settings | value, optional | `false` |
 | `--verbose` | Enable verbose output | boolean, optional | `false` |

storage/framework/core/actions/src/dev/views.ts

@@ -8,6 +8,7 @@ import { seedCsrfPageResponse } from './csrf'
 import { resolveDefaultsResources } from './defaults-resources'
 import { exitWithParent } from './exit-with-parent'
 import type { EnhancedRequest } from '@stacksjs/router'
+import { beginRequestCapture, finishRequestCapture } from '@stacksjs/router/request-capture'
 
 /**
  * Boot the views/SSR dev server.
@@ -234,6 +235,7 @@ async function startDefaultServer() {
     // A page's ambient `ip`, resolved as `buddy serve` resolves it.
     clientAddress: viewClientAddress,
     onRequest: async (req: Request, server?: Parameters<typeof registerPeerSource>[0]) => {
+      beginRequestCapture(req)
       // First, before any `await`: this request's scope for its server
       // scripts (see `installRequestScope()` above).
       const snapshot = enterRequestScope(req)
@@ -382,6 +384,7 @@ async function startDefaultServer() {
       }
 
       const seeded = await seedCsrfPageResponse(req, current)
+      finishRequestCapture(req, seeded ?? current)
       return seeded ?? (current === baseline ? secured : current)
     },
   })

storage/framework/core/actions/src/helpers/utils.ts

@@ -294,7 +294,9 @@ export async function runAction(action: Action, options?: ActionOptions): Promis
   // whitespace without a shell, so a value or a path containing a space was
   // cut into several arguments (see `buddyOptionArgs`).
   const opts = isDevAction || !options ? [] : buddyOptionArgs(options as Record<string, any>)
-  const cmd = ['bun', developmentCondition, watchFlag, path, ...opts].filter(Boolean)
+  // Only optional launcher flags may disappear. An empty option value is
+  // still an argv token: dropping it turns `--model ''` into `--model true`.
+  const cmd = [...['bun', developmentCondition, watchFlag, path].filter(Boolean), ...opts]
 
   // Ensure pantry packages are resolvable via NODE_PATH
   // This allows compiled pantry packages (e.g., bun-plugin-stx/serve.js) to

storage/framework/core/actions/src/search/bootstrap.ts

@@ -0,0 +1,8 @@
+import { overridesReady } from '@stacksjs/config'
+import { injectGlobalAutoImports } from '@stacksjs/server'
+
+/** Model projections have the same framework globals in CLI and API processes. */
+export async function prepareSearchModels(): Promise<void> {
+  await overridesReady
+  await injectGlobalAutoImports()
+}

storage/framework/core/actions/src/search/flush.ts

@@ -2,6 +2,9 @@ import process from 'node:process'
 import { parseOptions } from '@stacksjs/cli'
 import { log } from '@stacksjs/logging'
 import { flushModelDocuments } from '@stacksjs/search-engine'
+import { prepareSearchModels } from './bootstrap'
+
+await prepareSearchModels()
 
 const options = parseOptions()
 
@@ -12,7 +15,9 @@ const result = await flushModelDocuments(modelOption)
 if (result?.isErr) {
   console.error(result.error)
   await log.error('Flushing search engine failed', result.error)
+  await log.flush()
   process.exit(1)
 }
 
+await log.flush()
 process.exit(0)

storage/framework/core/actions/src/search/import.ts

@@ -2,6 +2,9 @@ import process from 'node:process'
 import { parseOptions } from '@stacksjs/cli'
 import { log } from '@stacksjs/logging'
 import { importModelDocuments } from '@stacksjs/search-engine'
+import { prepareSearchModels } from './bootstrap'
+
+await prepareSearchModels()
 
 const options = parseOptions()
 
@@ -12,7 +15,9 @@ const result = await importModelDocuments(modelOption)
 if (result?.isErr) {
   console.error(result.error)
   await log.error('Import to search engine failed', result.error)
+  await log.flush()
   process.exit(1)
 }
 
+await log.flush()
 process.exit(0)

storage/framework/core/actions/src/search/settings-list.ts

@@ -2,6 +2,9 @@ import process from 'node:process'
 import { parseOptions } from '@stacksjs/cli'
 import { log } from '@stacksjs/logging'
 import { listIndexSettings } from '@stacksjs/search-engine'
+import { prepareSearchModels } from './bootstrap'
+
+await prepareSearchModels()
 
 const options = parseOptions()
 
@@ -12,7 +15,9 @@ const result = await listIndexSettings(modelOption)
 if (result?.isErr) {
   console.error(result.error)
   await log.error('Listing index settings failed', result.error)
+  await log.flush()
   process.exit(1)
 }
 
+await log.flush()
 process.exit(0)

storage/framework/core/actions/src/search/settings.ts

@@ -1,13 +1,19 @@
 import process from 'node:process'
+import { parseOptions } from '@stacksjs/cli'
 import { log } from '@stacksjs/logging'
 import { updateIndexSettings } from '@stacksjs/search-engine'
+import { prepareSearchModels } from './bootstrap'
 
-const result = await updateIndexSettings()
+await prepareSearchModels()
+
+const result = await updateIndexSettings(parseOptions().model as string | undefined)
 
 if (result?.isErr) {
   console.error(result.error)
   await log.error('Updating search settings failed', result.error)
+  await log.flush()
   process.exit(1)
 }
 
+await log.flush()
 process.exit(0)