@builder.io/dev-tools 1.72.5-dev.202607071234.b7d113565 → 1.72.5-dev.202607071534.b7d113565

package/types/cli/launch/memory-pressure-monitor.d.ts

@@ -7,3 +7,47 @@
  * Uses container memory limit if available, falls back to V8 heap stats
  */
 export declare function getMemoryPressure(): number;
+/** True when the process runs under a real container memory limit (cgroup). */
+export declare function hasConstrainedMemory(): boolean;
+export type MemoryPressureAction = "none" | "warn" | "critical";
+export interface MemoryPressureEvaluatorOptions {
+    /** Ratio (0-1) at which to start warning. */
+    warnThreshold?: number;
+    /** Ratio (0-1) at which OOM is imminent and we should bail out. */
+    criticalThreshold?: number;
+    /** Consecutive critical readings required before acting (debounces spikes). */
+    sustainedCriticalChecks?: number;
+    /** Minimum gap between "warn" actions so logs don't flood. */
+    warnThrottleMs?: number;
+}
+/**
+ * Pure decision logic for memory-pressure handling, split out so the
+ * thresholds / debounce / throttle behaviour can be unit-tested without timers.
+ *
+ * `evaluate` is called once per sample and returns at most one action:
+ * - "warn": pressure is high (throttled) — log loudly.
+ * - "critical": pressure has stayed above the critical threshold for
+ *   `sustainedCriticalChecks` samples. Fires exactly once — the caller should
+ *   initiate a graceful shutdown before the kernel OOM-kills the process.
+ */
+export declare class MemoryPressureEvaluator {
+    #private;
+    constructor(opts?: MemoryPressureEvaluatorOptions);
+    evaluate(pressure: number, nowMs: number): MemoryPressureAction;
+}
+export interface MemoryPressureGuard {
+    start(): void;
+    stop(): void;
+}
+/**
+ * Periodically samples memory pressure and dispatches warn / critical actions.
+ * `onCritical` is invoked at most once per guard instance.
+ */
+export declare function createMemoryPressureGuard(opts: {
+    onWarn: (pressure: number) => void;
+    onCritical: (pressure: number) => void;
+    intervalMs?: number;
+    getPressure?: () => number;
+    now?: () => number;
+    evaluator?: MemoryPressureEvaluatorOptions;
+}): MemoryPressureGuard;

package/types/cli/launch/memory-pressure-monitor.test.d.ts

@@ -0,0 +1 @@
+export {};