veryfront 0.0.82 → 0.0.83

package/esm/proxy/cache/resilient-cache.js

@@ -0,0 +1,178 @@
+/**
+ * Resilient Token Cache
+ *
+ * Wraps a primary cache (Redis) with a fallback cache (Memory).
+ * Automatically falls back to memory cache when Redis operations fail.
+ * Provides graceful degradation instead of hard failures.
+ */
+import { proxyLogger } from "../logger.js";
+import { withSpan } from "../tracing.js";
+const CIRCUIT_OPEN_DURATION_MS = 30_000; // 30 seconds
+const FAILURE_THRESHOLD = 3; // failures before circuit opens
+const logger = proxyLogger.child({ module: "cache" });
+export class ResilientCache {
+    primary;
+    fallback;
+    usingFallback = false;
+    failureCount = 0;
+    circuitOpenedAt = null;
+    constructor(primary, fallback) {
+        this.primary = primary;
+        this.fallback = fallback;
+    }
+    /**
+     * Check if we should try primary again after circuit was opened.
+     */
+    shouldTryPrimary() {
+        if (!this.usingFallback)
+            return true;
+        // If circuit was opened, check if enough time has passed
+        if (this.circuitOpenedAt) {
+            const elapsed = Date.now() - this.circuitOpenedAt;
+            if (elapsed >= CIRCUIT_OPEN_DURATION_MS) {
+                logger.info("[ResilientCache] Circuit half-open, trying primary again");
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Record a successful primary operation - reset failure state.
+     */
+    recordSuccess() {
+        if (this.usingFallback) {
+            logger.info("[ResilientCache] Primary recovered, switching back from fallback");
+            this.usingFallback = false;
+            this.failureCount = 0;
+            this.circuitOpenedAt = null;
+        }
+    }
+    /**
+     * Record a primary failure - may trigger fallback.
+     */
+    recordFailure(error) {
+        this.failureCount++;
+        logger.warn(`[ResilientCache] Primary cache error (${this.failureCount}/${FAILURE_THRESHOLD}):`, { error: error instanceof Error ? error.message : error });
+        if (this.failureCount >= FAILURE_THRESHOLD && !this.usingFallback) {
+            logger.warn("[ResilientCache] Opening circuit, switching to fallback cache");
+            this.usingFallback = true;
+            this.circuitOpenedAt = Date.now();
+        }
+    }
+    async get(key) {
+        return withSpan("cache.resilient.get", async () => {
+            // Try primary if circuit allows
+            if (this.shouldTryPrimary()) {
+                try {
+                    const result = await this.primary.get(key);
+                    this.recordSuccess();
+                    return result;
+                }
+                catch (error) {
+                    this.recordFailure(error);
+                    // Don't return here - try fallback
+                }
+            }
+            // Use fallback
+            return this.fallback.get(key);
+        }, { "cache.key": key, "cache.usingFallback": this.usingFallback });
+    }
+    async set(key, entry) {
+        return withSpan("cache.resilient.set", async () => {
+            // Always try to set in fallback (local cache)
+            await this.fallback.set(key, entry);
+            // Try primary if circuit allows
+            if (this.shouldTryPrimary()) {
+                try {
+                    await this.primary.set(key, entry);
+                    this.recordSuccess();
+                }
+                catch (error) {
+                    this.recordFailure(error);
+                    // Fallback already set above, no need to retry
+                }
+            }
+        }, { "cache.key": key, "cache.usingFallback": this.usingFallback });
+    }
+    async delete(key) {
+        return withSpan("cache.resilient.delete", async () => {
+            // Delete from both
+            await this.fallback.delete(key);
+            if (this.shouldTryPrimary()) {
+                try {
+                    await this.primary.delete(key);
+                    this.recordSuccess();
+                }
+                catch (error) {
+                    this.recordFailure(error);
+                }
+            }
+        }, { "cache.key": key });
+    }
+    async clear() {
+        return withSpan("cache.resilient.clear", async () => {
+            await this.fallback.clear();
+            if (this.shouldTryPrimary()) {
+                try {
+                    await this.primary.clear();
+                    this.recordSuccess();
+                }
+                catch (error) {
+                    this.recordFailure(error);
+                }
+            }
+        });
+    }
+    async has(key) {
+        return withSpan("cache.resilient.has", async () => {
+            if (this.shouldTryPrimary()) {
+                try {
+                    const result = await this.primary.has(key);
+                    this.recordSuccess();
+                    return result;
+                }
+                catch (error) {
+                    this.recordFailure(error);
+                }
+            }
+            return this.fallback.has(key);
+        }, { "cache.key": key });
+    }
+    async stats() {
+        return withSpan("cache.resilient.stats", async () => {
+            const fallbackStats = await this.fallback.stats();
+            if (this.shouldTryPrimary()) {
+                try {
+                    const primaryStats = await this.primary.stats();
+                    this.recordSuccess();
+                    return {
+                        ...primaryStats,
+                        type: this.usingFallback ? "memory" : "redis",
+                    };
+                }
+                catch (error) {
+                    this.recordFailure(error);
+                }
+            }
+            return {
+                ...fallbackStats,
+                type: "memory",
+            };
+        }, { "cache.usingFallback": this.usingFallback });
+    }
+    async close() {
+        return withSpan("cache.resilient.close", async () => {
+            await Promise.all([this.primary.close(), this.fallback.close()]);
+        });
+    }
+    /**
+     * Get current resilience status for debugging/health checks.
+     */
+    getStatus() {
+        return {
+            usingFallback: this.usingFallback,
+            failureCount: this.failureCount,
+            circuitOpenedAt: this.circuitOpenedAt,
+        };
+    }
+}

package/esm/proxy/cache/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Token Cache Interface
+ *
+ * Abstraction for storing OAuth tokens with TTL support.
+ * Implementations: MemoryCache, RedisCache
+ */
+export interface TokenCacheEntry {
+    token: string;
+    expiresAt: number;
+    scope: "preview" | "production";
+    projectSlug?: string;
+}
+export interface TokenCache {
+    /**
+     * Get a cached token entry.
+     */
+    get(key: string): Promise<TokenCacheEntry | null>;
+    /**
+     * Set a token entry with automatic TTL based on expiresAt.
+     */
+    set(key: string, entry: TokenCacheEntry): Promise<void>;
+    /**
+     * Delete a specific token entry.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all cached tokens.
+     */
+    clear(): Promise<void>;
+    /**
+     * Check if a key exists in cache.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Get cache statistics.
+     */
+    stats(): Promise<CacheStats>;
+    /**
+     * Close any connections (for Redis).
+     */
+    close(): Promise<void>;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    type: "memory" | "redis";
+}
+export interface MemoryCacheOptions {
+    maxSize?: number;
+    cleanupInterval?: number;
+}
+export interface RedisCacheOptions {
+    url: string;
+    prefix?: string;
+    connectTimeout?: number;
+}
+export type CacheOptions = {
+    type: "memory";
+    options?: MemoryCacheOptions;
+} | {
+    type: "redis";
+    options: RedisCacheOptions;
+};
+//# sourceMappingURL=types.d.ts.map

package/esm/proxy/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/proxy/cache/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC"}

package/esm/proxy/cache/types.js

@@ -0,0 +1,7 @@
+/**
+ * Token Cache Interface
+ *
+ * Abstraction for storing OAuth tokens with TTL support.
+ * Implementations: MemoryCache, RedisCache
+ */
+export {};

package/esm/proxy/handler.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Proxy Handler - Core Logic
+ *
+ * Extracted proxy logic that can be used in:
+ * - Split mode: Standalone proxy server (proxy/main.ts)
+ * - Combined mode: Request interceptor in renderer process
+ *
+ * Handles:
+ * - Domain parsing (subdomain to project slug)
+ * - OAuth token management
+ * - Local project detection
+ * - User auth token extraction from cookies
+ */
+import * as dntShim from "../_dnt.shims.js";
+import { type ParsedDomain } from "../src/server/utils/domain-parser.js";
+import type { TokenCache } from "./cache/types.js";
+export interface ProxyConfig {
+    apiBaseUrl: string;
+    clientId: string;
+    clientSecret: string;
+    previewClientId: string;
+    previewClientSecret: string;
+    apiToken?: string;
+    localProjects?: Record<string, string>;
+}
+export interface ProxyContext {
+    token?: string;
+    projectSlug?: string;
+    projectId?: string;
+    releaseId?: string;
+    branchId?: string;
+    branchName?: string;
+    environment: "preview" | "production";
+    contentSourceId: string;
+    localPath?: string;
+    host: string;
+    parsedDomain: ParsedDomain;
+    isLocalProject: boolean;
+    /** Error if request cannot be processed (e.g., custom domain not found) */
+    error?: {
+        status: number;
+        message: string;
+        redirectUrl?: string;
+    };
+}
+export interface ProxyLogger {
+    debug: (msg: string, extra?: Record<string, unknown>) => void;
+    info: (msg: string, extra?: Record<string, unknown>) => void;
+    warn: (msg: string, extra?: Record<string, unknown>) => void;
+    error: (msg: string, error?: Error, extra?: Record<string, unknown>) => void;
+}
+export interface ProxyHandlerOptions {
+    config: ProxyConfig;
+    cache?: TokenCache;
+    logger?: ProxyLogger;
+}
+/**
+ * Create a proxy handler that processes requests and returns context.
+ *
+ * This is the core proxy logic, usable in both split and combined modes.
+ */
+export declare function createProxyHandler(options: ProxyHandlerOptions): {
+    processRequest: (req: dntShim.Request) => Promise<ProxyContext>;
+    getTokenForApi: (req: dntShim.Request) => Promise<string | undefined>;
+    getStats: () => Promise<{
+        hits: number;
+        misses: number;
+        size: number;
+        type: string;
+    }>;
+    close: () => Promise<void>;
+    validateConfig: () => string[];
+    localProjects: Record<string, string>;
+};
+export type ProxyHandler = ReturnType<typeof createProxyHandler>;
+/**
+ * Inject proxy context into request headers for the renderer.
+ * Used by both split mode (proxy/main.ts) and combined mode (scripts/server.ts).
+ */
+export declare function injectContextHeaders(req: dntShim.Request, ctx: ProxyContext): dntShim.Request;
+//# sourceMappingURL=handler.d.ts.map

package/esm/proxy/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/proxy/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAI5C,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,sCAAsC,CAAC;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA0FnD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,GAAG,YAAY,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,2EAA2E;IAC3E,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC9D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC9E;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAiBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB;0BAkF1B,OAAO,CAAC,OAAO,KAAG,OAAO,CAAC,YAAY,CAAC;0BA8PvC,OAAO,CAAC,OAAO,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;;;;;;;;0BAzQrD,MAAM,EAAE;;EAmUpC;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAsB7F"}