@platformatic/nest 4.0.0-new-config.1 → 4.0.0-new-config.5

package/config.d.ts

@@ -5,619 +5,44 @@
  * and run json-schema-to-typescript to regenerate this file.
  */
 
+export type ApplicationEntry = {
+  [k: string]: unknown;
+};
+
 export interface PlatformaticNestJSConfig {
   $schema?: string;
   module?: string;
-  logger?: {
-    level?: (
-      | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
-      | {
-          [k: string]: unknown;
-        }
-    ) &
-      string;
-    transport?:
-      | {
-          target?: string;
-          options?: {
-            [k: string]: unknown;
-          };
-        }
-      | {
-          targets?: {
-            target?: string;
-            options?: {
-              [k: string]: unknown;
-            };
-            level?: string;
-          }[];
-          options?: {
-            [k: string]: unknown;
-          };
-        };
-    pipeline?: {
-      target?: string;
-      options?: {
-        [k: string]: unknown;
-      };
-    };
-    formatters?: {
-      path: string;
-    };
-    timestamp?: "epochTime" | "unixTime" | "nullTime" | "isoTime";
-    redact?: {
-      paths: string[];
-      censor?: string;
-    };
-    base?: {
-      [k: string]: unknown;
-    } | null;
-    messageKey?: string;
-    customLevels?: {
-      [k: string]: unknown;
-    };
-    openTelemetryExporter?: {
-      protocol: "grpc" | "http";
-      url: string;
-    };
-    [k: string]: unknown;
-  };
-  server?: {
-    hostname?: string;
-    port?: number | string;
-    /**
-     * Configures how the port is assigned when the application runs multiple workers. When set to shared (the default), all workers listen on the same port (which requires SO_REUSEPORT support). When set to perWorkerIncrement, each worker listens on its own port, starting from port (worker 0) and incrementing by one for each additional worker.
-     */
-    portAssignment?: "shared" | "perWorkerIncrement";
-    /**
-     * The maximum length of the queue of pending connections
-     */
-    backlog?: number;
-    http2?: boolean;
-    https?: {
-      allowHTTP1?: boolean;
-      key:
-        | string
-        | {
-            path?: string;
-          }
-        | (
-            | string
-            | {
-                path?: string;
-              }
-          )[];
-      cert:
-        | string
-        | {
-            path?: string;
-          }
-        | (
-            | string
-            | {
-                path?: string;
-              }
-          )[];
-      requestCert?: boolean;
-      rejectUnauthorized?: boolean;
-    };
-  };
-  watch?:
-    | {
-        enabled?: boolean | string;
-        /**
-         * @minItems 1
-         */
-        allow?: [string, ...string[]];
-        ignore?: string[];
-      }
-    | boolean
-    | string;
-  application?: {
-    basePath?: string;
-    outputDirectory?: string;
-    include?: string[];
-    commands?: {
-      install?: string;
-      build?: string;
-      development?: string;
-      production?: string;
-    };
-    entrypointPort?: number;
-    changeDirectoryBeforeExecution?: boolean;
-    preferLocalCommands?: boolean;
-    processSpawner?: string;
-  };
+  logger?: AppLoggerOptions;
+  server?: AppServerOptions;
+  watch?: WatchOptions | boolean | string;
+  application?: BuildableApplicationOptions;
   runtime?: {
     preload?: string | string[];
-    extensions?:
-      | string
-      | {
-          path: string;
-          options?: {
-            [k: string]: unknown;
-          };
-          build?: boolean;
-        }
-      | (
-          | string
-          | {
-              path: string;
-              options?: {
-                [k: string]: unknown;
-              };
-              build?: boolean;
-            }
-        )[];
+    extensions?: string | ExtensionEntry | (string | ExtensionEntry1)[];
     basePath?: string;
-    services?: {
-      [k: string]: unknown;
-    }[];
-    workers?:
-      | number
-      | string
-      | {
-          static?: number;
-          dynamic?: boolean;
-          minimum?: number;
-          maximum?: number;
-          total?: number;
-          maxMemory?: number;
-          cooldown?: number;
-          gracePeriod?: number;
-          scaleUpELU?: number;
-          scaleDownELU?: number;
-          [k: string]: unknown;
-        };
+    services?: ApplicationEntry[];
+    workers?: number | string | WorkersOptions;
     workersRestartDelay?: number | string;
-    logger?: {
-      level?: (
-        | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
-        | {
-            [k: string]: unknown;
-          }
-      ) &
-        string;
-      transport?:
-        | {
-            target?: string;
-            options?: {
-              [k: string]: unknown;
-            };
-          }
-        | {
-            targets?: {
-              target?: string;
-              options?: {
-                [k: string]: unknown;
-              };
-              level?: string;
-            }[];
-            options?: {
-              [k: string]: unknown;
-            };
-          };
-      pipeline?: {
-        target?: string;
-        options?: {
-          [k: string]: unknown;
-        };
-      };
-      formatters?: {
-        path: string;
-      };
-      timestamp?: "epochTime" | "unixTime" | "nullTime" | "isoTime";
-      redact?: {
-        paths: string[];
-        censor?: string;
-      };
-      base?: {
-        [k: string]: unknown;
-      } | null;
-      messageKey?: string;
-      customLevels?: {
-        [k: string]: unknown;
-      };
-      openTelemetryExporter?: {
-        protocol: "grpc" | "http";
-        url: string;
-      };
-      [k: string]: unknown;
-    };
+    logger?: AppLoggerOptions1;
     reuseTcpPorts?: boolean;
     startTimeout?: number;
     restartOnError?: boolean | number;
     exitOnUnhandledErrors?: boolean | number;
-    gracefulShutdown?: {
-      runtime: number | string;
-      application: number | string;
-      /**
-       * Add Connection: close header to HTTP responses during graceful shutdown
-       */
-      closeConnections?: boolean;
-    };
-    health?: {
-      enabled?: boolean | string;
-      interval?: number | string;
-      gracePeriod?: number | string;
-      maxUnhealthyChecks?: number | string;
-      maxELU?: number | string;
-      maxEventLoopDelay?: number | string;
-      maxEventLoopDelayP99?: number | string;
-      maxHeapUsed?: number | string;
-      maxHeapTotal?: number | string;
-      maxYoungGeneration?: number | string;
-      codeRangeSize?: number | string;
-      bufferPoolSize?: number | string;
-      defaultHighWaterMark?: number | string;
-    };
-    healthProbes?:
-      | boolean
-      | string
-      | {
-          enabled?: boolean | string;
-          hostname?: string;
-          port?: number | string;
-          readiness?:
-            | boolean
-            | {
-                endpoint?: string;
-                success?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-                fail?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-              };
-          liveness?:
-            | boolean
-            | {
-                endpoint?: string;
-                success?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-                fail?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-              };
-        };
-    undici?: {
-      agentOptions?: {
-        [k: string]: unknown;
-      };
-      interceptors?:
-        | {
-            module: string;
-            options: {
-              [k: string]: unknown;
-            };
-            [k: string]: unknown;
-          }[]
-        | {
-            Client?: {
-              module: string;
-              options: {
-                [k: string]: unknown;
-              };
-              [k: string]: unknown;
-            }[];
-            Pool?: {
-              module: string;
-              options: {
-                [k: string]: unknown;
-              };
-              [k: string]: unknown;
-            }[];
-            Agent?: {
-              module: string;
-              options: {
-                [k: string]: unknown;
-              };
-              [k: string]: unknown;
-            }[];
-            [k: string]: unknown;
-          };
-      [k: string]: unknown;
-    };
-    httpCache?:
-      | boolean
-      | {
-          store?: string;
-          /**
-           * @minItems 1
-           */
-          methods?: [string, ...string[]];
-          cacheTagsHeader?: string;
-          maxSize?: number;
-          maxEntrySize?: number;
-          maxCount?: number;
-          /**
-           * Whitelist of origins to cache. Supports exact strings and regex patterns (e.g., "/https:\\/\\/.*\\.example\\.com/").
-           */
-          origins?: string[];
-          /**
-           * Default cache duration in seconds for responses without explicit expiration headers.
-           */
-          cacheByDefault?: number;
-          /**
-           * Cache type. "shared" caches may be shared between users, "private" caches are user-specific.
-           */
-          type?: "shared" | "private";
-          [k: string]: unknown;
-        };
+    gracefulShutdown?: GracefulShutdownOptions;
+    health?: HealthOptions;
+    healthProbes?: boolean | string | HealthProbesOptions;
+    undici?: UndiciOptions;
+    httpCache?: boolean | HttpCacheOptions;
     watch?: boolean | string;
-    managementApi?:
-      | boolean
-      | string
-      | {
-          logs?: {
-            maxSize?: number;
-          };
-          /**
-           * Custom path for the control socket. If not specified, uses the default platform-specific location.
-           */
-          socket?: string;
-        };
+    managementApi?: boolean | string | ManagementApiOptions;
     management?:
       | boolean
       | {
           enabled?: boolean;
           operations?: string[];
         };
-    metrics?:
-      | boolean
-      | {
-          port?: number | string;
-          enabled?: boolean | string;
-          hostname?: string;
-          endpoint?: string;
-          https?: {
-            allowHTTP1?: boolean;
-            key:
-              | string
-              | {
-                  path?: string;
-                }
-              | (
-                  | string
-                  | {
-                      path?: string;
-                    }
-                )[];
-            cert:
-              | string
-              | {
-                  path?: string;
-                }
-              | (
-                  | string
-                  | {
-                      path?: string;
-                    }
-                )[];
-            requestCert?: boolean;
-            rejectUnauthorized?: boolean;
-          };
-          auth?: {
-            username: string;
-            password: string;
-          };
-          labels?: {
-            [k: string]: string;
-          };
-          /**
-           * The label name to use for the application identifier in metrics (e.g., applicationId, serviceId)
-           */
-          applicationLabel?: string;
-          /**
-           * Enable outgoing HTTP client request duration metrics
-           */
-          httpClientMetrics?: boolean | string;
-          readiness?:
-            | boolean
-            | {
-                endpoint?: string;
-                success?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-                fail?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-              };
-          liveness?:
-            | boolean
-            | {
-                endpoint?: string;
-                success?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-                fail?: {
-                  statusCode?: number;
-                  body?: string;
-                };
-              };
-          /**
-           * @deprecated
-           * Deprecated. Health probe timeout configuration is no longer used.
-           */
-          healthChecksTimeouts?: number | string;
-          plugins?: string[];
-          timeout?: number | string;
-          /**
-           * Configuration for exporting metrics to an OTLP endpoint
-           */
-          otlpExporter?: {
-            /**
-             * Enable or disable OTLP metrics export
-             */
-            enabled?: boolean | string;
-            /**
-             * OTLP endpoint URL (e.g., http://collector:4318/v1/metrics)
-             */
-            endpoint: string;
-            /**
-             * Interval in milliseconds between metric pushes
-             */
-            interval?: number | string;
-            /**
-             * Additional HTTP headers for authentication
-             */
-            headers?: {
-              [k: string]: string;
-            };
-            /**
-             * Service name for OTLP resource attributes
-             */
-            serviceName?: string;
-            /**
-             * Service version for OTLP resource attributes
-             */
-            serviceVersion?: string;
-          };
-          /**
-           * Configuration for forwarding user OpenTelemetry metrics to an OTLP endpoint
-           */
-          opentelemetry?: {
-            /**
-             * Enable or disable OpenTelemetry metrics forwarding
-             */
-            enabled?: boolean | string;
-            /**
-             * OTLP metrics endpoint URL (e.g., http://collector:4318/v1/metrics)
-             */
-            endpoint: string;
-            /**
-             * Interval in milliseconds between metric forwards
-             */
-            interval?: number | string;
-            /**
-             * Additional HTTP headers for authentication
-             */
-            headers?: {
-              [k: string]: string;
-            };
-          };
-          /**
-           * Custom labels to add to HTTP metrics (http_request_all_duration_seconds). Each label extracts its value from an HTTP request header.
-           */
-          httpCustomLabels?: {
-            /**
-             * The label name to use in metrics
-             */
-            name: string;
-            /**
-             * The HTTP request header to extract the value from
-             */
-            header: string;
-            /**
-             * Default value when header is missing (defaults to "unknown")
-             */
-            default?: string;
-          }[];
-        };
-    telemetry?: {
-      enabled?: boolean | string;
-      /**
-       * The name of the application. Defaults to the folder name if not specified.
-       */
-      applicationName: string;
-      /**
-       * The version of the application (optional)
-       */
-      version?: string;
-      /**
-       * An array of paths to skip when creating spans. Useful for health checks and other endpoints that do not need to be traced.
-       */
-      skip?: {
-        /**
-         * The path to skip. Can be a string or a regex.
-         */
-        path?: string;
-        /**
-         * HTTP method to skip
-         */
-        method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
-        [k: string]: unknown;
-      }[];
-      exporter?:
-        | {
-            type?: "console" | "otlp" | "zipkin" | "memory" | "file";
-            /**
-             * Options for the exporter. These are passed directly to the exporter.
-             */
-            options?: {
-              /**
-               * The URL to send the traces to. Not used for console or memory exporters.
-               */
-              url?: string;
-              /**
-               * Headers to send to the exporter. Not used for console or memory exporters.
-               */
-              headers?: {
-                [k: string]: unknown;
-              };
-              /**
-               * The path to write the traces to. Only for file exporter.
-               */
-              path?: string;
-              /**
-               * The OTLP transport protocol to use. Only for the otlp exporter. Defaults to http.
-               */
-              protocol?: "http" | "grpc";
-              /**
-               * Alias for protocol. Only for the otlp exporter. Defaults to http.
-               */
-              transport?: "http" | "grpc";
-              [k: string]: unknown;
-            };
-            additionalProperties?: never;
-            [k: string]: unknown;
-          }[]
-        | {
-            type?: "console" | "otlp" | "zipkin" | "memory" | "file";
-            /**
-             * Options for the exporter. These are passed directly to the exporter.
-             */
-            options?: {
-              /**
-               * The URL to send the traces to. Not used for console or memory exporters.
-               */
-              url?: string;
-              /**
-               * Headers to send to the exporter. Not used for console or memory exporters.
-               */
-              headers?: {
-                [k: string]: unknown;
-              };
-              /**
-               * The path to write the traces to. Only for file exporter.
-               */
-              path?: string;
-              /**
-               * The OTLP transport protocol to use. Only for the otlp exporter. Defaults to http.
-               */
-              protocol?: "http" | "grpc";
-              /**
-               * Alias for protocol. Only for the otlp exporter. Defaults to http.
-               */
-              transport?: "http" | "grpc";
-              [k: string]: unknown;
-            };
-            additionalProperties?: never;
-            [k: string]: unknown;
-          };
-      /**
-       * Enable the OpenTelemetry diagnostic logger. Diagnostic messages are forwarded to the Platformatic global logger using the current logger level.
-       */
-      diagLogger?: boolean | string;
-    };
+    metrics?: boolean | MetricsOptions;
+    tracing?: TelemetryOptions;
     verticalScaler?: {
       enabled?: boolean;
       maxTotalWorkers?: number;
@@ -687,46 +112,11 @@ export interface PlatformaticNestJSConfig {
         [k: string]: string | [string, ...string[]];
       };
     };
-    compileCache?:
-      | boolean
-      | {
-          /**
-           * Enable Node.js module compile cache for faster startup
-           */
-          enabled?: boolean;
-          /**
-           * Directory to store compile cache. Defaults to .plt/compile-cache in app root
-           */
-          directory?: string;
-        };
+    compileCache?: boolean | CompileCacheOptions;
     application?: {
       reuseTcpPorts?: boolean;
-      workers?:
-        | number
-        | string
-        | {
-            static?: number;
-            minimum?: number;
-            maximum?: number;
-            scaleUpELU?: number;
-            scaleDownELU?: number;
-            [k: string]: unknown;
-          };
-      health?: {
-        enabled?: boolean | string;
-        interval?: number | string;
-        gracePeriod?: number | string;
-        maxUnhealthyChecks?: number | string;
-        maxELU?: number | string;
-        maxEventLoopDelay?: number | string;
-        maxEventLoopDelayP99?: number | string;
-        maxHeapUsed?: number | string;
-        maxHeapTotal?: number | string;
-        maxYoungGeneration?: number | string;
-        codeRangeSize?: number | string;
-        bufferPoolSize?: number | string;
-        defaultHighWaterMark?: number | string;
-      };
+      workers?: number | string | ApplicationWorkersOptions;
+      health?: ApplicationHealthOptions;
       /**
        * Overrides the runtime-level restartOnError for this application. Set to false or 0 to never restart the application when it crashes, a positive number to wait that amount of milliseconds between restarts, or true to use the default delay.
        */
@@ -742,41 +132,9 @@ export interface PlatformaticNestJSConfig {
       preload?: string | string[];
       nodeOptions?: string;
       execArgv?: string[];
-      permissions?: {
-        fs?: {
-          read?: string[];
-          write?: string[];
-        };
-      };
-      telemetry?: {
-        /**
-         * An array of instrumentations loaded if telemetry is enabled
-         */
-        instrumentations?: (
-          | string
-          | {
-              package: string;
-              exportName?: string;
-              options?: {
-                [k: string]: unknown;
-              };
-              [k: string]: unknown;
-            }
-        )[];
-        [k: string]: unknown;
-      };
-      compileCache?:
-        | boolean
-        | {
-            /**
-             * Enable Node.js module compile cache for faster startup
-             */
-            enabled?: boolean;
-            /**
-             * Directory to store compile cache. Defaults to .plt/compile-cache in app root
-             */
-            directory?: string;
-          };
+      permissions?: PermissionsOptions;
+      tracing?: ApplicationTelemetryOverrides;
+      compileCache?: boolean | CompileCacheOptions1;
     };
   };
   nest?: {
@@ -791,3 +149,641 @@ export interface PlatformaticNestJSConfig {
     };
   };
 }
+export interface AppLoggerOptions {
+  level?: (
+    | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
+    | {
+        [k: string]: unknown;
+      }
+  ) &
+    string;
+  transport?:
+    | {
+        target?: string;
+        options?: {
+          [k: string]: unknown;
+        };
+      }
+    | {
+        targets?: {
+          target?: string;
+          options?: {
+            [k: string]: unknown;
+          };
+          level?: string;
+        }[];
+        options?: {
+          [k: string]: unknown;
+        };
+      };
+  pipeline?: {
+    target?: string;
+    options?: {
+      [k: string]: unknown;
+    };
+  };
+  formatters?: {
+    path: string;
+  };
+  timestamp?: "epochTime" | "unixTime" | "nullTime" | "isoTime";
+  redact?: {
+    paths: string[];
+    censor?: string;
+  };
+  base?: {
+    [k: string]: unknown;
+  } | null;
+  messageKey?: string;
+  customLevels?: {
+    [k: string]: unknown;
+  };
+  openTelemetryExporter?: {
+    protocol: "grpc" | "http";
+    url: string;
+  };
+  [k: string]: unknown;
+}
+export interface AppServerOptions {
+  hostname?: string;
+  port?: number | string;
+  /**
+   * Configures how the port is assigned when the application runs multiple workers. When set to shared (the default), all workers listen on the same port (which requires SO_REUSEPORT support). When set to perWorkerIncrement, each worker listens on its own port, starting from port (worker 0) and incrementing by one for each additional worker.
+   */
+  portAssignment?: "shared" | "perWorkerIncrement";
+  /**
+   * The maximum length of the queue of pending connections
+   */
+  backlog?: number;
+  http2?: boolean;
+  https?: HttpsOptions;
+}
+export interface HttpsOptions {
+  allowHTTP1?: boolean;
+  key:
+    | string
+    | {
+        path?: string;
+      }
+    | (
+        | string
+        | {
+            path?: string;
+          }
+      )[];
+  cert:
+    | string
+    | {
+        path?: string;
+      }
+    | (
+        | string
+        | {
+            path?: string;
+          }
+      )[];
+  requestCert?: boolean;
+  rejectUnauthorized?: boolean;
+}
+export interface WatchOptions {
+  enabled?: boolean | string;
+  /**
+   * @minItems 1
+   */
+  allow?: [string, ...string[]];
+  ignore?: string[];
+}
+export interface BuildableApplicationOptions {
+  basePath?: string;
+  outputDirectory?: string;
+  include?: string[];
+  commands?: {
+    install?: string;
+    build?: string;
+    development?: string;
+    production?: string;
+  };
+  changeDirectoryBeforeExecution?: boolean;
+  preferLocalCommands?: boolean;
+  processSpawner?: string;
+}
+export interface ExtensionEntry {
+  path: string;
+  options?: {
+    [k: string]: unknown;
+  };
+  build?: boolean;
+}
+export interface ExtensionEntry1 {
+  path: string;
+  options?: {
+    [k: string]: unknown;
+  };
+  build?: boolean;
+}
+export interface WorkersOptions {
+  static?: number;
+  dynamic?: boolean;
+  minimum?: number;
+  maximum?: number;
+  total?: number;
+  maxMemory?: number;
+  cooldown?: number;
+  gracePeriod?: number;
+  scaleUpELU?: number;
+  scaleDownELU?: number;
+  [k: string]: unknown;
+}
+export interface AppLoggerOptions1 {
+  level?: (
+    | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
+    | {
+        [k: string]: unknown;
+      }
+  ) &
+    string;
+  transport?:
+    | {
+        target?: string;
+        options?: {
+          [k: string]: unknown;
+        };
+      }
+    | {
+        targets?: {
+          target?: string;
+          options?: {
+            [k: string]: unknown;
+          };
+          level?: string;
+        }[];
+        options?: {
+          [k: string]: unknown;
+        };
+      };
+  pipeline?: {
+    target?: string;
+    options?: {
+      [k: string]: unknown;
+    };
+  };
+  formatters?: {
+    path: string;
+  };
+  timestamp?: "epochTime" | "unixTime" | "nullTime" | "isoTime";
+  redact?: {
+    paths: string[];
+    censor?: string;
+  };
+  base?: {
+    [k: string]: unknown;
+  } | null;
+  messageKey?: string;
+  customLevels?: {
+    [k: string]: unknown;
+  };
+  openTelemetryExporter?: {
+    protocol: "grpc" | "http";
+    url: string;
+  };
+  [k: string]: unknown;
+}
+export interface GracefulShutdownOptions {
+  runtime: number | string;
+  application: number | string;
+  /**
+   * Add Connection: close header to HTTP responses during graceful shutdown
+   */
+  closeConnections?: boolean;
+}
+export interface HealthOptions {
+  enabled?: boolean | string;
+  interval?: number | string;
+  gracePeriod?: number | string;
+  maxUnhealthyChecks?: number | string;
+  maxELU?: number | string;
+  maxEventLoopDelay?: number | string;
+  maxEventLoopDelayP99?: number | string;
+  maxHeapUsed?: number | string;
+  maxHeapTotal?: number | string;
+  maxYoungGeneration?: number | string;
+  codeRangeSize?: number | string;
+  bufferPoolSize?: number | string;
+  defaultHighWaterMark?: number | string;
+}
+export interface HealthProbesOptions {
+  enabled?: boolean | string;
+  hostname?: string;
+  port?: number | string;
+  readiness?:
+    | boolean
+    | {
+        endpoint?: string;
+        success?: {
+          statusCode?: number;
+          body?: string;
+        };
+        fail?: {
+          statusCode?: number;
+          body?: string;
+        };
+      };
+  liveness?:
+    | boolean
+    | {
+        endpoint?: string;
+        success?: {
+          statusCode?: number;
+          body?: string;
+        };
+        fail?: {
+          statusCode?: number;
+          body?: string;
+        };
+      };
+}
+export interface UndiciOptions {
+  agentOptions?: {
+    [k: string]: unknown;
+  };
+  interceptors?:
+    | {
+        module: string;
+        options: {
+          [k: string]: unknown;
+        };
+        [k: string]: unknown;
+      }[]
+    | {
+        Client?: {
+          module: string;
+          options: {
+            [k: string]: unknown;
+          };
+          [k: string]: unknown;
+        }[];
+        Pool?: {
+          module: string;
+          options: {
+            [k: string]: unknown;
+          };
+          [k: string]: unknown;
+        }[];
+        Agent?: {
+          module: string;
+          options: {
+            [k: string]: unknown;
+          };
+          [k: string]: unknown;
+        }[];
+        [k: string]: unknown;
+      };
+  [k: string]: unknown;
+}
+export interface HttpCacheOptions {
+  store?: string;
+  /**
+   * @minItems 1
+   */
+  methods?: [string, ...string[]];
+  cacheTagsHeader?: string;
+  maxSize?: number;
+  maxEntrySize?: number;
+  maxCount?: number;
+  /**
+   * Whitelist of origins to cache. Supports exact strings and regex patterns (e.g., "/https:\\/\\/.*\\.example\\.com/").
+   */
+  origins?: string[];
+  /**
+   * Default cache duration in seconds for responses without explicit expiration headers.
+   */
+  cacheByDefault?: number;
+  /**
+   * Cache type. "shared" caches may be shared between users, "private" caches are user-specific.
+   */
+  type?: "shared" | "private";
+  [k: string]: unknown;
+}
+export interface ManagementApiOptions {
+  logs?: {
+    maxSize?: number;
+  };
+  /**
+   * Custom path for the control socket. If not specified, uses the default platform-specific location.
+   */
+  socket?: string;
+}
+export interface MetricsOptions {
+  port?: number | string;
+  enabled?: boolean | string;
+  hostname?: string;
+  endpoint?: string;
+  https?: HttpsOptions1;
+  auth?: {
+    username: string;
+    password: string;
+  };
+  labels?: {
+    [k: string]: string;
+  };
+  /**
+   * The label name to use for the application identifier in metrics (e.g., applicationId, serviceId)
+   */
+  applicationLabel?: string;
+  /**
+   * Enable outgoing HTTP client request duration metrics
+   */
+  httpClientMetrics?: boolean | string;
+  readiness?:
+    | boolean
+    | {
+        endpoint?: string;
+        success?: {
+          statusCode?: number;
+          body?: string;
+        };
+        fail?: {
+          statusCode?: number;
+          body?: string;
+        };
+      };
+  liveness?:
+    | boolean
+    | {
+        endpoint?: string;
+        success?: {
+          statusCode?: number;
+          body?: string;
+        };
+        fail?: {
+          statusCode?: number;
+          body?: string;
+        };
+      };
+  /**
+   * @deprecated
+   * Deprecated. Health probe timeout configuration is no longer used.
+   */
+  healthChecksTimeouts?: number | string;
+  plugins?: string[];
+  timeout?: number | string;
+  /**
+   * Configuration for exporting metrics to an OTLP endpoint
+   */
+  otlpExporter?: {
+    /**
+     * Enable or disable OTLP metrics export
+     */
+    enabled?: boolean | string;
+    /**
+     * OTLP endpoint URL (e.g., http://collector:4318/v1/metrics)
+     */
+    endpoint: string;
+    /**
+     * Interval in milliseconds between metric pushes
+     */
+    interval?: number | string;
+    /**
+     * Additional HTTP headers for authentication
+     */
+    headers?: {
+      [k: string]: string;
+    };
+    /**
+     * Service name for OTLP resource attributes
+     */
+    serviceName?: string;
+    /**
+     * Service version for OTLP resource attributes
+     */
+    serviceVersion?: string;
+  };
+  /**
+   * Configuration for forwarding user OpenTelemetry metrics to an OTLP endpoint
+   */
+  opentelemetry?: {
+    /**
+     * Enable or disable OpenTelemetry metrics forwarding
+     */
+    enabled?: boolean | string;
+    /**
+     * OTLP metrics endpoint URL (e.g., http://collector:4318/v1/metrics)
+     */
+    endpoint: string;
+    /**
+     * Interval in milliseconds between metric forwards
+     */
+    interval?: number | string;
+    /**
+     * Additional HTTP headers for authentication
+     */
+    headers?: {
+      [k: string]: string;
+    };
+  };
+  /**
+   * Custom labels to add to HTTP metrics (http_request_all_duration_seconds). Each label extracts its value from an HTTP request header.
+   */
+  httpCustomLabels?: {
+    /**
+     * The label name to use in metrics
+     */
+    name: string;
+    /**
+     * The HTTP request header to extract the value from
+     */
+    header: string;
+    /**
+     * Default value when header is missing (defaults to "unknown")
+     */
+    default?: string;
+  }[];
+}
+export interface HttpsOptions1 {
+  allowHTTP1?: boolean;
+  key:
+    | string
+    | {
+        path?: string;
+      }
+    | (
+        | string
+        | {
+            path?: string;
+          }
+      )[];
+  cert:
+    | string
+    | {
+        path?: string;
+      }
+    | (
+        | string
+        | {
+            path?: string;
+          }
+      )[];
+  requestCert?: boolean;
+  rejectUnauthorized?: boolean;
+}
+export interface TelemetryOptions {
+  enabled?: boolean | string;
+  /**
+   * The name of the application. Defaults to the folder name if not specified.
+   */
+  applicationName: string;
+  /**
+   * The version of the application (optional)
+   */
+  version?: string;
+  /**
+   * An array of paths to skip when creating spans. Useful for health checks and other endpoints that do not need to be traced.
+   */
+  skip?: {
+    /**
+     * The path to skip. Can be a string or a regex.
+     */
+    path?: string;
+    /**
+     * HTTP method to skip
+     */
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+    [k: string]: unknown;
+  }[];
+  exporter?:
+    | {
+        type?: "console" | "otlp" | "zipkin" | "memory" | "file";
+        /**
+         * Options for the exporter. These are passed directly to the exporter.
+         */
+        options?: {
+          /**
+           * The URL to send the traces to. Not used for console or memory exporters.
+           */
+          url?: string;
+          /**
+           * Headers to send to the exporter. Not used for console or memory exporters.
+           */
+          headers?: {
+            [k: string]: unknown;
+          };
+          /**
+           * The path to write the traces to. Only for file exporter.
+           */
+          path?: string;
+          /**
+           * The OTLP transport protocol to use. Only for the otlp exporter. Defaults to http.
+           */
+          protocol?: "http" | "grpc";
+          /**
+           * Alias for protocol. Only for the otlp exporter. Defaults to http.
+           */
+          transport?: "http" | "grpc";
+          [k: string]: unknown;
+        };
+        additionalProperties?: never;
+        [k: string]: unknown;
+      }[]
+    | {
+        type?: "console" | "otlp" | "zipkin" | "memory" | "file";
+        /**
+         * Options for the exporter. These are passed directly to the exporter.
+         */
+        options?: {
+          /**
+           * The URL to send the traces to. Not used for console or memory exporters.
+           */
+          url?: string;
+          /**
+           * Headers to send to the exporter. Not used for console or memory exporters.
+           */
+          headers?: {
+            [k: string]: unknown;
+          };
+          /**
+           * The path to write the traces to. Only for file exporter.
+           */
+          path?: string;
+          /**
+           * The OTLP transport protocol to use. Only for the otlp exporter. Defaults to http.
+           */
+          protocol?: "http" | "grpc";
+          /**
+           * Alias for protocol. Only for the otlp exporter. Defaults to http.
+           */
+          transport?: "http" | "grpc";
+          [k: string]: unknown;
+        };
+        additionalProperties?: never;
+        [k: string]: unknown;
+      };
+  /**
+   * Enable the OpenTelemetry diagnostic logger. Diagnostic messages are forwarded to the Platformatic global logger using the current logger level.
+   */
+  diagLogger?: boolean | string;
+}
+export interface CompileCacheOptions {
+  /**
+   * Enable Node.js module compile cache for faster startup
+   */
+  enabled?: boolean;
+  /**
+   * Directory to store compile cache. Defaults to .plt/compile-cache in app root
+   */
+  directory?: string;
+}
+export interface ApplicationWorkersOptions {
+  static?: number;
+  minimum?: number;
+  maximum?: number;
+  scaleUpELU?: number;
+  scaleDownELU?: number;
+  [k: string]: unknown;
+}
+export interface ApplicationHealthOptions {
+  enabled?: boolean | string;
+  interval?: number | string;
+  gracePeriod?: number | string;
+  maxUnhealthyChecks?: number | string;
+  maxELU?: number | string;
+  maxEventLoopDelay?: number | string;
+  maxEventLoopDelayP99?: number | string;
+  maxHeapUsed?: number | string;
+  maxHeapTotal?: number | string;
+  maxYoungGeneration?: number | string;
+  codeRangeSize?: number | string;
+  bufferPoolSize?: number | string;
+  defaultHighWaterMark?: number | string;
+}
+export interface PermissionsOptions {
+  fs?: {
+    read?: string[];
+    write?: string[];
+  };
+}
+export interface ApplicationTelemetryOverrides {
+  /**
+   * An array of instrumentations loaded if tracing is enabled
+   */
+  instrumentations?: (
+    | string
+    | {
+        package: string;
+        exportName?: string;
+        options?: {
+          [k: string]: unknown;
+        };
+        [k: string]: unknown;
+      }
+  )[];
+  [k: string]: unknown;
+}
+export interface CompileCacheOptions1 {
+  /**
+   * Enable Node.js module compile cache for faster startup
+   */
+  enabled?: boolean;
+  /**
+   * Directory to store compile cache. Defaults to .plt/compile-cache in app root
+   */
+  directory?: string;
+}