@iskra-bun/core 0.1.1 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { Emitter } from 'mitt';
 import pino, { Logger as Logger$1 } from 'pino';
+import { Attributes, Tracer } from '@opentelemetry/api';
 import { z } from 'zod';
 
 declare const createLogger: (name: string, level?: string) => pino.Logger<never, boolean>;
@@ -15,16 +16,39 @@ interface Plugin {
     name: string;
     install(app: App): Promise<void> | void;
 }
-interface Context<T = any> {
+/** What an `app.on()` handler receives; `payload` is the emitted value. */
+interface Context<T = unknown> {
     app: App;
     logger: Logger$1;
     payload: T;
-    reply(data: any): void;
+    /** Emits `<event>:reply` with `data`. */
+    reply(data: unknown): void;
+}
+/**
+ * What each kit shares through `app.context`, by key, so `app.context.get('db')`
+ * is typed. Kits add their keys with declaration merging, and so can an app:
+ *
+ * ```ts
+ * declare module '@iskra-bun/core' {
+ *     interface AppContextRegistry {
+ *         bridge: DesktopBridge;
+ *     }
+ * }
+ * ```
+ */
+interface AppContextRegistry {
+}
+/**
+ * The payload of each app event, by name, so `app.on('process:exit', ...)`
+ * and `app.emit(...)` are typed. Kits add their events with declaration
+ * merging, and so can an app (as with AppContextRegistry).
+ */
+interface AppEvents {
 }
 interface OtelConfig {
     /** Defaults to true when otel config is present */
     enabled?: boolean;
-    /** OTLP endpoint URL. Defaults to http://localhost:4318 */
+    /** OTLP endpoint URL. Defaults to http://localhost:4318; use https:// for a collector on another host. */
     endpoint?: string;
     /** Overrides app name for the service.name resource attribute */
     serviceName?: string;
@@ -36,9 +60,16 @@ interface OtelConfig {
     metricIntervalMs?: number;
     /** Additional resource attributes */
     resourceAttributes?: Record<string, string>;
-    /** Auto-instrumentation overrides (passed to getNodeAutoInstrumentations) */
+    /**
+     * Options of each auto-instrumentation, by package name, passed to
+     * getNodeAutoInstrumentations(): `{ enabled: false }`, or its own options
+     * (`'@opentelemetry/instrumentation-http': { ignoreIncomingRequestHook,
+     * redactedQueryParams }`). The HTTP one redacts SECRET_QUERY_PARAMS in
+     * exported URLs unless `redactedQueryParams` says otherwise.
+     */
     instrumentations?: Record<string, {
         enabled?: boolean;
+        [option: string]: unknown;
     }>;
 }
 interface AppConfig {
@@ -48,6 +79,13 @@ interface AppConfig {
         level?: string;
     };
     otel?: OtelConfig;
+    /**
+     * Signals that trigger a graceful `stop()` and exit. Default
+     * `['SIGTERM', 'SIGINT']` (none under NODE_ENV=test); `false` disables.
+     */
+    shutdownSignals?: string[] | false;
+    /** Max time for a signal-triggered stop before forcing exit(1). Default 10000. */
+    shutdownTimeoutMs?: number;
     processes?: Record<string, ProcessConfig>;
     socket?: {
         enabled: boolean;
@@ -55,15 +93,17 @@ interface AppConfig {
         adapter?: 'bun' | 'socket.io';
     };
     kv?: {
-        driver: 'memory' | 'redis' | 'libsql';
-        connection?: any;
+        driver: 'memory' | 'redis';
+        /** Redis: a URL string, ioredis options, or ioredis options with `url`. */
+        connection?: string | Record<string, unknown>;
     };
     db?: {
         driver: 'postgres' | 'mysql' | 'sqlite' | 'libsql';
         url: string;
         authToken?: string;
     };
-    [key: string]: any;
+    /** Sections of other kits or of the app; read them with their own type. */
+    [key: string]: unknown;
 }
 interface RestartBackoffConfig {
     /** Initial delay in ms before the first restart. Default: 1000 */
@@ -80,25 +120,95 @@ interface ProcessConfig {
     restartOnCrash?: boolean;
     maxRestarts?: number;
     restartCooldown?: number;
+    /** Variables set for the child, over the ones it inherits (see `inheritEnv`). */
     env?: Record<string, string>;
+    /**
+     * Which of the app's environment variables the child inherits. Default
+     * `false`: a minimal set without secrets (PATH, HOME, locale, TZ, temp
+     * dir, NODE_ENV…). A list adds those names to it; `true` passes them all
+     * (DATABASE_URL, AUTH_SECRET, cloud keys…).
+     */
+    inheritEnv?: boolean | string[];
+    /**
+     * `stdio` mode: bytes `send()` lets wait for a child that is not reading
+     * its stdin; past this it refuses messages (returns false). Default 8 MiB.
+     */
+    maxPendingStdinBytes?: number;
     /** Exponential backoff settings for restarts. Defaults to 1000 ms flat (no backoff). */
     restartBackoff?: RestartBackoffConfig;
 }
 
+/**
+ * `app.context`: a Map whose keys in AppContextRegistry (`'db'`, `'kv'`, …)
+ * are typed; any other key holds `unknown`, or the type given as `T`.
+ */
+declare class AppContext extends Map<string, unknown> {
+    get<K extends keyof AppContextRegistry>(key: K): AppContextRegistry[K] | undefined;
+    get<T = unknown>(key: string): T | undefined;
+    set<K extends keyof AppContextRegistry>(key: K, value: AppContextRegistry[K]): this;
+    set(key: string, value: unknown): this;
+}
 declare class App {
     config: AppConfig;
     logger: Logger;
-    events: Emitter<any>;
+    events: Emitter<Record<string, unknown>>;
     private drivers;
-    context: Map<string, any>;
+    /** Drivers whose start() succeeded, in start order; null until start() runs. */
+    private startedDrivers;
+    private pendingInstalls;
+    /** The shutdown in progress, shared by concurrent stop() calls. */
+    private stopping;
+    private signalHandler?;
+    private signals;
+    context: AppContext;
     constructor(config?: AppConfig);
     init(): Promise<void>;
     register(driver: Driver): this;
     use(plugin: Plugin): this;
-    on(event: string, handler: (ctx: Context) => Promise<void> | void): this;
-    emit(event: string, payload: any): void;
+    /**
+     * Runs `handler` for every `event`. Events in AppEvents give the handler a
+     * typed payload; for others it is `unknown`, or the type given as `T`.
+     */
+    on<K extends keyof AppEvents>(event: K, handler: (ctx: Context<AppEvents[K]>) => Promise<void> | void): this;
+    on<T = unknown>(event: string, handler: (ctx: Context<T>) => Promise<void> | void): this;
+    /** Emits `event`; for events in AppEvents the payload must match their type. */
+    emit<K extends keyof AppEvents>(event: K, payload: AppEvents[K]): void;
+    emit(event: string, payload?: unknown): void;
+    /**
+     * Starts drivers one at a time, in registration order, so a driver can rely
+     * on the ones registered before it (e.g. the DB before the web server). If
+     * one fails, every driver is stopped in reverse order (all were initialized
+     * and may hold connections, including the failing one), OpenTelemetry is
+     * shut down and the error is rethrown, instead of leaving ports bound and
+     * children running.
+     */
     start(): Promise<void>;
+    /**
+     * Stops drivers in reverse start order (the web server before the DB it
+     * uses), continuing past failures, and always flushes OpenTelemetry.
+     *
+     * A call made while a stop is in progress (e.g. an app's own signal
+     * handler next to the App's) gets that same stop: it resolves only once
+     * every driver has stopped, instead of right away with nothing left to do.
+     */
     stop(): Promise<void>;
+    private stopOnce;
+    /**
+     * Stops `drivers` after a failed init() or start() and shuts down
+     * OpenTelemetry. Failures to stop are logged, not thrown: the caller
+     * rethrows the original error. A later stop() stops nothing more.
+     */
+    private rollback;
+    private stopDrivers;
+    /**
+     * Stops the app gracefully on SIGTERM/SIGINT (configurable with
+     * `shutdownSignals`, off by default under NODE_ENV=test). Once a listener
+     * exists the runtime no longer exits on its own, so the handler exits with
+     * 0 after a clean stop, or 1 on failure / after `shutdownTimeoutMs`. A
+     * second signal forces exit.
+     */
+    private installSignalHandlers;
+    private removeSignalHandlers;
 }
 
 declare const ErrorCodes: {
@@ -118,8 +228,14 @@ declare const ErrorCodes: {
     readonly UNAUTHORIZED: "UNAUTHORIZED";
     readonly FORBIDDEN: "FORBIDDEN";
     readonly NOT_FOUND: "NOT_FOUND";
+    readonly METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED";
     readonly CONFLICT: "CONFLICT";
+    readonly PAYLOAD_TOO_LARGE: "PAYLOAD_TOO_LARGE";
+    readonly UNSUPPORTED_MEDIA_TYPE: "UNSUPPORTED_MEDIA_TYPE";
     readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    readonly TIMEOUT: "TIMEOUT";
     readonly DATABASE_ERROR: "DATABASE_ERROR";
     readonly CONNECTION_ERROR: "CONNECTION_ERROR";
     readonly QUERY_ERROR: "QUERY_ERROR";
@@ -133,7 +249,22 @@ declare const ErrorCodes: {
     readonly SOCKET_CONNECTION_ERROR: "SOCKET_CONNECTION_ERROR";
     readonly SOCKET_MESSAGE_ERROR: "SOCKET_MESSAGE_ERROR";
 };
-type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+/**
+ * Every error code, as keys: Iskra's own (`ErrorCodes`) and the ones an app
+ * adds by merging into this interface, which `ErrorCode` then accepts:
+ *
+ * ```ts
+ * declare module '@iskra-bun/core' {
+ *     interface ErrorCodeRegistry {
+ *         ORDER_LOCKED: true;
+ *     }
+ * }
+ * throw new HttpError(423, 'The order is being edited', { code: 'ORDER_LOCKED' });
+ * ```
+ */
+interface ErrorCodeRegistry extends Record<(typeof ErrorCodes)[keyof typeof ErrorCodes], true> {
+}
+type ErrorCode = keyof ErrorCodeRegistry & string;
 interface IskraErrorOptions {
     code: ErrorCode;
     cause?: Error;
@@ -197,6 +328,47 @@ declare class LifecycleError extends IskraError {
  * actionable error instead of an unhandled module-resolution failure.
  */
 
+/** `@opentelemetry/resources`: 2.x exports resourceFromAttributes(), 1.x the Resource class. */
+interface OtelResourcesModule {
+    resourceFromAttributes?: (attributes: Record<string, string>) => unknown;
+    Resource?: new (attributes: Record<string, string>) => unknown;
+}
+/**
+ * Query parameters whose values are exported as REDACTED in span URLs (see
+ * redactUrl). Names are compared without case, `-` or `_`.
+ */
+declare const SECRET_QUERY_PARAMS: readonly string[];
+/**
+ * `url` (absolute, or a path) with the value of each query parameter named in
+ * `params` replaced by REDACTED, the rest kept as it was. Telemetry exported
+ * URLs as they were requested: `?api_key=`, `?access_token=`, a presigned
+ * URL's signature.
+ */
+declare function redactUrl(url: string, params?: readonly string[]): string;
+/**
+ * The options initOtel() passes to getNodeAutoInstrumentations(): the app's
+ * `instrumentations` over Iskra's defaults. The HTTP instrumentation redacts
+ * SECRET_QUERY_PARAMS unless `redactedQueryParams` / `redactedQueryParamsServer`
+ * are set (instrumentation-http 0.204 / 0.222 and later apply them itself;
+ * for older releases a requestHook rewrites the span's URL attributes, before
+ * the app's own requestHook runs).
+ */
+declare function autoInstrumentationOptions(config: OtelConfig): Record<string, unknown>;
+/**
+ * The OTLP endpoint as it is safe to log, its origin (the path, query or
+ * userinfo can carry an API key), and whether spans travel to it in clear
+ * text beyond this machine and its private network.
+ */
+declare function describeOtelEndpoint(config: OtelConfig): {
+    origin: string;
+    plaintext: boolean;
+};
+/**
+ * Builds a Resource with whichever API the installed `@opentelemetry/resources`
+ * provides: 2.x only exports `resourceFromAttributes()` (`Resource` is a type
+ * there, so `new Resource()` throws), 1.x exports the `Resource` class.
+ */
+declare function createResource(resources: OtelResourcesModule, attributes: Record<string, string>): unknown;
 /**
  * Initialize the OpenTelemetry NodeSDK with OTLP exporters.
  * Must be called before any drivers start so auto-instrumentation can patch libraries.
@@ -207,6 +379,41 @@ declare function initOtel(config: OtelConfig, appName: string): Promise<void>;
  */
 declare function shutdownOtel(): Promise<void>;
 
+interface TracedOptions {
+    /** Attributes of every span. */
+    attributes?: Attributes;
+    /** The tracer; default the global provider's `iskra` tracer (no spans without an OpenTelemetry SDK). */
+    tracer?: Tracer;
+}
+/**
+ * Wraps `fn` in a span named `name`, by convention `layer.domain.method`
+ * (`repo.usuarios.buscar`): the span is the active one while `fn` runs, so
+ * the spans started inside (a query, a call to another service) are its
+ * children; a throw or a rejection marks it as an error. Without an
+ * OpenTelemetry SDK it costs a no-op span.
+ *
+ * ```ts
+ * const buscar = traced('repo.usuarios.buscar', async (id: number) => oracle.one(SQL, { id }));
+ * ```
+ */
+declare function traced<A extends unknown[], R>(name: string, fn: (...args: A) => R, options?: TracedOptions): (...args: A) => R;
+
+/** `NODE_ENV` as the process runs with it, or undefined when unset or empty. */
+declare function nodeEnv(): string | undefined;
+/**
+ * Whether development conveniences apply (pretty logs, http auth URLs, sample
+ * secrets, `disableCSRFCheck`): only with `NODE_ENV` set to `development` or
+ * `test`.
+ */
+declare function isDevelopmentEnv(env?: string | undefined): boolean;
+/**
+ * Whether production safeguards apply: in every environment but `development`
+ * and `test`, including an unset NODE_ENV and names like `staging`. They used
+ * to apply only to NODE_ENV=production exactly, so a deploy that forgot it
+ * sent non-Secure cookies and accepted placeholder secrets.
+ */
+declare function isProductionEnv(env?: string | undefined): boolean;
+
 declare function loadAppConfig(cwd?: string): Promise<AppConfig>;
 
 declare const AppConfigSchema: z.ZodObject<{
@@ -214,11 +421,11 @@ declare const AppConfigSchema: z.ZodObject<{
     debug: z.ZodDefault<z.ZodBoolean>;
     logger: z.ZodDefault<z.ZodObject<{
         level: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        level: string;
-    }, {
-        level?: string | undefined;
-    }>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        level: z.ZodDefault<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        level: z.ZodDefault<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
     otel: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         endpoint: z.ZodDefault<z.ZodString>;
@@ -229,105 +436,480 @@ declare const AppConfigSchema: z.ZodObject<{
         resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    shutdownSignals: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodLiteral<false>]>>;
+    shutdownTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    processes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            enabled?: boolean | undefined;
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
         }, {
-            enabled?: boolean | undefined;
-        }>>>;
-    }, "strip", z.ZodTypeAny, {
-        enabled: boolean;
-        endpoint: string;
-        serviceVersion: string;
-        metricIntervalMs: number;
-        serviceName?: string | undefined;
-        environment?: string | undefined;
-        resourceAttributes?: Record<string, string> | undefined;
-        instrumentations?: Record<string, {
-            enabled?: boolean | undefined;
-        }> | undefined;
-    }, {
-        enabled?: boolean | undefined;
-        endpoint?: string | undefined;
-        serviceName?: string | undefined;
-        serviceVersion?: string | undefined;
-        environment?: string | undefined;
-        metricIntervalMs?: number | undefined;
-        resourceAttributes?: Record<string, string> | undefined;
-        instrumentations?: Record<string, {
-            enabled?: boolean | undefined;
-        }> | undefined;
-    }>>;
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    socket: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    kv: z.ZodOptional<z.ZodObject<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    db: z.ZodOptional<z.ZodObject<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name: z.ZodDefault<z.ZodString>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+    logger: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        level: z.ZodDefault<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        level: z.ZodDefault<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    otel: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    shutdownSignals: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodLiteral<false>]>>;
+    shutdownTimeoutMs: z.ZodOptional<z.ZodNumber>;
     processes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         command: z.ZodString;
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
         restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        command: string;
-        mode: "daemon" | "oneshot" | "stdio";
-        restartOnCrash: boolean;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-    }, {
-        command: string;
-        args?: string[] | undefined;
-        mode?: "daemon" | "oneshot" | "stdio" | undefined;
-        restartOnCrash?: boolean | undefined;
-        env?: Record<string, string> | undefined;
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    debug: boolean;
-    name: string;
-    logger: {
-        level: string;
-    };
-    otel?: {
-        enabled: boolean;
-        endpoint: string;
-        serviceVersion: string;
-        metricIntervalMs: number;
-        serviceName?: string | undefined;
-        environment?: string | undefined;
-        resourceAttributes?: Record<string, string> | undefined;
-        instrumentations?: Record<string, {
-            enabled?: boolean | undefined;
-        }> | undefined;
-    } | undefined;
-    processes?: Record<string, {
-        command: string;
-        mode: "daemon" | "oneshot" | "stdio";
-        restartOnCrash: boolean;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-    }> | undefined;
-}, {
-    debug?: boolean | undefined;
-    name?: string | undefined;
-    logger?: {
-        level?: string | undefined;
-    } | undefined;
-    otel?: {
-        enabled?: boolean | undefined;
-        endpoint?: string | undefined;
-        serviceName?: string | undefined;
-        serviceVersion?: string | undefined;
-        environment?: string | undefined;
-        metricIntervalMs?: number | undefined;
-        resourceAttributes?: Record<string, string> | undefined;
-        instrumentations?: Record<string, {
-            enabled?: boolean | undefined;
-        }> | undefined;
-    } | undefined;
-    processes?: Record<string, {
-        command: string;
-        args?: string[] | undefined;
-        mode?: "daemon" | "oneshot" | "stdio" | undefined;
-        restartOnCrash?: boolean | undefined;
-        env?: Record<string, string> | undefined;
-    }> | undefined;
-}>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    socket: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    kv: z.ZodOptional<z.ZodObject<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    db: z.ZodOptional<z.ZodObject<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name: z.ZodDefault<z.ZodString>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+    logger: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        level: z.ZodDefault<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        level: z.ZodDefault<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    otel: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        endpoint: z.ZodDefault<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        serviceVersion: z.ZodDefault<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        metricIntervalMs: z.ZodDefault<z.ZodNumber>;
+        resourceAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        instrumentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    shutdownSignals: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodLiteral<false>]>>;
+    shutdownTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    processes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["daemon", "oneshot", "stdio"]>>;
+        restartOnCrash: z.ZodDefault<z.ZodBoolean>;
+        maxRestarts: z.ZodOptional<z.ZodNumber>;
+        restartCooldown: z.ZodOptional<z.ZodNumber>;
+        restartBackoff: z.ZodOptional<z.ZodObject<{
+            initialMs: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            initialMs?: number | undefined;
+            maxMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inheritEnv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
+        maxPendingStdinBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    socket: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        enabled: z.ZodBoolean;
+        port: z.ZodOptional<z.ZodNumber>;
+        adapter: z.ZodOptional<z.ZodEnum<["bun", "socket.io"]>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    kv: z.ZodOptional<z.ZodObject<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        driver: z.ZodEnum<["memory", "redis"]>;
+        connection: z.ZodOptional<z.ZodAny>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    db: z.ZodOptional<z.ZodObject<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        driver: z.ZodEnum<["postgres", "mysql", "sqlite", "libsql"]>;
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">>;
 type AppConfigInput = z.input<typeof AppConfigSchema>;
 type AppConfigOutput = z.output<typeof AppConfigSchema>;
 
-export { App, type AppConfig, type AppConfigInput, type AppConfigOutput, AppConfigSchema, ConfigError, type Context, type Driver, DriverError, type ErrorCode, ErrorCodes, IskraError, type IskraErrorOptions, LifecycleError, type Logger, type OtelConfig, type Plugin, PluginError, type ProcessConfig, type RestartBackoffConfig, createLogger, initOtel, loadAppConfig, shutdownOtel };
+export { App, type AppConfig, type AppConfigInput, type AppConfigOutput, AppConfigSchema, AppContext, type AppContextRegistry, type AppEvents, ConfigError, type Context, type Driver, DriverError, type ErrorCode, type ErrorCodeRegistry, ErrorCodes, IskraError, type IskraErrorOptions, LifecycleError, type Logger, type OtelConfig, type OtelResourcesModule, type Plugin, PluginError, type ProcessConfig, type RestartBackoffConfig, SECRET_QUERY_PARAMS, type TracedOptions, autoInstrumentationOptions, createLogger, createResource, describeOtelEndpoint, initOtel, isDevelopmentEnv, isProductionEnv, loadAppConfig, nodeEnv, redactUrl, shutdownOtel, traced };