@bleedingdev/modern-js-server-core 3.2.0-ultramodern.99 → 3.4.0-ultramodern.0

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

@@ -0,0 +1,319 @@
+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;
+    };
+}

package/dist/types/types/plugins/base.d.ts

@@ -1,15 +1,20 @@
-import type { CacheOption, Container, HttpMethodDecider, MiddlewareContext, ServerRoute } from '@modern-js/types';
+import type { CacheOption, Container, HttpMethodDecider, MiddlewareContext, Monitors, ServerRoute } from '@modern-js/types';
 import type { Context, MiddlewareHandler } from 'hono';
 import type { UserConfig } from '../config';
 import type { Render } from '../render';
 import type { ServerPlugin } from './plugin';
 export type { FileChangeEvent, ResetEvent } from '@modern-js/plugin';
 export type FallbackReason = 'error' | 'header' | 'query' | `header,${string}`;
+export type FallbackContext = {
+    request: Request;
+    monitors?: Monitors;
+};
 export type FallbackInput = {
     reason: FallbackReason;
     error: unknown;
+    context?: FallbackContext;
 };
-export type OnFallback = (reason: FallbackReason, error?: unknown) => Promise<void>;
+export type OnFallback = (reason: FallbackReason, error?: unknown, context?: FallbackContext) => Promise<void>;
 export type APIServerStartInput = {
     pwd: string;
     prefix?: string;

package/dist/types/types/plugins/index.d.ts

@@ -1,2 +1,2 @@
-export type { APIServerStartInput, CacheConfig, FallbackInput, FallbackReason, FileChangeEvent, GetRenderHandlerOptions, MiddlewareObj, OnFallback, ServerConfig, ServerMiddleware, WebServerStartInput, } from './base';
+export type { APIServerStartInput, CacheConfig, FallbackContext, FallbackInput, FallbackReason, FileChangeEvent, GetRenderHandlerOptions, MiddlewareObj, OnFallback, ServerConfig, ServerMiddleware, WebServerStartInput, } from './base';
 export * from './plugin';

package/dist/types/utils/error.d.ts

@@ -1,4 +1,20 @@
 import type { Monitors } from '@modern-js/types';
+export type SafeFailureEnvelope = {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        status: number;
+    };
+};
+export type SafeFailureHttpResult = {
+    status: number;
+    body: SafeFailureEnvelope;
+    headers: Record<string, string>;
+};
+export declare const getSafeFailureStatus: (error: unknown) => number;
+export declare const createSafeFailureHttpResult: (error: unknown) => SafeFailureHttpResult;
+export declare const createSafeJsonFailureResponse: (error: unknown) => Response;
 export declare const createErrorHtml: (status: number) => string;
 export declare enum ErrorDigest {
     ENOTF = "Page could not be found",

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.2.0-ultramodern.99",
+  "version": "3.4.0-ultramodern.0",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
   "exports": {
@@ -74,21 +74,21 @@
     "@web-std/stream": "^1.0.3",
     "cloneable-readable": "^3.0.0",
     "flatted": "^3.4.2",
-    "hono": "^4.12.22",
+    "hono": "^4.12.27",
     "ts-deepmerge": "8.0.0",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.2.0-ultramodern.99",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.2.0-ultramodern.99",
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.2.0-ultramodern.99"
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.4.0-ultramodern.0",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.4.0-ultramodern.0",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.4.0-ultramodern.0"
   },
   "devDependencies": {
-    "@rslib/core": "0.21.5",
+    "@rslib/core": "0.23.0",
     "@types/cloneable-readable": "^2.0.3",
     "@types/merge-deep": "^3.0.3",
-    "@types/node": "^25.9.1",
-    "@typescript/native-preview": "7.0.0-dev.20260527.2",
-    "http-proxy-middleware": "^4.0.0",
-    "@scripts/rstest-config": "2.66.0",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.99"
+    "@types/node": "^26.0.0",
+    "@typescript/native-preview": "7.0.0-dev.20260624.1",
+    "http-proxy-middleware": "^4.1.1",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.4.0-ultramodern.0",
+    "@scripts/rstest-config": "2.66.0"
   },
   "sideEffects": false,
   "publishConfig": {
@@ -97,7 +97,7 @@
   },
   "scripts": {
     "dev": "rslib build --watch",
-    "build": "rslib build",
+    "build": "rslib build && pnpm -w tsgo:dts \"$PWD\"",
     "test": "rstest --passWithNoTests"
   }
 }

package/dist/cjs/adapters/node/plugins/moduleFederationCss.js

@@ -1,172 +0,0 @@
-"use strict";
-var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.n = (module)=>{
-        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
-        __webpack_require__.d(getter, {
-            a: getter
-        });
-        return getter;
-    };
-})();
-(()=>{
-    __webpack_require__.d = (exports1, definition)=>{
-        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
-            enumerable: true,
-            get: definition[key]
-        });
-    };
-})();
-(()=>{
-    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
-})();
-(()=>{
-    __webpack_require__.r = (exports1)=>{
-        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
-            value: 'Module'
-        });
-        Object.defineProperty(exports1, '__esModule', {
-            value: true
-        });
-    };
-})();
-var __webpack_exports__ = {};
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-    collectDirectRemoteModuleFederationCss: ()=>collectDirectRemoteModuleFederationCss,
-    collectModuleFederationManifestCss: ()=>collectModuleFederationManifestCss
-});
-const fileReader_namespaceObject = require("@modern-js/runtime-utils/fileReader");
-const utils_namespaceObject = require("@modern-js/utils");
-const external_path_namespaceObject = require("path");
-var external_path_default = /*#__PURE__*/ __webpack_require__.n(external_path_namespaceObject);
-const MODULE_FEDERATION_MANIFEST_FILE = 'mf-manifest.json';
-const DEFAULT_REMOTE_MANIFEST_TIMEOUT = 1500;
-const warn = (monitors, message, ...args)=>{
-    if (monitors) return void monitors.warn(message, ...args);
-    console.warn(message, ...args);
-};
-const ensureTrailingSlash = (value)=>value.endsWith('/') ? value : `${value}/`;
-const tryResolveUrl = (value, base)=>{
-    try {
-        return new URL(value, base).toString();
-    } catch  {
-        return;
-    }
-};
-const normalizeRemoteEntry = (entry)=>{
-    const value = entry.trim();
-    if (!value) return;
-    const atIndex = value.lastIndexOf('@');
-    return atIndex >= 0 ? value.slice(atIndex + 1) : value;
-};
-const getCssAssets = (assets)=>[
-        ...assets?.css?.sync || [],
-        ...assets?.css?.async || []
-    ];
-const getManifestFallbackBase = (manifestUrl)=>{
-    try {
-        return new URL('.', manifestUrl).toString();
-    } catch  {
-        return ensureTrailingSlash(manifestUrl);
-    }
-};
-const getManifestPublicPathBase = (publicPath, manifestUrl)=>{
-    if (!publicPath || 'auto' === publicPath) return getManifestFallbackBase(manifestUrl);
-    const base = tryResolveUrl(ensureTrailingSlash(publicPath), manifestUrl);
-    return base || getManifestFallbackBase(manifestUrl);
-};
-const appendResolvedCssAssets = (result, seen, assets, base)=>{
-    for (const asset of assets){
-        if (!asset) continue;
-        const resolved = tryResolveUrl(asset, base);
-        if (resolved && !seen.has(resolved)) {
-            seen.add(resolved);
-            result.push(resolved);
-        }
-    }
-};
-const collectModuleFederationManifestCss = (manifest, manifestUrl)=>{
-    const base = getManifestPublicPathBase(manifest.metaData?.publicPath, manifestUrl);
-    const result = [];
-    const seen = new Set();
-    for (const item of manifest.shared || [])appendResolvedCssAssets(result, seen, getCssAssets(item.assets), base);
-    for (const item of manifest.exposes || [])appendResolvedCssAssets(result, seen, getCssAssets(item.assets), base);
-    return result;
-};
-const fetchJsonWithTimeout = async (url, fetcher, timeout)=>{
-    const controller = new AbortController();
-    let timeoutId;
-    try {
-        const response = await Promise.race([
-            fetcher(url, {
-                signal: controller.signal
-            }),
-            new Promise((_, reject)=>{
-                timeoutId = setTimeout(()=>{
-                    controller.abort();
-                    reject(new Error(`Request timed out after ${timeout}ms`));
-                }, timeout);
-            })
-        ]);
-        if (!response.ok) throw new Error(`Unexpected status ${response.status}`);
-        return await response.json();
-    } finally{
-        if (timeoutId) clearTimeout(timeoutId);
-    }
-};
-const getHostManifest = async (pwd, monitors)=>{
-    const manifestPath = external_path_default().join(pwd, MODULE_FEDERATION_MANIFEST_FILE);
-    if (!await utils_namespaceObject.fs.pathExists(manifestPath)) return;
-    const manifestBuffer = await fileReader_namespaceObject.fileReader.readFileFromSystem(manifestPath, 'buffer');
-    if (null === manifestBuffer) return;
-    try {
-        return JSON.parse(manifestBuffer.toString('utf-8'));
-    } catch (error) {
-        warn(monitors, 'Parse module federation manifest failed, error = %s', error instanceof Error ? error.message : error);
-        return;
-    }
-};
-const collectDirectRemoteModuleFederationCss = async (pwd, options = {})=>{
-    const hostManifest = await getHostManifest(pwd, options.monitors);
-    if (!hostManifest) return [];
-    const fetcher = options.fetcher || globalThis.fetch?.bind(globalThis);
-    if (!fetcher) {
-        warn(options.monitors, 'Skip module federation remote CSS collection because fetch is unavailable.');
-        return [];
-    }
-    const timeout = options.timeout ?? DEFAULT_REMOTE_MANIFEST_TIMEOUT;
-    const cssAssets = [];
-    const seen = new Set();
-    for (const remote of hostManifest.remotes || []){
-        if (!remote.entry) continue;
-        const remoteEntry = normalizeRemoteEntry(remote.entry);
-        if (!remoteEntry) continue;
-        let remoteManifestUrl;
-        try {
-            remoteManifestUrl = new URL(remoteEntry).toString();
-        } catch  {
-            warn(options.monitors, 'Skip module federation remote CSS collection for non-absolute manifest URL %s', remoteEntry);
-            continue;
-        }
-        try {
-            const remoteManifest = await fetchJsonWithTimeout(remoteManifestUrl, fetcher, timeout);
-            for (const asset of collectModuleFederationManifestCss(remoteManifest, remoteManifestUrl))if (!seen.has(asset)) {
-                seen.add(asset);
-                cssAssets.push(asset);
-            }
-        } catch (error) {
-            warn(options.monitors, 'Load module federation remote manifest %s failed, error = %s', remoteManifestUrl, error instanceof Error ? error.message : error);
-        }
-    }
-    return cssAssets;
-};
-exports.collectDirectRemoteModuleFederationCss = __webpack_exports__.collectDirectRemoteModuleFederationCss;
-exports.collectModuleFederationManifestCss = __webpack_exports__.collectModuleFederationManifestCss;
-for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "collectDirectRemoteModuleFederationCss",
-    "collectModuleFederationManifestCss"
-].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
-Object.defineProperty(exports, '__esModule', {
-    value: true
-});