@bleedingdev/modern-js-server-core 3.8.3-ultramodern.6 → 3.9.0-ultramodern.10

package/dist/esm-node/adapters/node/plugins/staticServing.mjs

@@ -1,153 +0,0 @@
-import "node:module";
-import { fileReader } from "@modern-js/runtime-utils/fileReader";
-import { fs } from "@modern-js/utils";
-import { getMimeType } from "hono/utils/mime";
-import path from "path";
-import { applyModuleFederationAssetHeaders, getModuleFederationAssetList, getModuleFederationRequestPath, isBackendModuleFederationManifestRequest, isModuleFederationManifestRequest, patchModuleFederationManifestPublicPath, patchModuleFederationRemoteEntryPublicPath } from "./staticModuleFederation.mjs";
-import { applyPreCompressedAssetHeaders, resolvePreCompressedAsset } from "./staticPrecompressed.mjs";
-const MODULE_FEDERATION_ASSET_REFRESH_INTERVAL_MS = 1000;
-const getStaticMimeType = (filename)=>getMimeType(filename) ?? ('.cjs' === path.extname(filename).toLowerCase() ? "text/javascript; charset=UTF-8" : void 0);
-const servePreCompressedPublicRouteAsset = async (c, pwd, route)=>{
-    const { entryPath } = route;
-    const originFilename = path.join(pwd, entryPath);
-    const preCompressedAsset = await resolvePreCompressedAsset(c, originFilename);
-    if (!preCompressedAsset.acceptable) {
-        applyPreCompressedAssetHeaders(c, preCompressedAsset);
-        return c.body(null, 406);
-    }
-    const filename = preCompressedAsset.selected?.filepath ?? originFilename;
-    const data = await fileReader.readFile(filename, 'buffer');
-    const mimeType = getStaticMimeType(originFilename);
-    if (null === data) return null;
-    const body = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-    if (mimeType) c.header('Content-Type', mimeType);
-    Object.entries(route.responseHeaders || {}).forEach(([k, v])=>{
-        c.header(k, v);
-    });
-    applyPreCompressedAssetHeaders(c, preCompressedAsset);
-    c.header('Content-Length', String(data.byteLength));
-    return c.body(body, 200);
-};
-const isPathInside = (target, root)=>{
-    const relative = path.relative(path.resolve(root), path.resolve(target));
-    return '' === relative || !relative.startsWith(`..${path.sep}`) && '..' !== relative && !path.isAbsolute(relative);
-};
-const resolvePublicDirectoryAsset = async (pwd, pathname)=>{
-    let decodedPathname;
-    try {
-        decodedPathname = decodeURIComponent(pathname).replace(/\\/gu, '/');
-    } catch  {
-        return null;
-    }
-    if (decodedPathname.includes('\0') || decodedPathname.split('/').includes('..')) return null;
-    const publicDirectory = path.join(pwd, 'public');
-    const filepath = path.resolve(publicDirectory, decodedPathname.replace(/^\/+/u, ''));
-    if (!isPathInside(filepath, publicDirectory)) return null;
-    try {
-        const [realPublicDirectory, realFilepath, stat] = await Promise.all([
-            fs.realpath(publicDirectory),
-            fs.realpath(filepath),
-            fs.stat(filepath)
-        ]);
-        if (!stat.isFile() || !isPathInside(realFilepath, realPublicDirectory)) return null;
-        return realFilepath;
-    } catch  {
-        return null;
-    }
-};
-const servePublicDirectoryAsset = async (c, pwd)=>{
-    const method = c.req.raw.method.toUpperCase();
-    if ('GET' !== method && 'HEAD' !== method) return null;
-    const originFilename = await resolvePublicDirectoryAsset(pwd, c.req.path);
-    if (null === originFilename) return null;
-    const preCompressedAsset = await resolvePreCompressedAsset(c, originFilename);
-    if (!preCompressedAsset.acceptable) {
-        applyPreCompressedAssetHeaders(c, preCompressedAsset);
-        return c.body(null, 406);
-    }
-    const selectedFilename = preCompressedAsset.selected?.filepath ?? originFilename;
-    const publicDirectory = await fs.realpath(path.join(pwd, 'public'));
-    let realSelectedFilename;
-    try {
-        realSelectedFilename = await fs.realpath(selectedFilename);
-    } catch  {
-        return null;
-    }
-    if (!isPathInside(realSelectedFilename, publicDirectory)) return null;
-    const data = await fileReader.readFileFromSystem(realSelectedFilename, 'buffer');
-    if (null === data) return null;
-    const mimeType = getStaticMimeType(originFilename);
-    if (mimeType) c.header('Content-Type', mimeType);
-    applyPreCompressedAssetHeaders(c, preCompressedAsset);
-    c.header('Content-Length', String(data.byteLength));
-    if ('HEAD' === method) return c.body(null, 200);
-    const body = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-    return c.body(body, 200);
-};
-const createModuleFederationStaticServing = ({ pwd, pathPrefix })=>{
-    let moduleFederationAssets = null;
-    let moduleFederationAssetsExpiresAt = 0;
-    let moduleFederationAssetsRefresh = null;
-    const getModuleFederationAssets = async ()=>{
-        if (moduleFederationAssets && Date.now() < moduleFederationAssetsExpiresAt) return moduleFederationAssets;
-        if (!moduleFederationAssetsRefresh) moduleFederationAssetsRefresh = getModuleFederationAssetList(pwd).then((assets)=>{
-            moduleFederationAssets = assets;
-            moduleFederationAssetsExpiresAt = Date.now() + MODULE_FEDERATION_ASSET_REFRESH_INTERVAL_MS;
-            return assets;
-        }).finally(()=>{
-            moduleFederationAssetsRefresh = null;
-        });
-        return moduleFederationAssetsRefresh;
-    };
-    const resolveRequest = async (pathname)=>{
-        const requestPath = getModuleFederationRequestPath(pathname, pathPrefix);
-        if (requestPath.includes('..')) return null;
-        const moduleFederationAssetMeta = await getModuleFederationAssets();
-        return {
-            requestPath,
-            isModuleFederationAsset: moduleFederationAssetMeta.assets.has(requestPath),
-            isModuleFederationRemoteEntry: moduleFederationAssetMeta.remoteEntries.has(requestPath)
-        };
-    };
-    const serveFile = async (c, filepath, moduleFederationAsset = false, moduleFederationRemoteEntry = false, requestPath = '')=>{
-        if (moduleFederationAsset) applyModuleFederationAssetHeaders(c);
-        const mimeType = getStaticMimeType(filepath);
-        if (mimeType) c.header('Content-Type', mimeType);
-        const shouldPatchManifest = moduleFederationAsset && isModuleFederationManifestRequest(requestPath) && !isBackendModuleFederationManifestRequest(requestPath);
-        const shouldPatchRemoteEntry = moduleFederationRemoteEntry;
-        const canUsePreCompressed = !shouldPatchManifest && !shouldPatchRemoteEntry;
-        const preCompressedAsset = canUsePreCompressed ? await resolvePreCompressedAsset(c, filepath) : {
-            selected: null,
-            hasVariant: false,
-            acceptable: true
-        };
-        if (!preCompressedAsset.acceptable) {
-            applyPreCompressedAssetHeaders(c, preCompressedAsset);
-            return c.body(null, 406);
-        }
-        const targetFilepath = preCompressedAsset.selected?.filepath ?? filepath;
-        const chunk = await fileReader.readFileFromSystem(targetFilepath, 'buffer');
-        if (null === chunk) return null;
-        const responseChunk = shouldPatchManifest ? patchModuleFederationManifestPublicPath(c, chunk, pathPrefix) : shouldPatchRemoteEntry ? patchModuleFederationRemoteEntryPublicPath(c, chunk, pathPrefix) : chunk;
-        applyPreCompressedAssetHeaders(c, preCompressedAsset);
-        c.header('Content-Length', String(responseChunk.byteLength));
-        const body = new Uint8Array(responseChunk.buffer, responseChunk.byteOffset, responseChunk.byteLength);
-        return c.body(body, 200);
-    };
-    const serveByPath = async (c, filepath, request, moduleFederationAsset = false, moduleFederationRemoteEntry = false)=>{
-        if (!isPathInside(filepath, pwd)) return null;
-        if (!await fs.pathExists(filepath)) return null;
-        return serveFile(c, filepath, moduleFederationAsset, moduleFederationRemoteEntry, request.requestPath);
-    };
-    const serveStaticHit = (c, request)=>serveByPath(c, path.join(pwd, request.requestPath), request, request.isModuleFederationAsset, request.isModuleFederationRemoteEntry);
-    const serveModuleFederationAsset = (c, request)=>{
-        if (!request.isModuleFederationAsset) return null;
-        return serveByPath(c, path.join(pwd, request.requestPath), request, true, request.isModuleFederationRemoteEntry);
-    };
-    return {
-        resolveRequest,
-        serveStaticHit,
-        serveModuleFederationAsset
-    };
-};
-export { createModuleFederationStaticServing, servePreCompressedPublicRouteAsset, servePublicDirectoryAsset };

package/dist/esm-node/types/config/bffRuntime.mjs

@@ -1 +0,0 @@
-import "node:module";

package/dist/esm-node/types/config/serverTelemetry.mjs

@@ -1 +0,0 @@
-import "node:module";

package/dist/types/adapters/node/plugins/staticModuleFederation.d.ts

@@ -1,13 +0,0 @@
-import type { Middleware } from '../../../types';
-export declare const MODULE_FEDERATION_MANIFEST_FILE = "mf-manifest.json";
-export type ModuleFederationServeAssets = {
-    assets: Set<string>;
-    remoteEntries: Set<string>;
-};
-export declare const getModuleFederationRequestPath: (pathname: string, pathPrefix: string) => string;
-export declare const isModuleFederationManifestRequest: (requestPath: string) => boolean;
-export declare const isBackendModuleFederationManifestRequest: (requestPath: string) => requestPath is "backend-mf-manifest.json";
-export declare const applyModuleFederationAssetHeaders: (c: Parameters<Middleware>[0]) => void;
-export declare const patchModuleFederationManifestPublicPath: (c: Parameters<Middleware>[0], manifestBuffer: Buffer, pathPrefix: string) => Buffer<ArrayBufferLike>;
-export declare const patchModuleFederationRemoteEntryPublicPath: (c: Parameters<Middleware>[0], remoteEntryBuffer: Buffer, pathPrefix: string) => Buffer<ArrayBufferLike>;
-export declare const getModuleFederationAssetList: (pwd: string) => Promise<ModuleFederationServeAssets>;

package/dist/types/adapters/node/plugins/staticPrecompressed.d.ts

@@ -1,13 +0,0 @@
-import type { Middleware } from '../../../types';
-type SupportedEncoding = 'br' | 'gzip';
-type ResolvePreCompressedAssetResult = {
-    selected: {
-        filepath: string;
-        encoding: SupportedEncoding;
-    } | null;
-    hasVariant: boolean;
-    acceptable: boolean;
-};
-export declare const resolvePreCompressedAsset: (c: Parameters<Middleware>[0], filepath: string) => Promise<ResolvePreCompressedAssetResult>;
-export declare const applyPreCompressedAssetHeaders: (c: Parameters<Middleware>[0], preCompressedAsset: ResolvePreCompressedAssetResult) => void;
-export {};

package/dist/types/adapters/node/plugins/staticServing.d.ts

@@ -1,25 +0,0 @@
-import type { ServerRoute } from '@modern-js/types';
-import type { Middleware } from '../../../types';
-type MiddlewareContext = Parameters<Middleware>[0];
-type StaticServingRequest = {
-    requestPath: string;
-    isModuleFederationAsset: boolean;
-    isModuleFederationRemoteEntry: boolean;
-};
-type StaticServingOptions = {
-    pwd: string;
-    pathPrefix: string;
-};
-export declare const servePreCompressedPublicRouteAsset: (c: MiddlewareContext, pwd: string, route: ServerRoute) => Promise<(Response & import("hono").TypedResponse<null, 406, "body">) | (Response & import("hono").TypedResponse<Uint8Array<ArrayBuffer>, 200, "body">) | null>;
-/**
- * Serves post-build convention assets generated under dist/public at their
- * root URL. This is intentionally independent of config/public and route.json:
- * the generator runs after the route manifest is built.
- */
-export declare const servePublicDirectoryAsset: (c: MiddlewareContext, pwd: string) => Promise<(Response & import("hono").TypedResponse<null, 200, "body">) | (Response & import("hono").TypedResponse<null, 406, "body">) | (Response & import("hono").TypedResponse<Uint8Array<ArrayBuffer>, 200, "body">) | null>;
-export declare const createModuleFederationStaticServing: ({ pwd, pathPrefix, }: StaticServingOptions) => {
-    resolveRequest: (pathname: string) => Promise<StaticServingRequest | null>;
-    serveStaticHit: (c: MiddlewareContext, request: StaticServingRequest) => Promise<(Response & import("hono").TypedResponse<null, 406, "body">) | (Response & import("hono").TypedResponse<Uint8Array<ArrayBuffer>, 200, "body">) | null>;
-    serveModuleFederationAsset: (c: MiddlewareContext, request: StaticServingRequest) => Promise<(Response & import("hono").TypedResponse<null, 406, "body">) | (Response & import("hono").TypedResponse<Uint8Array<ArrayBuffer>, 200, "body">) | null> | null;
-};
-export {};

package/dist/types/types/config/bffRuntime.d.ts

@@ -1,116 +0,0 @@
-export type BffRuntimeFramework = 'hono' | 'effect';
-export interface BffCrossProjectPolicyUserConfig {
-    /**
-     * Enable cross-project envelope and operation-context policy checks.
-     *
-     * @default false
-     */
-    enabled?: boolean;
-    /**
-     * Require cross-project envelope header when policy is enabled.
-     *
-     * @default true
-     */
-    requireEnvelope?: boolean;
-    /**
-     * Require operation-context header when policy is enabled.
-     *
-     * @default true
-     */
-    requireOperationContext?: boolean;
-    /**
-     * Require operation-context detail header carrying schema/version metadata.
-     *
-     * @default true
-     */
-    requireOperationContextDetails?: boolean;
-    /**
-     * Require operation schema hash in operation-context details.
-     *
-     * @default true
-     */
-    requireOperationSchemaHash?: boolean;
-    /**
-     * Require operation version in operation-context details.
-     *
-     * @default true
-     */
-    requireOperationVersion?: boolean;
-    /**
-     * Optional allowlist of producer namespaces derived from requestId.
-     */
-    allowedNamespaces?: string[];
-    /**
-     * Optional hook deriving a verified producer identity (namespace) from
-     * request headers, e.g. an mTLS subject or gateway-verified JWT claim.
-     * When provided, namespace checks bind to this verified value instead of
-     * the client-asserted requestId namespace; returning `undefined` denies
-     * the request. Without it the namespace checks are advisory only.
-     */
-    verifyProducerIdentity?: (headers: Record<string, unknown>) => string | undefined;
-    /**
-     * Optional operation-contract map keyed by:
-     * - `${METHOD}:${routePath}`
-     * - `operation:${requestId}:${operationId}`
-     */
-    expectedOperationContracts?: Record<string, {
-        schemaHash?: string;
-        operationVersion?: number;
-    }>;
-    /**
-     * Allow operations missing from expectedOperationContracts.
-     *
-     * @default false
-     */
-    allowUnknownOperations?: boolean;
-    /**
-     * HTTP status code used for denied requests.
-     *
-     * @default 403
-     */
-    denyStatus?: number;
-}
-export type BffEffectOpenApiUserConfig = boolean | {
-    path?: string;
-};
-export interface BffEffectDataPlatformSelectionUserConfig {
-    maxDepth?: number;
-    maxFields?: number;
-    allowedLeafPaths?: string[];
-}
-export interface BffEffectDataPlatformBatchUserConfig {
-    enabled?: boolean;
-    endpoint?: `/${string}`;
-    maxBatchSize?: number;
-    maxBatchBytes?: number;
-    flushIntervalMs?: number;
-    maxConcurrency?: number;
-    requestTimeoutMs?: number;
-    allowedMethods?: string[];
-}
-export interface BffEffectDataPlatformUserConfig {
-    enabled?: boolean;
-    requireEnvelope?: boolean;
-    envelopeHeader?: string;
-    expectedNamespace?: string;
-    validateOrigin?: boolean;
-    requireTraceContext?: boolean;
-    selection?: BffEffectDataPlatformSelectionUserConfig;
-    batch?: BffEffectDataPlatformBatchUserConfig;
-}
-export interface BffEffectUserConfig {
-    entry?: string;
-    /**
-     * Enforce Effect-native API/runtime modules instead of raw request handlers.
-     *
-     * When enabled, Effect API entries must export a `defineEffectBff(...)`
-     * definition or a `{ api, layer }` HttpApi module. Raw `handler` exports,
-     * default request handlers, and unbranded custom `createHandler` factories
-     * are treated as legacy escape hatches.
-     *
-     * @default true
-     */
-    strictEffectApproach?: true;
-    openapi?: BffEffectOpenApiUserConfig;
-    dataPlatform?: BffEffectDataPlatformUserConfig;
-}

package/dist/types/types/config/serverTelemetry.d.ts

@@ -1,319 +0,0 @@
-export interface ServerTelemetryExporterOptions {
-    enabled?: boolean;
-    endpoint?: string;
-    headers?: Record<string, string>;
-    timeoutMs?: number;
-}
-export interface ServerTelemetryVictoriaMetricsOptions extends ServerTelemetryExporterOptions {
-    metricPrefix?: string;
-}
-export interface ServerTelemetrySloUserConfig {
-    /**
-     * Queue utilization ratio threshold that emits SLO degradation alerts.
-     *
-     * @default 0.8
-     */
-    queueUtilizationWarnThreshold?: number;
-    /**
-     * Total dropped-envelope threshold that emits SLO degradation alerts.
-     *
-     * @default 1
-     */
-    queueDroppedWarnThreshold?: number;
-    /**
-     * Cooldown between SLO alert emissions for the same alert type.
-     *
-     * @default 60000
-     */
-    alertCooldownMs?: number;
-}
-export interface ServerTelemetryCanaryContractGateUserConfig {
-    /**
-     * Whether this contract gate currently passes.
-     */
-    passed: boolean;
-    /**
-     * Optional failure reason used for rollback diagnostics.
-     */
-    reason?: string;
-}
-export interface ServerTelemetryCanaryAutopilotUserConfig {
-    /**
-     * Enable automatic contract gate synchronization from a gate snapshot file.
-     *
-     * @default true
-     */
-    enabled?: boolean;
-    /**
-     * Path to contract gate snapshot JSON file.
-     *
-     * @default ".modern/contract-gates.json"
-     */
-    gateSnapshotPath?: string;
-    /**
-     * Poll interval for reading gate snapshot changes.
-     *
-     * @default 15000
-     */
-    pollIntervalMs?: number;
-    /**
-     * Marks gate entries as failed when they are older than this threshold.
-     *
-     * @default 600000
-     */
-    gateStaleAfterMs?: number;
-    /**
-     * Runtime MF fallback signal ingestion.
-     */
-    runtimeFallbackSignal?: ServerTelemetryCanaryRuntimeFallbackSignalUserConfig;
-    /**
-     * Optional pluggable state store backend for contract gate snapshots.
-     * When omitted, snapshots are read/written from gateSnapshotPath on local disk.
-     */
-    stateStore?: ServerTelemetryCanaryAutopilotStateStoreUserConfig;
-}
-export interface ServerTelemetryCanaryAutopilotStateStoreUserConfig {
-    /**
-     * Path or package name of a module that exports
-     * `createContractGateSnapshotStore(context)`.
-     */
-    module: string;
-    /**
-     * Optional adapter-specific configuration.
-     */
-    options?: Record<string, unknown>;
-}
-export interface ServerTelemetryCanaryRuntimeFallbackSignalUserConfig {
-    /**
-     * Enable runtime MF fallback signal ingestion endpoint.
-     *
-     * Opt-in: when enabled, `auth` must be configured with a token
-     * (`expectedValue` or `expectedValueEnv`) or server setup throws.
-     *
-     * @default false
-     */
-    enabled?: boolean;
-    /**
-     * HTTP endpoint path for runtime fallback events.
-     *
-     * @default "/_modern/contract-gates/runtime-fallback"
-     */
-    endpoint?: string;
-    /**
-     * Contract gate name updated by runtime fallback events.
-     *
-     * @default "runtime-mf-fallback-health"
-     */
-    gateName?: string;
-    /**
-     * How long a runtime fallback signal should hold gate failure status.
-     *
-     * @default 300000
-     */
-    failureHoldMs?: number;
-    /**
-     * Maximum accepted request body size in bytes.
-     *
-     * @default 16384
-     */
-    maxBodyBytes?: number;
-    /**
-     * Optional runtime trust policy for fallback signal ingestion.
-     * Use this to restrict who can mutate canary contract gates.
-     */
-    trustPolicy?: ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig;
-    /**
-     * Optional request authentication for runtime fallback signal endpoint.
-     */
-    auth?: ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig;
-}
-export interface ServerTelemetryCanaryRuntimeFallbackSignalAuthUserConfig {
-    /**
-     * Enable auth guard for runtime fallback signal endpoint.
-     *
-     * @default false
-     */
-    enabled?: boolean;
-    /**
-     * Header name carrying runtime fallback auth token.
-     *
-     * @default "x-modernjs-runtime-signal-token"
-     */
-    headerName?: string;
-    /**
-     * Expected token value. Prefer using expectedValueEnv in production.
-     */
-    expectedValue?: string;
-    /**
-     * Name of environment variable that stores expected token value.
-     */
-    expectedValueEnv?: string;
-}
-export interface ServerTelemetryCanaryRuntimeFallbackSignalTrustPolicyUserConfig {
-    /**
-     * Allowlist of app names accepted by runtime fallback signal endpoint.
-     * Empty means no app-name allowlist check.
-     */
-    allowedApps?: string[];
-    /**
-     * Allowlist of entry origins accepted by runtime fallback signal endpoint.
-     * Values should be URL origins (for example https://erp.example.com).
-     * Empty means no entry-origin allowlist check.
-     */
-    allowedEntryOrigins?: string[];
-    /**
-     * Expected runtime digest per appName.
-     */
-    expectedRuntimeDigests?: Record<string, string>;
-    /**
-     * Require runtimeDigest to be present in signal payload metadata.
-     *
-     * @default false
-     */
-    enforceRuntimeDigest?: boolean;
-    /**
-     * Maximum accepted signals per app+origin window.
-     *
-     * @default 30
-     */
-    maxSignalsPerWindow?: number;
-    /**
-     * Sliding window size in milliseconds for maxSignalsPerWindow.
-     *
-     * @default 60000
-     */
-    windowMs?: number;
-    /**
-     * Drop duplicate fallback events with the same fingerprint during this window.
-     *
-     * @default 10000
-     */
-    dedupeWindowMs?: number;
-}
-export interface ServerTelemetryCanaryUserConfig {
-    /**
-     * Enable canary rollout/rollback orchestration.
-     *
-     * @default false
-     */
-    enabled?: boolean;
-    /**
-     * Periodic canary evaluation interval in milliseconds.
-     *
-     * @default 15000
-     */
-    evaluationIntervalMs?: number;
-    /**
-     * Required consecutive healthy evaluations before promotion.
-     *
-     * @default 3
-     */
-    minConsecutiveHealthyEvaluations?: number;
-    /**
-     * Consecutive failing evaluations before automated rollback.
-     *
-     * @default 2
-     */
-    rollbackConsecutiveFailures?: number;
-    /**
-     * Maximum queue utilization ratio allowed during canary.
-     *
-     * @default 0.8
-     */
-    maxQueueUtilization?: number;
-    /**
-     * Maximum allowed total dropped envelopes during canary.
-     *
-     * @default 0
-     */
-    maxTotalDropped?: number;
-    /**
-     * Maximum allowed unhealthy exporters during canary.
-     *
-     * @default 0
-     */
-    maxUnhealthyExporters?: number;
-    /**
-     * Contract gate map used in rollout decisions.
-     * `true` means passing, `false` means failing.
-     */
-    contractGates?: Record<string, boolean | ServerTelemetryCanaryContractGateUserConfig>;
-    /**
-     * Contract-gate autopilot settings.
-     */
-    autopilot?: ServerTelemetryCanaryAutopilotUserConfig;
-}
-export interface ServerTelemetryUserConfig {
-    /**
-     * Enable framework telemetry envelope emission.
-     * @default false
-     */
-    enabled?: boolean;
-    /**
-     * Logical service name attached to every telemetry envelope.
-     * @default server.metaName
-     */
-    service?: string;
-    /**
-     * Logical module name attached to every telemetry envelope.
-     * @default "server"
-     */
-    module?: string;
-    /**
-     * Environment attached to every telemetry envelope.
-     * @default process.env.NODE_ENV || "development"
-     */
-    environment?: string;
-    /**
-     * Sampling rate for monitor events.
-     * @default 1
-     */
-    samplingRate?: number;
-    /**
-     * Flush window in milliseconds for exporter batches.
-     * @default 1000
-     */
-    flushIntervalMs?: number;
-    /**
-     * Maximum envelopes in one emitted batch.
-     * @default 50
-     */
-    maxBatchSize?: number;
-    /**
-     * Maximum envelopes buffered before backpressure drops oldest.
-     * @default 1000
-     */
-    maxQueueSize?: number;
-    /**
-     * Envelope attribute keys that should be redacted.
-     */
-    redactionKeys?: string[];
-    /**
-     * Control startup exporter health probe behavior.
-     * When enabled (default), server initialization emits a startup probe and
-     * marks exporters healthy/unhealthy before serving traffic.
-     * When fail-loud mode is enabled (default), initialization throws if at
-     * least one configured exporter is unhealthy.
-     *
-     * @default true
-     */
-    failLoudStartup?: boolean;
-    /**
-     * Queue backpressure/degradation SLO alert thresholds.
-     */
-    slo?: ServerTelemetrySloUserConfig;
-    /**
-     * Canary rollout and automated rollback orchestration policy.
-     */
-    canary?: ServerTelemetryCanaryUserConfig;
-    exporters?: {
-        /**
-         * OpenTelemetry HTTP exporter.
-         */
-        otlp?: ServerTelemetryExporterOptions;
-        /**
-         * VictoriaMetrics Prometheus import exporter.
-         */
-        victoriaMetrics?: ServerTelemetryVictoriaMetricsOptions;
-    };
-}