veryfront 0.1.49 → 0.1.51

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

@@ -8,6 +8,12 @@ import * as dntShim from "../../../_dnt.shims.js";
 import { rendererLogger } from "../index.js";
 import { getArgs, getEnv, memoryUsage } from "../../platform/compat/process.js";
 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;
+/** 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 lastHeapUsed = 0;
@@ -47,7 +53,7 @@ function getConfiguredHeapLimit() {
     const v8MaxOldSpaceSize = parseInt(getEnv("V8_MAX_OLD_SPACE_SIZE") ?? "", 10);
     if (!Number.isNaN(v8MaxOldSpaceSize) && v8MaxOldSpaceSize > 0)
         return v8MaxOldSpaceSize;
-    return 5120;
+    return DEFAULT_HEAP_LIMIT_MB;
 }
 export function getCacheStats() {
     const stats = [];
@@ -77,14 +83,15 @@ export async function forceGC() {
     try {
         const buffer = new Uint8Array(100 * 1024 * 1024);
         buffer.fill(0);
-        await new Promise((resolve) => dntShim.setTimeout(resolve, 100));
+        await new Promise((resolve) => dntShim.setTimeout(resolve, 100)); // no cleanup needed: one-shot
         return true;
     }
-    catch {
+    catch (error) {
+        logger.debug("forceGC allocation failed", { error });
         return false;
     }
 }
-export function startMemoryMonitoring(intervalMs = 30000) {
+export function startMemoryMonitoring(intervalMs = DEFAULT_MEMORY_MONITORING_INTERVAL_MS) {
     if (memoryCheckInterval)
         clearInterval(memoryCheckInterval);
     logger.info(`Starting memory monitoring (interval: ${intervalMs}ms)`);
@@ -108,7 +115,7 @@ export function startMemoryMonitoring(intervalMs = 30000) {
             });
         }
         const heapGrowthMB = heap.usedHeapSizeMB - lastHeapUsed;
-        if (heapGrowthMB > 100) {
+        if (heapGrowthMB > HEAP_RAPID_GROWTH_THRESHOLD_MB) {
             logger.warn("Rapid heap growth detected", {
                 growthMB: heapGrowthMB,
                 intervalMs,
@@ -139,7 +146,7 @@ export function clearAllCaches() {
  */
 function getMemoryThreshold(envVar, fallback) {
     try {
-        const value = typeof dntShim.Deno !== "undefined" ? dntShim.Deno.env.get(envVar) : undefined;
+        const value = getEnv(envVar);
         if (!value)
             return fallback;
         const parsed = parseInt(value, 10);
@@ -147,7 +154,8 @@ function getMemoryThreshold(envVar, fallback) {
             return fallback;
         return parsed;
     }
-    catch {
+    catch (_) {
+        /* expected: Deno.env.get may fail without --allow-env */
         return fallback;
     }
 }

package/esm/src/utils/parallel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/src/utils/parallel.ts"],"names":[],"mappings":"AAAA;;;;;;;iCAOiC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,oEAAoE,CAAC;AAW/F,KAAK,eAAe,GAAG;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAeF,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CA4Bd;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EACvE,GAAG,EAAE,CAAC,EACN,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAMxD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACvD,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAkCxB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACvD,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE1D;AAED,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/src/utils/parallel.ts"],"names":[],"mappings":"AAAA;;;;;;;iCAOiC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,oEAAoE,CAAC;AAY/F,KAAK,eAAe,GAAG;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAgBF,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CA4Bd;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EACvE,GAAG,EAAE,CAAC,EACN,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAMxD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACvD,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAkCxB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACvD,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE1D;AAED,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}

package/esm/src/utils/parallel.js

@@ -8,6 +8,7 @@
  *******************************/
 import { Semaphore } from "../modules/react-loader/ssr-module-loader/concurrency/semaphore.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
+import { TIMEOUT_ERROR } from "../errors/index.js";
 const DEFAULT_CONCURRENCY = 20;
 const ACQUIRE_TIMEOUT_MS = 30_000;
 // No maxQueueSize — parallelMap schedules all items via Promise.all,
@@ -18,7 +19,9 @@ async function acquireOrThrow(semaphore, timeoutMs, label) {
     const acquired = await semaphore.tryAcquire(timeoutMs);
     if (acquired)
         return;
-    throw new Error(`${label}: timed out waiting for semaphore after ${timeoutMs}ms (available: ${semaphore.available}, waiting: ${semaphore.waiting})`);
+    throw TIMEOUT_ERROR.create({
+        detail: `${label}: timed out waiting for semaphore after ${timeoutMs}ms (available: ${semaphore.available}, waiting: ${semaphore.waiting})`,
+    });
 }
 export function parallelMap(items, fn, options = {}) {
     return withSpan("utils.parallelMap", async () => {

package/esm/src/utils/path-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/path-utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAQD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAG9E;AAED,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEhF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAQD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASrD;AAgCD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAQrE"}
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/path-utils.ts"],"names":[],"mappings":"AAQA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMvE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAQD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAG9E;AAED,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEhF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAQD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASrD;AAgCD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAQrE"}

package/esm/src/utils/path-utils.js

@@ -1,10 +1,14 @@
+import { normalize } from "../platform/compat/path/index.js";
 import { logger } from "./logger/logger.js";
+function stripTrailingSlash(pathname) {
+    if (pathname === "/")
+        return pathname;
+    return pathname.replace(/\/+$/, "");
+}
 export function normalizePath(pathname) {
-    let normalized = pathname.replace(/\\+/g, "/").replace(/\/\.+\//g, "/");
-    if (normalized !== "/" && normalized.endsWith("/")) {
-        normalized = normalized.slice(0, -1);
-    }
-    return normalized;
+    if (!pathname)
+        return pathname;
+    return stripTrailingSlash(normalize(pathname.replace(/\\+/g, "/")));
 }
 export function joinPath(a, b) {
     const left = a.replace(/\/$/, "");
@@ -12,8 +16,10 @@ export function joinPath(a, b) {
     return `${left}/${right}`;
 }
 export function isWithinDirectory(root, target) {
-    const normalizedRoot = normalizePath(root);
-    const normalizedTarget = normalizePath(target);
+    const normalizedRoot = stripTrailingSlash(normalizePath(root));
+    const normalizedTarget = stripTrailingSlash(normalizePath(target));
+    if (normalizedRoot === "/")
+        return normalizedTarget.startsWith("/");
     return normalizedTarget === normalizedRoot || normalizedTarget.startsWith(`${normalizedRoot}/`);
 }
 /**

package/esm/src/utils/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAQ1C"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAS1C"}

package/esm/src/utils/platform.js

@@ -13,7 +13,8 @@ export function isCompiledBinary() {
     try {
         return execPath().includes("veryfront");
     }
-    catch {
+    catch (_) {
+        /* expected: execPath may not be available on all platforms */
         return false;
     }
 }

package/esm/src/utils/redis-client.d.ts

@@ -17,14 +17,12 @@ export interface RedisClient {
     on?(event: string, listener: (...args: unknown[]) => void): void;
     isOpen?: boolean;
 }
-export interface RedisClientOptions {
+interface RedisClientOptions {
     url?: string;
     connectTimeout?: number;
     autoReconnect?: boolean;
 }
 export declare function getRedisClient(options?: RedisClientOptions): Promise<RedisClient>;
-export declare function isRedisAvailable(): boolean;
 export declare function isRedisConfigured(): boolean;
-export declare function disconnectRedis(): Promise<void>;
-export declare function resetRedisState(): void;
+export {};
 //# sourceMappingURL=redis-client.d.ts.map

package/esm/src/utils/redis-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-client.d.ts","sourceRoot":"","sources":["../../../src/src/utils/redis-client.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CACF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAUD,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CA0B3F;AAqCD,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAarD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAMtC"}
+{"version":3,"file":"redis-client.d.ts","sourceRoot":"","sources":["../../../src/src/utils/redis-client.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CACF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,kBAAkB;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAUD,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4B3F;AAuCD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/esm/src/utils/redis-client.js

@@ -1,5 +1,6 @@
 import { getEnv } from "../platform/compat/process.js";
 import { logger as baseLogger } from "./logger/logger.js";
+import { DEPENDENCY_MISSING, INITIALIZATION_ERROR } from "../errors/index.js";
 const logger = baseLogger.component("redis");
 let sharedClient = null;
 let connectionPromise = null;
@@ -11,7 +12,9 @@ export async function getRedisClient(options = {}) {
     if (sharedClient && sharedClient.isOpen !== false)
         return sharedClient;
     if (connectionFailed && Date.now() - lastConnectionAttempt < RECONNECT_DELAY_MS) {
-        throw new Error("[Redis] Connection recently failed, waiting before retry");
+        throw INITIALIZATION_ERROR.create({
+            detail: "[Redis] Connection recently failed, waiting before retry",
+        });
     }
     if (isConnecting && connectionPromise)
         return connectionPromise;
@@ -41,8 +44,11 @@ async function createClient(options) {
         const mod = await import(redisClientModule);
         createClientFn = mod.createClient;
     }
-    catch {
-        throw new Error("[Redis] Failed to load @redis/client. Install with: deno add npm:@redis/client@1.5.8");
+    catch (error) {
+        logger.debug("Failed to load @redis/client module", { error });
+        throw DEPENDENCY_MISSING.create({
+            detail: "[Redis] Failed to load @redis/client. Install with: deno add npm:@redis/client@1.5.8",
+        });
     }
     const client = createClientFn({ url: options.url ?? getEnv("REDIS_URL") });
     if (typeof client.on === "function") {
@@ -61,30 +67,6 @@ async function createClient(options) {
     await client.connect();
     return client;
 }
-export function isRedisAvailable() {
-    return sharedClient !== null && sharedClient.isOpen !== false && !connectionFailed;
-}
 export function isRedisConfigured() {
     return Boolean(getEnv("REDIS_URL"));
 }
-export async function disconnectRedis() {
-    if (sharedClient) {
-        try {
-            await sharedClient.disconnect();
-        }
-        catch {
-            // Ignore disconnect errors
-        }
-        sharedClient = null;
-    }
-    connectionFailed = false;
-    isConnecting = false;
-    connectionPromise = null;
-}
-export function resetRedisState() {
-    sharedClient = null;
-    connectionFailed = false;
-    isConnecting = false;
-    connectionPromise = null;
-    lastConnectionAttempt = 0;
-}

package/esm/src/utils/route-path-utils.d.ts

@@ -8,8 +8,6 @@
 export declare const PAGE_EXTENSIONS: readonly [".tsx", ".jsx", ".ts", ".js", ".mdx", ".md"];
 /** Supported component file extensions (subset of page extensions) */
 export declare const COMPONENT_EXTENSIONS: readonly [".tsx", ".jsx", ".ts", ".js"];
-/** Regex for matching and removing file extensions */
-export declare const EXTENSION_REGEX: RegExp;
 /**
  * Check if a segment name is a dynamic route segment.
  * Handles both directory names like "[id]" and file names like "[id].tsx"
@@ -37,7 +35,7 @@ export declare function extractParamName(segment: string): string;
 /**
  * Router type detection result
  */
-export interface RouterBasePath {
+interface RouterBasePath {
     type: "app" | "pages" | null;
     relativePath: string | null;
 }
@@ -49,7 +47,7 @@ export declare function extractRouterBasePath(pageEntityId: string): RouterBaseP
 /**
  * Result of route parameter extraction
  */
-export interface ExtractedRouteParams {
+interface ExtractedRouteParams {
     params: Record<string, string | string[]>;
     matched: boolean;
 }
@@ -83,4 +81,5 @@ export declare function extractParamsFromPattern(pattern: string, slug: string):
  * Check if a pattern matches a slug
  */
 export declare function matchesPattern(pattern: string, slug: string): boolean;
+export {};
 //# sourceMappingURL=route-path-utils.d.ts.map

package/esm/src/utils/route-path-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-path-utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/route-path-utils.ts"],"names":[],"mappings":"AAAA;;;;;4BAK4B;AAE5B,qCAAqC;AACrC,eAAO,MAAM,eAAe,wDAAyD,CAAC;AAEtF,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,yCAA0C,CAAC;AAE5E,sDAAsD;AACtD,eAAO,MAAM,eAAe,QAA8B,CAAC;AAU3D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAY1E;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA4B3F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMpF;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CA+B1C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErE"}
+{"version":3,"file":"route-path-utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/route-path-utils.ts"],"names":[],"mappings":"AAAA;;;;;4BAK4B;AAE5B,qCAAqC;AACrC,eAAO,MAAM,eAAe,wDAAyD,CAAC;AAEtF,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,yCAA0C,CAAC;AAa5E;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAY1E;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA4B3F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMpF;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CA+B1C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/esm/src/utils/route-path-utils.js

@@ -9,7 +9,7 @@ export const PAGE_EXTENSIONS = [".tsx", ".jsx", ".ts", ".js", ".mdx", ".md"];
 /** Supported component file extensions (subset of page extensions) */
 export const COMPONENT_EXTENSIONS = [".tsx", ".jsx", ".ts", ".js"];
 /** Regex for matching and removing file extensions */
-export const EXTENSION_REGEX = /\.(tsx|jsx|ts|js|mdx|md)$/;
+const EXTENSION_REGEX = /\.(tsx|jsx|ts|js|mdx|md)$/;
 /** Patterns for dynamic segment detection */
 const DYNAMIC_SEGMENT_PATTERNS = {
     standard: /^\[[\w]+\]$/, // [id]

package/esm/src/workflow/api.d.ts

@@ -1,3 +1,23 @@
+/**
+ * Context-Aware API Module
+ *
+ * Provides framework utilities that automatically use the current tenant context.
+ * Tools and workflows can import and use these without passing any context parameters.
+ *
+ * @example
+ * ```typescript
+ * import { api } from "veryfront/workflow";
+ *
+ * const myTool = {
+ *   id: "fetch-file",
+ *   execute: async (input) => {
+ *     // Just use api - it automatically knows the current project
+ *     const content = await api.files.read(input.path);
+ *     return content;
+ *   },
+ * };
+ * ```
+ */
 import { VeryfrontApiClient } from "../platform/adapters/veryfront-api-client/client.js";
 /**
  * Get the current tenant context from either workflow execution or request context.
@@ -44,8 +64,8 @@ export declare const api: {
             path: string;
             size: number;
             updated_at: string;
-            content?: string | undefined;
             id?: string | undefined;
+            content?: string | undefined;
             version_id?: string | undefined;
         }[]>;
         /**
@@ -77,8 +97,8 @@ export declare const api: {
             description?: string | undefined;
             layout?: string | null | undefined;
             provider?: string | null | undefined;
-            created_at?: string | undefined;
             updated_at?: string | undefined;
+            created_at?: string | undefined;
             provider_id?: string | null | undefined;
             layout_id?: string | null | undefined;
         }>;

package/esm/src/workflow/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/src/workflow/api.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAyBzF;;;GAGG;AACH,iBAAS,SAAS,+CAwBjB;AAED;;;GAGG;AACH,iBAAS,SAAS,IAAI,kBAAkB,CAcvC;AAED;;;;GAIG;AACH,eAAO,MAAM,GAAG;IACd;;OAEG;;QAED;;;WAGG;qBACU,MAAM;QAKnB;;;WAGG;yBACc;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;QAKtE;;WAEG;4BACiB;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;QAKxD;;;WAGG;wBACa,MAAM;QAKtB;;;WAGG;0BACe,MAAM;;;;;IAM1B;;OAEG;;QAED;;WAEG;;;;;;;;;;;;;;QAMH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;IAIL;;;OAGG;;IAGH;;;OAGG;;CAEJ,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/src/workflow/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AA2BzF;;;GAGG;AACH,iBAAS,SAAS,+CAwBjB;AAED;;;GAGG;AACH,iBAAS,SAAS,IAAI,kBAAkB,CAcvC;AAED;;;;GAIG;AACH,eAAO,MAAM,GAAG;IACd;;OAEG;;QAED;;;WAGG;qBACU,MAAM;QAKnB;;;WAGG;yBACc;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;QAKtE;;WAEG;4BACiB;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;QAKxD;;;WAGG;wBACa,MAAM;QAKtB;;;WAGG;0BACe,MAAM;;;;;IAM1B;;OAEG;;QAED;;WAEG;;;;;;;;;;;;;;QAMH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;IAIL;;;OAGG;;IAGH;;;OAGG;;CAEJ,CAAC"}

package/esm/src/workflow/api.js

@@ -18,10 +18,11 @@
  * };
  * ```
  */
-import * as dntShim from "../../_dnt.shims.js";
 import { getWorkflowTenant } from "./executor/step-executor.js";
 import { getCurrentRequestContext } from "../platform/adapters/fs/veryfront/multi-project-adapter.js";
 import { VeryfrontApiClient } from "../platform/adapters/veryfront-api-client/client.js";
+import { INITIALIZATION_ERROR, INPUT_VALIDATION_FAILED } from "../errors/index.js";
+import { getHostEnv } from "../platform/compat/process.js";
 /**
  * Validate that a project slug is safe and well-formed.
  * Prevents path traversal and injection attacks.
@@ -51,16 +52,20 @@ function getTenant() {
     // Then fall back to request context (for direct API route calls)
     const tenant = getWorkflowTenant() ?? getCurrentRequestContext();
     if (!tenant) {
-        throw new Error("No tenant context available. " +
-            "This API must be called within a request or workflow execution. " +
-            "If you're calling this from a standalone script, you need to wrap " +
-            "your code with runWithContext() first.");
+        throw INITIALIZATION_ERROR.create({
+            detail: "No tenant context available. " +
+                "This API must be called within a request or workflow execution. " +
+                "If you're calling this from a standalone script, you need to wrap " +
+                "your code with runWithContext() first.",
+        });
     }
     // Validate tenant fields to prevent injection attacks
     if (!isValidProjectSlug(tenant.projectSlug)) {
-        throw new Error(`Invalid project slug: "${tenant.projectSlug}". ` +
-            "Project slugs must be 1-128 characters, start with alphanumeric, " +
-            "and contain only alphanumeric characters, hyphens, or underscores.");
+        throw INPUT_VALIDATION_FAILED.create({
+            detail: `Invalid project slug: "${tenant.projectSlug}". ` +
+                "Project slugs must be 1-128 characters, start with alphanumeric, " +
+                "and contain only alphanumeric characters, hyphens, or underscores.",
+        });
     }
     return tenant;
 }
@@ -71,7 +76,7 @@ function getTenant() {
 function getClient() {
     const tenant = getTenant();
     const client = new VeryfrontApiClient({
-        apiBaseUrl: dntShim.Deno.env.get("VERYFRONT_API_URL") || "https://api.veryfront.com",
+        apiBaseUrl: getHostEnv("VERYFRONT_API_URL") || "https://api.veryfront.com",
         proxyMode: true,
         projectId: tenant.projectId,
         projectSlug: tenant.projectSlug,

package/esm/src/workflow/backends/memory.d.ts

@@ -3,7 +3,7 @@ import type { BackendConfig, WorkflowBackend } from "./types.js";
 /**
  * Memory backend configuration
  */
-export interface MemoryBackendConfig extends BackendConfig {
+interface MemoryBackendConfig extends BackendConfig {
     /** Maximum queue size (default: 10000) */
     maxQueueSize?: number;
 }
@@ -61,4 +61,5 @@ export declare class MemoryBackend implements WorkflowBackend {
     };
     clear(): Promise<void>;
 }
+export {};
 //# sourceMappingURL=memory.d.ts.map

package/esm/src/workflow/backends/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/backends/memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/backends/memory.ts"],"names":[],"mappings":"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"}

package/esm/src/workflow/backends/memory.js

@@ -7,9 +7,10 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { logger as baseLogger } from "../../utils/index.js";
 import { requeueRun } from "./shared/requeue-run.js";
+import { ORCHESTRATION_ERROR, RESOURCE_NOT_FOUND } from "../../errors/index.js";
 const logger = baseLogger.component("memory-backend");
 /** Default max queue size */
-const DEFAULT_MAX_QUEUE_SIZE = 10000;
+const DEFAULT_MAX_QUEUE_SIZE = 10_000;
 export class MemoryBackend {
     runs = new Map();
     checkpoints = new Map();
@@ -41,7 +42,7 @@ export class MemoryBackend {
     updateRun(runId, patch) {
         const run = this.runs.get(runId);
         if (!run)
-            throw new Error(`Run not found: ${runId}`);
+            throw RESOURCE_NOT_FOUND.create({ detail: `Run not found: ${runId}` });
         logger.debug(`Updating run: ${runId}`, patch);
         const updated = {
             ...run,
@@ -152,11 +153,13 @@ export class MemoryBackend {
     }
     updateApproval(runId, approvalId, decision) {
         const approvals = this.approvals.get(runId);
-        if (!approvals)
-            throw new Error(`No approvals found for run: ${runId}`);
+        if (!approvals) {
+            throw RESOURCE_NOT_FOUND.create({ detail: `No approvals found for run: ${runId}` });
+        }
         const approval = approvals.find((a) => a.id === approvalId);
-        if (!approval)
-            throw new Error(`Approval not found: ${approvalId}`);
+        if (!approval) {
+            throw RESOURCE_NOT_FOUND.create({ detail: `Approval not found: ${approvalId}` });
+        }
         logger.debug("Updating approval", { approvalId, decision });
         approval.status = decision.approved ? "approved" : "rejected";
         approval.decidedBy = decision.approver;
@@ -196,7 +199,9 @@ export class MemoryBackend {
     enqueue(job) {
         const maxSize = this.config.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE;
         if (this.queue.length >= maxSize) {
-            return Promise.reject(new Error(`Queue full (max: ${maxSize}). Cannot enqueue job: ${job.runId}`));
+            return Promise.reject(ORCHESTRATION_ERROR.create({
+                detail: `Queue full (max: ${maxSize}). Cannot enqueue job: ${job.runId}`,
+            }));
         }
         logger.debug(`Enqueueing job: ${job.runId}`);
         const priority = job.priority ?? 0;

package/esm/src/workflow/backends/redis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/backends/redis/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/backends/redis/index.ts"],"names":[],"mappings":"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"}

package/esm/src/workflow/backends/redis/index.js

@@ -9,6 +9,7 @@
 import * as dntShim from "../../../../_dnt.shims.js";
 import { agentLogger } from "../../../utils/index.js";
 import { requeueRun } from "../shared/requeue-run.js";
+import { INITIALIZATION_ERROR, INVALID_ARGUMENT, RESOURCE_NOT_FOUND } from "../../../errors/index.js";
 import { DenoRedisAdapter, getRedisModule, NodeRedisAdapter, } from "../../../platform/adapters/redis/index.js";
 const logger = agentLogger.component("redis-backend");
 export class RedisBackend {
@@ -70,10 +71,13 @@ export class RedisBackend {
         };
     }
     deserializeRun(data) {
-        if (!data.id)
-            throw new Error("Invalid workflow run data: missing 'id' field");
+        if (!data.id) {
+            throw INVALID_ARGUMENT.create({ detail: "Invalid workflow run data: missing 'id' field" });
+        }
         if (!data.workflowId) {
-            throw new Error(`Invalid workflow run data for run "${data.id}": missing 'workflowId' field`);
+            throw INVALID_ARGUMENT.create({
+                detail: `Invalid workflow run data for run "${data.id}": missing 'workflowId' field`,
+            });
         }
         const validStatuses = [
             "pending",
@@ -85,8 +89,10 @@ export class RedisBackend {
         ];
         const status = data.status;
         if (data.status && !validStatuses.includes(status)) {
-            throw new Error(`Invalid workflow run data for run "${data.id}": unknown status "${data.status}". ` +
-                `Expected one of: ${validStatuses.join(", ")}`);
+            throw INVALID_ARGUMENT.create({
+                detail: `Invalid workflow run data for run "${data.id}": unknown status "${data.status}". ` +
+                    `Expected one of: ${validStatuses.join(", ")}`,
+            });
         }
         function safeJsonParse(runId, field, value, defaultValue) {
             if (!value)
@@ -95,8 +101,11 @@ export class RedisBackend {
                 return JSON.parse(value);
             }
             catch (e) {
-                throw new Error(`Invalid workflow run data for run "${runId}": failed to parse '${field}' as JSON. ` +
-                    `Error: ${e instanceof Error ? e.message : String(e)}`);
+                throw INVALID_ARGUMENT.create({
+                    detail: `Invalid workflow run data for run "${runId}": failed to parse '${field}' as JSON. ` +
+                        `Error: ${e instanceof Error ? e.message : String(e)}`,
+                    cause: e instanceof Error ? e : undefined,
+                });
             }
         }
         return {
@@ -154,7 +163,7 @@ export class RedisBackend {
             this.client = new DenoRedisAdapter(client);
             return this.client;
         }
-        throw new Error("No Redis client available for this runtime.");
+        throw INITIALIZATION_ERROR.create({ detail: "No Redis client available for this runtime." });
     }
     async initialize() {
         if (this.initialized)
@@ -345,11 +354,13 @@ export class RedisBackend {
             const data = JSON.parse(raw);
             return data.id === approvalId;
         });
-        if (targetIndex === -1)
-            throw new Error(`Approval not found: ${approvalId}`);
+        if (targetIndex === -1) {
+            throw RESOURCE_NOT_FOUND.create({ detail: `Approval not found: ${approvalId}` });
+        }
         const rawTarget = rawList[targetIndex];
-        if (!rawTarget)
-            throw new Error(`Approval data not found: ${approvalId}`);
+        if (!rawTarget) {
+            throw RESOURCE_NOT_FOUND.create({ detail: `Approval data not found: ${approvalId}` });
+        }
         const data = JSON.parse(rawTarget);
         data.status = decision.approved ? "approved" : "rejected";
         data.decidedBy = decision.approver;
@@ -496,22 +507,27 @@ export class RedisBackend {
             await client.set("__health_check__", "ok", { ex: 1 });
             return true;
         }
-        catch {
+        catch (error) {
+            logger.debug("Redis health check failed", { error });
             return false;
         }
     }
-    destroy() {
+    async destroy() {
         if (this.client) {
-            if (typeof this.client.quit === "function")
-                this.client.quit();
-            else if (typeof this.client.disconnect === "function")
-                this.client.disconnect();
+            try {
+                if (typeof this.client.quit === "function")
+                    await this.client.quit();
+                else if (typeof this.client.disconnect === "function")
+                    await this.client.disconnect();
+            }
+            catch {
+                // Ignore errors during cleanup — connection may already be closed
+            }
             this.client = null;
         }
         this.connectionPromise = null;
         this.initialized = false;
         if (this.config.debug)
             logger.debug("[RedisBackend] Destroyed");
-        return Promise.resolve();
     }
 }