@platformatic/runtime 3.72.0 → 4.0.0-alpha.1

package/config.d.ts

@@ -10,138 +10,111 @@ 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;
-          }
-      )[];
-  entrypoint?: string;
+  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;
-        useHttp?: boolean;
-        websocket?: boolean;
-        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?: {
+  applications?: ApplicationEntry[];
+  services?: ApplicationEntry1[];
+  web?: ApplicationEntry2[];
+  workers?: number | string | WorkersOptions;
+  workersRestartDelay?: number | string;
+  logger?: RuntimeLoggerOptions;
+  reuseTcpPorts?: boolean;
+  startTimeout?: number;
+  restartOnError?: boolean | number;
+  exitOnUnhandledErrors?: boolean | number;
+  gracefulShutdown?: GracefulShutdownOptions;
+  health?: HealthOptions;
+  healthProbes?: boolean | string | HealthProbesOptions;
+  undici?: UndiciOptions;
+  httpCache?: boolean | HttpCacheOptions;
+  watch?: boolean | string;
+  managementApi?: boolean | string | ManagementApiOptions;
+  management?:
+    | boolean
+    | {
+        enabled?: boolean;
+        operations?: string[];
+      };
+  metrics?: boolean | MetricsOptions;
+  tracing?: TelemetryOptions;
+  inspectorOptions?: {
+    host?: string;
+    port?: number;
+    breakFirstLine?: boolean;
+    watchDisabled?: boolean;
     [k: string]: unknown;
-  }[];
-  services?: {
+  };
+  applicationTimeout?: number | string;
+  startupConcurrency?: number | string;
+  messagingTimeout?: number | string;
+  resolvedApplicationsBasePath?: string;
+  env?: {
+    [k: string]: string;
+  };
+  envfile?: string;
+  /**
+   * When set to true, the configuration loading fails if a {PLT_*} placeholder references an environment variable which is not set. When set to "warn", a warning listing the missing variables is logged but the placeholders are still replaced with an empty string. Defaults to false.
+   */
+  strictEnv?: boolean | string;
+  sourceMaps?: boolean;
+  nodeModulesSourceMaps?: string[];
+  policies?: {
+    deny: {
+      /**
+       * This interface was referenced by `undefined`'s JSON-Schema definition
+       * via the `patternProperty` "^.*$".
+       */
+      [k: string]: string | [string, ...string[]];
+    };
+  };
+  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;
-  }[];
-  web?: {
+  };
+  build?: boolean;
+}
+export interface ExtensionEntry1 {
+  path: string;
+  options?: {
     [k: string]: unknown;
-  }[];
+  };
+  build?: boolean;
+}
+export interface ApplicationEntryOverrides {
+  id: string;
+  enabled?:
+    | boolean
+    | string
+    | {
+        [k: string]: boolean;
+      };
+  config?:
+    | string
+    | {
+        [k: string]: unknown;
+      };
+  reuseTcpPorts?: boolean;
   workers?:
     | number
     | string
@@ -150,639 +123,595 @@ export type PlatformaticRuntimeConfig = {
         dynamic?: boolean;
         minimum?: number;
         maximum?: number;
-        total?: number;
-        maxMemory?: number;
-        cooldown?: number;
-        gracePeriod?: number;
-        scaleUpELU?: number;
-        scaleDownELU?: number;
-        [k: string]: unknown;
+        eluThreshold?: number;
+        heapThresholdMb?: number;
       };
-  workersRestartDelay?: number | string;
-  logger?: {
+  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?: {
     /**
-     * The log level. It must be one of the standard pino levels (fatal, error, warn, info, debug, trace, silent) or, when customLevels is set, one of the custom levels.
+     * An array of instrumentations loaded if tracing is enabled
      */
-    level?: string;
-    transport?:
+    instrumentations?: (
+      | string
       | {
-          target?: string;
+          package: string;
+          exportName?: string;
           options?: {
             [k: string]: unknown;
           };
+          [k: string]: unknown;
         }
-      | {
-          targets?: {
-            target?: string;
-            options?: {
-              [k: string]: unknown;
-            };
-            level?: string;
-          }[];
+    )[];
+    [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;
+        /**
+         * Wait for the first worker to start before starting the remaining workers
+         */
+        awaitFirstWorker?: boolean;
+      };
+  management?:
+    | boolean
+    | {
+        enabled?: boolean;
+        operations?: string[];
+      };
+}
+export interface WorkersOptions {
+  static?: number;
+  dynamic?: boolean;
+  minimum?: number;
+  maximum?: number;
+  total?: number;
+  maxMemory?: number;
+  eluThreshold?: number;
+  heapThresholdMb?: number;
+  processIntervalMs?: number;
+  maxScaleUpStep?: number;
+  redistributionMs?: number;
+  alphaUp?: number;
+  alphaDown?: number;
+  betaUp?: number;
+  betaDown?: number;
+  cooldowns?: {
+    scaleUpAfterScaleUpMs?: number;
+    scaleUpAfterScaleDownMs?: number;
+    scaleDownAfterScaleUpMs?: number;
+    scaleDownAfterScaleDownMs?: number;
+  };
+}
+export interface RuntimeLoggerOptions {
+  /**
+   * A standard Pino log level or a level defined in customLevels.
+   */
+  level?: 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;
-      /**
-       * Remove the redacted keys entirely instead of replacing their values with the censor. Defaults to false.
-       */
-      remove?: boolean;
-    };
-    base?: {
-      [k: string]: unknown;
-    } | null;
-    messageKey?: string;
-    customLevels?: {
+  pipeline?: {
+    target?: string;
+    options?: {
       [k: string]: unknown;
     };
+  };
+  formatters?: {
+    path: string;
+  };
+  timestamp?: "epochTime" | "unixTime" | "nullTime" | "isoTime";
+  redact?: {
+    paths: string[];
+    censor?: string;
     /**
-     * The numeric value of the level defined in level, when it is not one of the standard pino levels.
+     * Remove the redacted keys entirely instead of replacing their values with the censor. Defaults to false.
      */
-    levelVal?: number;
+    remove?: boolean;
+  };
+  base?: {
+    [k: string]: unknown;
+  } | null;
+  messageKey?: string;
+  customLevels?: {
+    [k: string]: unknown;
+  };
+  /**
+   * The numeric value of the level defined in level, when it is not one of the standard pino levels.
+   */
+  levelVal?: number;
+  /**
+   * Only use the levels defined in customLevels and omit the standard pino ones.
+   */
+  useOnlyCustomLevels?: boolean;
+  /**
+   * How log levels are compared to the logger level. Use DESC when lower values are more severe. Defaults to ASC.
+   */
+  levelComparison?: "ASC" | "DESC";
+  /**
+   * A string prefixed to every message, including the ones of child loggers.
+   */
+  msgPrefix?: string;
+  /**
+   * The key under which any logged object is placed.
+   */
+  nestedKey?: string;
+  /**
+   * The key used for the serialized error in the log object. Defaults to err.
+   */
+  errorKey?: string;
+  /**
+   * The stringification limit at a specific nesting depth when logging circular objects. Defaults to 5.
+   */
+  depthLimit?: number;
+  /**
+   * The stringification limit of properties or elements when logging a circular object or array. Defaults to 100.
+   */
+  edgeLimit?: number;
+  /**
+   * Terminate each log line with \r\n instead of \n. Defaults to false.
+   */
+  crlf?: boolean;
+  /**
+   * Set to false to disable logging entirely. Defaults to true.
+   */
+  enabled?: boolean;
+  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;
     /**
-     * Only use the levels defined in customLevels and omit the standard pino ones.
+     * OTLP endpoint URL (e.g., http://collector:4318/v1/metrics)
      */
-    useOnlyCustomLevels?: boolean;
+    endpoint: string;
     /**
-     * How log levels are compared to the logger level. Use DESC when lower values are more severe. Defaults to ASC.
+     * Interval in milliseconds between metric pushes
      */
-    levelComparison?: "ASC" | "DESC";
+    interval?: number | string;
     /**
-     * A string prefixed to every message, including the ones of child loggers.
+     * Additional HTTP headers for authentication
      */
-    msgPrefix?: string;
+    headers?: {
+      [k: string]: string;
+    };
     /**
-     * The key under which any logged object is placed.
+     * Service name for OTLP resource attributes
      */
-    nestedKey?: string;
+    serviceName?: string;
     /**
-     * The key used for the serialized error in the log object. Defaults to err.
+     * Service version for OTLP resource attributes
      */
-    errorKey?: string;
+    serviceVersion?: string;
+  };
+  /**
+   * Configuration for forwarding user OpenTelemetry metrics to an OTLP endpoint
+   */
+  opentelemetry?: {
     /**
-     * The stringification limit at a specific nesting depth when logging circular objects. Defaults to 5.
+     * Enable or disable OpenTelemetry metrics forwarding
      */
-    depthLimit?: number;
+    enabled?: boolean | string;
     /**
-     * The stringification limit of properties or elements when logging a circular object or array. Defaults to 100.
+     * OTLP metrics endpoint URL (e.g., http://collector:4318/v1/metrics)
      */
-    edgeLimit?: number;
+    endpoint: string;
     /**
-     * Terminate each log line with \r\n instead of \n. Defaults to false.
+     * Interval in milliseconds between metric forwards
      */
-    crlf?: boolean;
+    interval?: number | string;
     /**
-     * Set to false to disable logging entirely. Defaults to true.
+     * Additional HTTP headers for authentication
      */
-    enabled?: boolean;
-    openTelemetryExporter?: {
-      protocol: "grpc" | "http";
-      url: string;
-    };
-    captureStdio?: boolean;
-    pino?: {
-      level?: string;
-      time?: string;
-      message?: string;
+    headers?: {
+      [k: string]: string;
     };
-    [k: string]: unknown;
   };
-  server?: {
-    hostname?: string;
-    port?: number | 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;
     /**
-     * Configures how entrypoint server worker ports are assigned. When set to shared, all workers listen on the same port. When set to perWorkerIncrement, each worker will use its own port, starting from port (worker 0).
+     * The HTTP request header to extract the value from
      */
-    portAssignment?: "shared" | "perWorkerIncrement";
+    header: string;
     /**
-     * The maximum length of the queue of pending connections
+     * Default value when header is missing (defaults to "unknown")
      */
-    backlog?: number;
-    http2?: boolean;
-    https?: {
-      allowHTTP1?: boolean;
-      key:
+    default?: string;
+  }[];
+}
+export interface HttpsOptions {
+  allowHTTP1?: boolean;
+  key:
+    | string
+    | {
+        path?: string;
+      }
+    | (
         | string
         | {
             path?: string;
           }
-        | (
-            | string
-            | {
-                path?: string;
-              }
-          )[];
-      cert:
+      )[];
+  cert:
+    | string
+    | {
+        path?: string;
+      }
+    | (
         | string
         | {
             path?: string;
           }
-        | (
-            | string
-            | {
-                path?: string;
-              }
-          )[];
-      requestCert?: boolean;
-      rejectUnauthorized?: boolean;
-    };
-  };
-  reuseTcpPorts?: boolean;
-  startTimeout?: number;
-  restartOnError?: boolean | number;
-  exitOnUnhandledErrors?: boolean | number;
-  gracefulShutdown?: {
-    runtime: number | string;
-    application: number | 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?: {
     /**
-     * Add Connection: close header to HTTP responses during graceful shutdown
+     * The path to skip. Can be a string or a regex.
      */
-    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;
-        };
+    path?: string;
+    /**
+     * HTTP method to skip
+     */
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
     [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;
-      };
-  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;
-      };
-  management?:
-    | boolean
-    | {
-        enabled?: boolean;
-        operations?: string[];
-      };
-  metrics?:
-    | boolean
+  }[];
+  exporter?:
     | {
-        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;
+        type?: "console" | "otlp" | "zipkin" | "memory" | "file";
         /**
-         * Configuration for exporting metrics to an OTLP endpoint
+         * Options for the exporter. These are passed directly to the exporter.
          */
-        otlpExporter?: {
-          /**
-           * Enable or disable OTLP metrics export
-           */
-          enabled?: boolean | string;
-          /**
-           * OTLP endpoint URL (e.g., http://collector:4318/v1/metrics)
-           */
-          endpoint: string;
+        options?: {
           /**
-           * Interval in milliseconds between metric pushes
+           * The URL to send the traces to. Not used for console or memory exporters.
            */
-          interval?: number | string;
+          url?: string;
           /**
-           * Additional HTTP headers for authentication
+           * Headers to send to the exporter. Not used for console or memory exporters.
            */
           headers?: {
-            [k: string]: string;
+            [k: string]: unknown;
           };
           /**
-           * 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
+           * The path to write the traces to. Only for file exporter.
            */
-          enabled?: boolean | string;
+          path?: string;
           /**
-           * OTLP metrics endpoint URL (e.g., http://collector:4318/v1/metrics)
+           * The OTLP transport protocol to use. Only for the otlp exporter. Defaults to http.
            */
-          endpoint: string;
+          protocol?: "http" | "grpc";
           /**
-           * Interval in milliseconds between metric forwards
+           * Alias for protocol. Only for the otlp exporter. Defaults to http.
            */
-          interval?: number | string;
-          /**
-           * Additional HTTP headers for authentication
-           */
-          headers?: {
-            [k: string]: string;
-          };
+          transport?: "http" | "grpc";
+          [k: string]: unknown;
         };
+        additionalProperties?: never;
+        [k: string]: unknown;
+      }[]
+    | {
+        type?: "console" | "otlp" | "zipkin" | "memory" | "file";
         /**
-         * Custom labels to add to HTTP metrics (http_request_all_duration_seconds). Each label extracts its value from an HTTP request header.
+         * Options for the exporter. These are passed directly to the exporter.
          */
-        httpCustomLabels?: {
+        options?: {
           /**
-           * The label name to use in metrics
+           * The URL to send the traces to. Not used for console or memory exporters.
            */
-          name: string;
+          url?: string;
           /**
-           * The HTTP request header to extract the value from
+           * Headers to send to the exporter. Not used for console or memory exporters.
            */
-          header: string;
+          headers?: {
+            [k: string]: unknown;
+          };
           /**
-           * Default value when header is missing (defaults to "unknown")
+           * The path to write the traces to. Only for file exporter.
            */
-          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";
+          path?: string;
           /**
-           * Options for the exporter. These are passed directly to the exporter.
+           * The OTLP transport protocol to use. Only for the otlp exporter. Defaults to http.
            */
-          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";
+          protocol?: "http" | "grpc";
           /**
-           * Options for the exporter. These are passed directly to the exporter.
+           * Alias for protocol. Only for the otlp exporter. Defaults to http.
            */
-          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;
+          transport?: "http" | "grpc";
           [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;
-  };
-  verticalScaler?: {
-    enabled?: boolean;
-    maxTotalWorkers?: number;
-    maxTotalMemory?: number;
-    minWorkers?: number;
-    maxWorkers?: number;
-    cooldownSec?: number;
-    gracePeriod?: number;
-    scaleUpELU?: number;
-    scaleDownELU?: number;
-    /**
-     * @deprecated
-     */
-    timeWindowSec?: number;
-    /**
-     * @deprecated
-     */
-    scaleDownTimeWindowSec?: number;
-    /**
-     * @deprecated
-     */
-    scaleIntervalSec?: number;
-    applications?: {
-      [k: string]: {
-        minWorkers?: number;
-        maxWorkers?: number;
-        scaleUpELU?: number;
-        scaleDownELU?: number;
+        additionalProperties?: never;
+        [k: string]: unknown;
       };
-    };
-  };
-  inspectorOptions?: {
-    host?: string;
-    port?: number;
-    breakFirstLine?: boolean;
-    watchDisabled?: boolean;
-    [k: string]: unknown;
-  };
-  applicationTimeout?: number | string;
-  startupConcurrency?: number | string;
-  messagingTimeout?: number | string;
-  resolvedApplicationsBasePath?: string;
-  env?: {
-    [k: string]: string;
-  };
-  envfile?: string;
   /**
-   * When set to true, the configuration loading fails if a {PLT_*} placeholder references an environment variable which is not set. When set to "warn", a warning listing the missing variables is logged but the placeholders are still replaced with an empty string. Defaults to false.
+   * Enable the OpenTelemetry diagnostic logger. Diagnostic messages are forwarded to the Platformatic global logger using the current logger level.
    */
-  strictEnv?: boolean | string;
-  sourceMaps?: boolean;
-  nodeModulesSourceMaps?: string[];
-  scheduler?: {
-    enabled?: boolean | string;
-    name: string;
-    cron: string;
-    callbackUrl: string;
-    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-    headers?: {
-      [k: string]: string;
-    };
-    body?:
-      | string
-      | {
-          [k: string]: unknown;
-        };
-    maxRetries?: number;
-    [k: string]: unknown;
-  }[];
-  policies?: {
-    deny: {
-      /**
-       * This interface was referenced by `undefined`'s JSON-Schema definition
-       * via the `patternProperty` "^.*$".
-       */
-      [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;
-      };
-  module?: string;
-};
+  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;
+  /**
+   * Wait for the first worker to start before starting the remaining workers
+   */
+  awaitFirstWorker?: boolean;
+}