@autter/runtime-node 1.6.0 → 1.7.0

package/dist/index.d.cts

@@ -198,8 +198,9 @@ type RuntimeContextHandle = typeof runtimeContext;
  *                                         call)
  *   successful traces            : 1%    (head sampling, configurable)
  *   request metrics              : aggregated every 60 s, keyed by route
- *                                  template (Express routes detected
- *                                  out of the box — see captureExpressRoute)
+ *                                  template (Express and Next.js routes
+ *                                  detected out of the box — see
+ *                                  captureRequestRoute, route-label.ts)
  *   operation / request summaries: 100%  (withRuntimeOperation,
  *                                         autterRequests, … — one wide
  *                                         record per unit of work, never
@@ -281,6 +282,18 @@ interface AutterServerOptions {
      * Default true.
      */
     redactAttributes?: boolean | RedactOptions;
+    /**
+     * Query strings never leave the process with their values. Every span
+     * (any instrumentation, Next.js's own included) is exported with
+     * `http.target`, `http.url` and `url.full` cut at the `?`, `url.query`
+     * reduced to its parameter names (`email=[redacted]&page=[redacted]`,
+     * added when only the URL had the query) and the query dropped from span
+     * names. List parameters whose values are safe to keep in `url.query`,
+     * such as pagination or sorting: `keepQueryParams: ["page", "sort"]`
+     * (exact names; kept values are still scrubbed by `redactAttributes`).
+     * Applies even with `redactAttributes: false`. Default `[]`.
+     */
+    keepQueryParams?: string[];
     /**
      * Verbose lifecycle logging to stderr: "exported N spans", flushes and
      * auto-flush activity — handy while wiring the SDK up. Also enabled by

package/dist/index.d.ts

@@ -198,8 +198,9 @@ type RuntimeContextHandle = typeof runtimeContext;
  *                                         call)
  *   successful traces            : 1%    (head sampling, configurable)
  *   request metrics              : aggregated every 60 s, keyed by route
- *                                  template (Express routes detected
- *                                  out of the box — see captureExpressRoute)
+ *                                  template (Express and Next.js routes
+ *                                  detected out of the box — see
+ *                                  captureRequestRoute, route-label.ts)
  *   operation / request summaries: 100%  (withRuntimeOperation,
  *                                         autterRequests, … — one wide
  *                                         record per unit of work, never
@@ -281,6 +282,18 @@ interface AutterServerOptions {
      * Default true.
      */
     redactAttributes?: boolean | RedactOptions;
+    /**
+     * Query strings never leave the process with their values. Every span
+     * (any instrumentation, Next.js's own included) is exported with
+     * `http.target`, `http.url` and `url.full` cut at the `?`, `url.query`
+     * reduced to its parameter names (`email=[redacted]&page=[redacted]`,
+     * added when only the URL had the query) and the query dropped from span
+     * names. List parameters whose values are safe to keep in `url.query`,
+     * such as pagination or sorting: `keepQueryParams: ["page", "sort"]`
+     * (exact names; kept values are still scrubbed by `redactAttributes`).
+     * Applies even with `redactAttributes: false`. Default `[]`.
+     */
+    keepQueryParams?: string[];
     /**
      * Verbose lifecycle logging to stderr: "exported N spans", flushes and
      * auto-flush activity — handy while wiring the SDK up. Also enabled by