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

package/config.d.ts

@@ -10,610 +10,40 @@ export type PlatformaticRuntimeConfig = {
 } & {
   $schema?: string;
   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;
   autoload?: {
     path: string;
     exclude?: string[];
     mappings?: {
-      [k: string]: {
-        id: string;
-        enabled?:
-          | boolean
-          | string
-          | {
-              [k: string]: boolean;
-            };
-        config?:
-          | string
-          | {
-              [k: string]: unknown;
-            };
-        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;
-        };
-        /**
-         * 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.
-         */
-        restartOnError?: boolean | number;
-        dependencies?: string[];
-        arguments?: string[];
-        env?: {
-          [k: string]: string;
-        };
-        envfile?: string;
-        sourceMaps?: boolean;
-        nodeModulesSourceMaps?: string[];
-        packageManager?: "npm" | "pnpm" | "yarn";
-        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;
-            };
-        management?:
-          | boolean
-          | {
-              enabled?: boolean;
-              operations?: string[];
-            };
-      };
+      [k: string]: ApplicationEntryOverrides;
     };
   };
-  applications?: {
-    [k: string]: unknown;
-  }[];
-  services?: {
-    [k: string]: unknown;
-  }[];
-  web?: {
-    [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;
-      };
+  applications?: ApplicationEntry[];
+  services?: ApplicationEntry1[];
+  web?: ApplicationEntry2[];
+  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;
-    };
-    captureStdio?: boolean;
-    pino?: {
-      level?: string;
-      time?: string;
-      message?: string;
-    };
-    [k: string]: unknown;
-  };
+  logger?: RuntimeLoggerOptions;
   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;
@@ -692,17 +122,585 @@ export type PlatformaticRuntimeConfig = {
       [k: string]: string | [string, ...string[]];
     };
   };
-  compileCache?:
+  compileCache?: boolean | CompileCacheOptions;
+  module?: string;
+};
+export type ApplicationEntry = {
+  [k: string]: unknown;
+};
+export type ApplicationEntry1 = {
+  [k: string]: unknown;
+};
+export type ApplicationEntry2 = {
+  [k: string]: unknown;
+};
+
+export interface ExtensionEntry {
+  path: string;
+  options?: {
+    [k: string]: unknown;
+  };
+  build?: boolean;
+}
+export interface ExtensionEntry1 {
+  path: string;
+  options?: {
+    [k: string]: unknown;
+  };
+  build?: boolean;
+}
+export interface ApplicationEntryOverrides {
+  id: string;
+  enabled?:
     | boolean
+    | string
     | {
-        /**
-         * 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;
+        [k: string]: boolean;
       };
-  module?: string;
-};
+  config?:
+    | string
+    | {
+        [k: string]: unknown;
+      };
+  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;
+  };
+  /**
+   * 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.
+   */
+  restartOnError?: boolean | number;
+  dependencies?: string[];
+  arguments?: string[];
+  env?: {
+    [k: string]: string;
+  };
+  envfile?: string;
+  sourceMaps?: boolean;
+  nodeModulesSourceMaps?: string[];
+  packageManager?: "npm" | "pnpm" | "yarn";
+  preload?: string | string[];
+  nodeOptions?: string;
+  execArgv?: string[];
+  permissions?: {
+    fs?: {
+      read?: string[];
+      write?: string[];
+    };
+  };
+  tracing?: {
+    /**
+     * 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;
+  };
+  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;
+      };
+  management?:
+    | boolean
+    | {
+        enabled?: boolean;
+        operations?: string[];
+      };
+}
+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 RuntimeLoggerOptions {
+  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;
+  };
+  captureStdio?: boolean;
+  pino?: {
+    level?: string;
+    time?: string;
+    message?: 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?: HttpsOptions;
+  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 HttpsOptions {
+  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;
+}