veryfront 0.1.583 → 0.1.585

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.583",
+    "version": "0.1.585",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [

package/esm/src/server/production-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"production-server.d.ts","sourceRoot":"","sources":["../../../src/src/server/production-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA4BrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAmFtE,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,oFAAoF;IACpF,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CAkJvB"}
+{"version":3,"file":"production-server.d.ts","sourceRoot":"","sources":["../../../src/src/server/production-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA2BrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAgFtE,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,oFAAoF;IACpF,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA0JvB"}

package/esm/src/server/production-server.js

@@ -6,7 +6,7 @@ import { bootstrapProd } from "./bootstrap.js";
 import { cwd, onGlobalError, onSignal } from "../platform/compat/process.js";
 import { isDebugEnabled } from "../utils/constants/env.js";
 import { initializeOTLPWithApis, shutdownOTLP, withSpan, } from "../observability/tracing/otlp-setup.js";
-import { getMemorySnapshot, startMemoryMonitoring, stopMemoryMonitoring, } from "../utils/memory/index.js";
+import { startConfiguredMemoryMonitoring, stopMemoryMonitoring, } from "../utils/memory/index.js";
 import { initializeDistributedCaches } from "../cache/distributed-cache-init.js";
 import { getConfig } from "../config/index.js";
 import { resolveStyleContentVersion } from "../html/styles-builder/content-version.js";
@@ -16,8 +16,6 @@ import { setServerInitialized } from "./handlers/monitoring/health.handler.js";
 import { enableSSRClientOnlyFetching, enableSSRFetchInterception, setSSRServerPort, } from "../rendering/ssr-globals.js";
 const serverLog = logger.component("server");
 const globalLog = logger.component("global");
-/** Default interval for periodic memory usage snapshots */
-const DEFAULT_MEMORY_MONITORING_INTERVAL_MS = 30_000;
 /** Default time to wait for in-flight requests to drain during shutdown.
  *  K8s default terminationGracePeriodSeconds is 30s, so 25s leaves headroom. */
 const DEFAULT_SHUTDOWN_DRAIN_TIMEOUT_MS = 25_000;
@@ -82,105 +80,116 @@ export function startProductionServer(options) {
     return withSpan("server.startProductionServer", async () => {
         const { projectDir, port, bindAddress = "0.0.0.0", signal, debug, defaultProjectSlug, defaultProjectId, defaultEnvironment, requestInterceptor, bootstrapResult, discoveryConfig, localProjects, } = options;
         const baseAdapter = options.adapter ?? (await runtime.get());
-        // Use pre-computed bootstrap result if provided, otherwise bootstrap here
-        const bootstrap = bootstrapResult ?? await bootstrapProd(projectDir, baseAdapter);
-        const adapter = bootstrap.adapter;
-        if (bootstrap.usingFSAdapter) {
-            logger.debug("FSAdapter initialized", { type: bootstrap.fsAdapterType });
-        }
-        await prewarmLocalProductionCSSArtifacts(bootstrap.adapter, {
-            projectDir,
-            defaultProjectSlug,
-            defaultProjectId,
-            defaultEnvironment,
-            localProjects,
-        });
-        // Enable SSR fetch interception to handle relative URLs during SSR
-        setSSRServerPort(port);
-        enableSSRFetchInterception();
-        // Enable client-only fetching for /api/* routes in production.
-        // This returns empty mock responses during SSR (instead of failing with
-        // "Invalid URL" or "Connection refused"). React Query will refetch
-        // the actual data client-side after hydration.
-        enableSSRClientOnlyFetching();
-        // Run primitive discovery before serving (registries must be populated before first request)
-        if (discoveryConfig) {
-            try {
-                const { discoverAll } = await import("../discovery/index.js");
-                const { isExtendedFSAdapter } = await import("../platform/adapters/fs/wrapper.js");
-                if (discoveryConfig.projectSlug && discoveryConfig.apiToken &&
-                    discoveryConfig.fsAdapter && isExtendedFSAdapter(discoveryConfig.fsAdapter) &&
-                    discoveryConfig.fsAdapter.isMultiProjectMode()) {
-                    // Multi-project proxy: scope discovery to specific project
-                    await discoveryConfig.fsAdapter.runWithContext(discoveryConfig.projectSlug, discoveryConfig.apiToken, () => discoverAll({
-                        baseDir: discoveryConfig.baseDir,
-                        fsAdapter: discoveryConfig.fsAdapter,
-                        verbose: discoveryConfig.verbose ?? false,
-                    }));
+        const memoryMonitoringConfig = startConfiguredMemoryMonitoring(baseAdapter.env);
+        const ownsMemoryMonitoring = memoryMonitoringConfig.enabled;
+        try {
+            // Use pre-computed bootstrap result if provided, otherwise bootstrap here
+            const bootstrap = bootstrapResult ?? await bootstrapProd(projectDir, baseAdapter);
+            const adapter = bootstrap.adapter;
+            if (bootstrap.usingFSAdapter) {
+                logger.debug("FSAdapter initialized", { type: bootstrap.fsAdapterType });
+            }
+            await prewarmLocalProductionCSSArtifacts(bootstrap.adapter, {
+                projectDir,
+                defaultProjectSlug,
+                defaultProjectId,
+                defaultEnvironment,
+                localProjects,
+            });
+            // Enable SSR fetch interception to handle relative URLs during SSR
+            setSSRServerPort(port);
+            enableSSRFetchInterception();
+            // Enable client-only fetching for /api/* routes in production.
+            // This returns empty mock responses during SSR (instead of failing with
+            // "Invalid URL" or "Connection refused"). React Query will refetch
+            // the actual data client-side after hydration.
+            enableSSRClientOnlyFetching();
+            // Run primitive discovery before serving (registries must be populated before first request)
+            if (discoveryConfig) {
+                try {
+                    const { discoverAll } = await import("../discovery/index.js");
+                    const { isExtendedFSAdapter } = await import("../platform/adapters/fs/wrapper.js");
+                    if (discoveryConfig.projectSlug && discoveryConfig.apiToken &&
+                        discoveryConfig.fsAdapter && isExtendedFSAdapter(discoveryConfig.fsAdapter) &&
+                        discoveryConfig.fsAdapter.isMultiProjectMode()) {
+                        // Multi-project proxy: scope discovery to specific project
+                        await discoveryConfig.fsAdapter.runWithContext(discoveryConfig.projectSlug, discoveryConfig.apiToken, () => discoverAll({
+                            baseDir: discoveryConfig.baseDir,
+                            fsAdapter: discoveryConfig.fsAdapter,
+                            verbose: discoveryConfig.verbose ?? false,
+                        }));
+                    }
+                    else {
+                        await discoverAll({
+                            baseDir: discoveryConfig.baseDir,
+                            fsAdapter: discoveryConfig.fsAdapter,
+                            verbose: discoveryConfig.verbose ?? false,
+                        });
+                    }
                 }
-                else {
-                    await discoverAll({
-                        baseDir: discoveryConfig.baseDir,
-                        fsAdapter: discoveryConfig.fsAdapter,
-                        verbose: discoveryConfig.verbose ?? false,
+                catch (error) {
+                    serverLog.error("Primitive discovery failed", {
+                        error: error instanceof Error ? error.message : String(error),
                     });
                 }
             }
-            catch (error) {
-                serverLog.error("Primitive discovery failed", {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
+            logger.info("Starting production server", { projectDir, port, bindAddress });
+            const baseHandler = createVeryfrontHandler(projectDir, adapter, {
+                projectDir,
+                debug,
+                config: bootstrap.config,
+                defaultProjectSlug,
+                defaultProjectId,
+                defaultEnvironment,
+                localProjects,
+            });
+            // Wrap handler with interceptor if provided (for combined mode)
+            // WebSocket upgrade requests MUST NOT be intercepted because the interceptor
+            // creates a new Request object, which breaks Deno.upgradeWebSocket()
+            const handler = requestInterceptor
+                ? Object.assign(async (req) => {
+                    const isWebSocketUpgrade = req.headers.get("upgrade")?.toLowerCase() === "websocket";
+                    if (isWebSocketUpgrade)
+                        return baseHandler(req);
+                    return baseHandler(await requestInterceptor(req));
+                }, { ready: baseHandler.ready })
+                : baseHandler;
+            let resolveListenReady;
+            const listenReady = new Promise((resolve) => {
+                resolveListenReady = resolve;
+            });
+            const ready = (async () => {
+                await Promise.all([listenReady, handler.ready ?? Promise.resolve()]);
+                // Mark server as initialized when ready resolves
+                setServerInitialized(true);
+            })();
+            const server = await adapter.serve(handler, {
+                port,
+                hostname: bindAddress, // Deno uses "hostname" for bind address
+                signal,
+                onListen: (params) => {
+                    resolveListenReady?.();
+                    logger.info("Production server listening", params);
+                },
+            });
+            const stop = async () => {
+                setServerInitialized(false);
+                if (ownsMemoryMonitoring)
+                    stopMemoryMonitoring();
+                try {
+                    await server.stop();
+                }
+                catch (error) {
+                    logger.debug("Server stop failed", { error });
+                }
+            };
+            return { ready, stop };
         }
-        logger.info("Starting production server", { projectDir, port, bindAddress });
-        const baseHandler = createVeryfrontHandler(projectDir, adapter, {
-            projectDir,
-            debug,
-            config: bootstrap.config,
-            defaultProjectSlug,
-            defaultProjectId,
-            defaultEnvironment,
-            localProjects,
-        });
-        // Wrap handler with interceptor if provided (for combined mode)
-        // WebSocket upgrade requests MUST NOT be intercepted because the interceptor
-        // creates a new Request object, which breaks Deno.upgradeWebSocket()
-        const handler = requestInterceptor
-            ? Object.assign(async (req) => {
-                const isWebSocketUpgrade = req.headers.get("upgrade")?.toLowerCase() === "websocket";
-                if (isWebSocketUpgrade)
-                    return baseHandler(req);
-                return baseHandler(await requestInterceptor(req));
-            }, { ready: baseHandler.ready })
-            : baseHandler;
-        let resolveListenReady;
-        const listenReady = new Promise((resolve) => {
-            resolveListenReady = resolve;
-        });
-        const ready = (async () => {
-            await Promise.all([listenReady, handler.ready ?? Promise.resolve()]);
-            // Mark server as initialized when ready resolves
-            setServerInitialized(true);
-        })();
-        const server = await adapter.serve(handler, {
-            port,
-            hostname: bindAddress, // Deno uses "hostname" for bind address
-            signal,
-            onListen: (params) => {
-                resolveListenReady?.();
-                logger.info("Production server listening", params);
-            },
-        });
-        async function stop() {
-            setServerInitialized(false);
-            try {
-                await server.stop();
-            }
-            catch (error) {
-                logger.debug("Server stop failed", { error });
-            }
+        catch (error) {
+            if (ownsMemoryMonitoring)
+                stopMemoryMonitoring();
+            throw error;
         }
-        return { ready, stop };
     }, { "server.port": options.port, "server.bindAddress": options.bindAddress ?? "0.0.0.0" });
 }
 if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
@@ -224,21 +233,6 @@ if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
             });
         }
         const adapter = await runtime.get();
-        // Start memory monitoring if enabled
-        const enableMemoryMonitoring = adapter.env.get("ENABLE_MEMORY_MONITORING") === "true";
-        const monitoringIntervalMs = parseInt(adapter.env.get("MEMORY_MONITORING_INTERVAL_MS") ??
-            String(DEFAULT_MEMORY_MONITORING_INTERVAL_MS), 10);
-        if (enableMemoryMonitoring) {
-            startMemoryMonitoring(monitoringIntervalMs);
-            logger.debug("Memory monitoring enabled", { intervalMs: monitoringIntervalMs });
-            // Log initial memory state
-            const initialSnapshot = getMemorySnapshot();
-            logger.debug("Initial memory state", {
-                heapUsedMB: initialSnapshot.heap.usedHeapSizeMB,
-                heapLimitMB: initialSnapshot.heap.heapSizeLimitMB,
-                cacheCount: initialSnapshot.caches.length,
-            });
-        }
         const shutdownController = new AbortController();
         const projectDir = cwd();
         const port = Number(adapter.env.get("PORT") ?? adapter.env.get("VERYFRONT_PORT") ?? DEFAULT_SERVER_PORT);
@@ -284,7 +278,6 @@ if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
                     });
                 }
                 // Phase 3: Stop accepting new connections and clean up
-                stopMemoryMonitoring();
                 requestTracker.shutdown();
                 await bootstrap.dispose?.();
                 shutdownController.abort();

package/esm/src/utils/memory/index.d.ts

@@ -3,5 +3,5 @@
  *
  * @module utils/memory
  */
-export { type CacheStats, checkMemoryPressure, clearAllCaches, forceGC, type GCStats, getCacheStats, getHeapStats, getMemoryMonitoringLogContext, getMemorySnapshot, getTopCacheStats, type HeapStats, type MemoryMonitoringLogContext, type MemorySnapshot, type MonitoringCacheStats, registerCache, setHeapWarningThreshold, startMemoryMonitoring, stopMemoryMonitoring, unregisterCache, } from "./profiler.js";
+export { type CacheStats, checkMemoryPressure, clearAllCaches, DEFAULT_MEMORY_MONITORING_INTERVAL_MS, forceGC, type GCStats, getCacheStats, getHeapStats, getMemoryMonitoringConfig, getMemoryMonitoringLogContext, getMemoryMonitoringState, getMemorySnapshot, getTopCacheStats, type HeapStats, type MemoryMonitoringConfig, type MemoryMonitoringEnv, type MemoryMonitoringLogContext, type MemoryMonitoringState, type MemorySnapshot, type MonitoringCacheStats, registerCache, setHeapWarningThreshold, startConfiguredMemoryMonitoring, startMemoryMonitoring, stopMemoryMonitoring, unregisterCache, } from "./profiler.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/utils/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,mBAAmB,EACnB,cAAc,EACd,OAAO,EACP,KAAK,OAAO,EACZ,aAAa,EACb,YAAY,EACZ,6BAA6B,EAC7B,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,aAAa,EACb,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,mBAAmB,EACnB,cAAc,EACd,qCAAqC,EACrC,OAAO,EACP,KAAK,OAAO,EACZ,aAAa,EACb,YAAY,EACZ,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,aAAa,EACb,uBAAuB,EACvB,+BAA+B,EAC/B,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/esm/src/utils/memory/index.js

@@ -3,4 +3,4 @@
  *
  * @module utils/memory
  */
-export { checkMemoryPressure, clearAllCaches, forceGC, getCacheStats, getHeapStats, getMemoryMonitoringLogContext, getMemorySnapshot, getTopCacheStats, registerCache, setHeapWarningThreshold, startMemoryMonitoring, stopMemoryMonitoring, unregisterCache, } from "./profiler.js";
+export { checkMemoryPressure, clearAllCaches, DEFAULT_MEMORY_MONITORING_INTERVAL_MS, forceGC, getCacheStats, getHeapStats, getMemoryMonitoringConfig, getMemoryMonitoringLogContext, getMemoryMonitoringState, getMemorySnapshot, getTopCacheStats, registerCache, setHeapWarningThreshold, startConfiguredMemoryMonitoring, startMemoryMonitoring, stopMemoryMonitoring, unregisterCache, } from "./profiler.js";

package/esm/src/utils/memory/profiler.d.ts

@@ -1,3 +1,5 @@
+/** Default interval for periodic memory snapshots (30 seconds) */
+export declare const DEFAULT_MEMORY_MONITORING_INTERVAL_MS = 30000;
 export interface CacheStats {
     name: string;
     entries: number;
@@ -37,6 +39,17 @@ export interface MemoryMonitoringLogContext {
     totalCacheEntries: number;
     topCaches: MonitoringCacheStats[];
 }
+export interface MemoryMonitoringEnv {
+    get(key: string): string | null | undefined;
+}
+export interface MemoryMonitoringConfig {
+    enabled: boolean;
+    intervalMs: number;
+}
+export interface MemoryMonitoringState {
+    active: boolean;
+    intervalMs: number | undefined;
+}
 export interface GCStats {
     majorGCs: number;
     minorGCs: number;
@@ -49,8 +62,11 @@ export declare function getCacheStats(): CacheStats[];
 export declare function getMemorySnapshot(): MemorySnapshot;
 export declare function getTopCacheStats(caches: CacheStats[], limit?: number): MonitoringCacheStats[];
 export declare function getMemoryMonitoringLogContext(snapshot: MemorySnapshot, topCacheLimit?: number): MemoryMonitoringLogContext;
+export declare function getMemoryMonitoringConfig(env: MemoryMonitoringEnv): MemoryMonitoringConfig;
+export declare function getMemoryMonitoringState(): MemoryMonitoringState;
 export declare function forceGC(): Promise<boolean>;
 export declare function startMemoryMonitoring(intervalMs?: number): void;
+export declare function startConfiguredMemoryMonitoring(env: MemoryMonitoringEnv): MemoryMonitoringConfig;
 export declare function stopMemoryMonitoring(): void;
 export declare function setHeapWarningThreshold(threshold: number): void;
 export declare function clearAllCaches(): void;

package/esm/src/utils/memory/profiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/memory/profiler.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,GAAG,IAAI,CAG5E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,IAAI,SAAS,CAiBxC;AAkBD,wBAAgB,aAAa,IAAI,UAAU,EAAE,CAa5C;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAWlD;AAcD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,KAAK,SAAI,GAAG,oBAAoB,EAAE,CAMxF;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,aAAa,SAAI,GAChB,0BAA0B,CAY5B;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAUhD;AAED,wBAAgB,qBAAqB,CAAC,UAAU,SAAwC,GAAG,IAAI,CAiC9F;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAwBD,wBAAgB,mBAAmB,IAAI;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,CAiBA;AAED,YAAY,EAAE,cAAc,IAAI,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/memory/profiler.ts"],"names":[],"mappings":"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"}

package/esm/src/utils/memory/profiler.js

@@ -11,11 +11,12 @@ const logger = rendererLogger.component("memory-profiler");
 /** Fallback V8 heap limit when no --max-old-space-size flag is set (5 GB) */
 const DEFAULT_HEAP_LIMIT_MB = 5_120;
 /** Default interval for periodic memory snapshots (30 seconds) */
-const DEFAULT_MEMORY_MONITORING_INTERVAL_MS = 30_000;
+export const DEFAULT_MEMORY_MONITORING_INTERVAL_MS = 30_000;
 /** Heap growth (MB) per interval that triggers a rapid-growth warning */
 const HEAP_RAPID_GROWTH_THRESHOLD_MB = 100;
 const cacheRegistry = new Map();
 let memoryCheckInterval;
+let memoryCheckIntervalMs;
 let lastHeapUsed = 0;
 let heapGrowthWarningThreshold = 0.8;
 export function registerCache(name, getStats) {
@@ -109,6 +110,21 @@ export function getMemoryMonitoringLogContext(snapshot, topCacheLimit = 8) {
         topCaches: getTopCacheStats(snapshot.caches, topCacheLimit),
     };
 }
+export function getMemoryMonitoringConfig(env) {
+    const enabled = env.get("ENABLE_MEMORY_MONITORING") === "true";
+    const rawInterval = env.get("MEMORY_MONITORING_INTERVAL_MS");
+    const parsedInterval = parseInt(rawInterval ?? String(DEFAULT_MEMORY_MONITORING_INTERVAL_MS), 10);
+    const intervalMs = Number.isFinite(parsedInterval) && parsedInterval > 0
+        ? parsedInterval
+        : DEFAULT_MEMORY_MONITORING_INTERVAL_MS;
+    return { enabled, intervalMs };
+}
+export function getMemoryMonitoringState() {
+    return {
+        active: memoryCheckInterval !== undefined,
+        intervalMs: memoryCheckIntervalMs,
+    };
+}
 export async function forceGC() {
     try {
         const buffer = new Uint8Array(100 * 1024 * 1024);
@@ -125,6 +141,7 @@ export function startMemoryMonitoring(intervalMs = DEFAULT_MEMORY_MONITORING_INT
     if (memoryCheckInterval)
         clearInterval(memoryCheckInterval);
     logger.info(`Starting memory monitoring (interval: ${intervalMs}ms)`);
+    memoryCheckIntervalMs = intervalMs;
     memoryCheckInterval = dntShim.setInterval(() => {
         const snapshot = getMemorySnapshot();
         const { heap } = snapshot;
@@ -150,11 +167,26 @@ export function startMemoryMonitoring(intervalMs = DEFAULT_MEMORY_MONITORING_INT
         lastHeapUsed = heap.usedHeapSizeMB;
     }, intervalMs);
 }
+export function startConfiguredMemoryMonitoring(env) {
+    const config = getMemoryMonitoringConfig(env);
+    if (!config.enabled)
+        return config;
+    startMemoryMonitoring(config.intervalMs);
+    logger.info("Memory monitoring enabled", { intervalMs: config.intervalMs });
+    const initialSnapshot = getMemorySnapshot();
+    logger.info("Initial memory state", {
+        heapUsedMB: initialSnapshot.heap.usedHeapSizeMB,
+        heapLimitMB: initialSnapshot.heap.heapSizeLimitMB,
+        cacheCount: initialSnapshot.caches.length,
+    });
+    return config;
+}
 export function stopMemoryMonitoring() {
     if (!memoryCheckInterval)
         return;
     clearInterval(memoryCheckInterval);
     memoryCheckInterval = undefined;
+    memoryCheckIntervalMs = undefined;
     logger.info("Memory monitoring stopped");
 }
 export function setHeapWarningThreshold(threshold) {

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.583";
+export declare const VERSION = "0.1.585";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.583";
+export const VERSION = "0.1.585";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.583",
+  "version": "0.1.585",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",