@stacksjs/types 0.72.7 → 0.72.9

package/dist/logging.d.ts

@@ -1,3 +1,59 @@
+/**
+ * Request-scoped fields carried alongside a log line.
+ *
+ * Populated automatically from the router's trace storage, and extendable by
+ * any caller through `withLogContext`.
+ */
+export declare interface LogContext {
+  requestId?: string
+  userId?: string | number
+  [key: string]: unknown
+}
+/**
+ * One log call, as a transport sees it.
+ *
+ * `message` is the formatted line, which is what a transport wants if it is
+ * writing text. `args` is the same call before formatting, which is what a
+ * transport wants if it is building structured output: an `Error` is still an
+ * `Error` there, and a context object is still an object rather than a
+ * pretty-printed blob inside a string.
+ */
+export declare interface LogRecord {
+  level: LogLevel
+  message: string
+  args: unknown[]
+  context?: LogContext
+  timestamp: string
+}
+/**
+ * A destination for log records, alongside the console and the log file.
+ *
+ * This is the seam for shipping logs somewhere else: a hosted log service, an
+ * OpenTelemetry exporter, an in-memory sink in a test. Register one in
+ * `config/logging.ts` or at runtime with `registerTransport()`.
+ *
+ * @example
+ * ```ts
+ * // config/logging.ts
+ * export default {
+ *   logsPath: 'storage/logs/console.log',
+ *   deploymentsPath: 'storage/logs/deployments.log',
+ *   transports: [
+ *     {
+ *       name: 'memory',
+ *       level: 'warning',
+ *       log: record => lines.push(record),
+ *     },
+ *   ],
+ * } satisfies LoggingConfig
+ * ```
+ */
+export declare interface LogTransport {
+  name: string
+  level?: LogLevel
+  log: (record: LogRecord) => void
+  flush?: () => Promise<void>
+}
 /**
  * **Logging Options**
  *
@@ -8,8 +64,16 @@
 export declare interface LoggingOptions {
   logsPath: string
   deploymentsPath: string
-  level?: 'debug' | 'info' | 'success' | 'warning' | 'error'
+  level?: LogLevel
   format?: 'json' | 'text'
   writeToFile?: boolean
+  transports?: LogTransport[]
 }
+/**
+ * The severities the framework logs at.
+ *
+ * Note `success`, which is an outcome rather than a severity: it ranks with
+ * `info` when a transport filters by level.
+ */
+export type LogLevel = 'debug' | 'info' | 'success' | 'warning' | 'error';
 export type LoggingConfig = Partial<LoggingOptions>;

package/dist/server.d.ts

@@ -18,6 +18,11 @@ export declare interface ApiProxyOptions {
 export declare interface ServerConfig {
   proxy?: ApiProxyOptions
   redirects?: RedirectsOptions
+  security?: ServerSecurityOptions
+}
+/** Security headers the views server puts on rendered pages. */
+export declare interface ServerSecurityOptions {
+  embeddable?: string[]
 }
 export declare interface ServerOptions {
   type?:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.72.7",
+  "version": "0.72.9",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "contributors": [
@@ -71,7 +71,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.72.7",
+    "@stacksjs/validation": "0.72.9",
     "better-dx": "^0.2.23",
     "meilisearch": "^0.59.0"
   },