@authhero/proxy 0.5.1 → 0.6.0

package/dist/proxy.d.ts

@@ -28,6 +28,7 @@ interface HostResolverCache {
 interface HostCacheOptions {
     freshTtlMs: number;
     staleTtlMs?: number;
+    staleIfErrorTtlMs?: number;
     negativeTtlMs?: number;
     maxEntries?: number;
     waitUntil?: (promise: Promise<unknown>) => void;
@@ -60,6 +61,7 @@ interface ProxyAppOptions {
     resolver?: HostResolverCache;
     registry?: HandlerRegistry;
     bindings?: Record<string, unknown>;
+    resolveHostTimeoutMs?: number;
 }
 declare function createProxyApp(options: ProxyAppOptions): Hono;
 
@@ -70,6 +72,7 @@ interface ProxyDataPlaneOptions {
     resolver?: HostResolverCache;
     registry?: HandlerRegistry;
     bindings?: Record<string, unknown>;
+    resolveHostTimeoutMs?: number;
 }
 declare function createProxyDataPlaneHandler(options: ProxyDataPlaneOptions): (c: Context) => Promise<Response>;
 declare function createProxyDataPlaneRouter(options: ProxyDataPlaneOptions): Hono;
@@ -81,6 +84,8 @@ interface CacheApiHostCacheOptions {
     namespace?: string;
     cache?: Cache;
     waitUntil?: (promise: Promise<unknown>) => void;
+    cacheReadTimeoutMs?: number;
+    cacheWriteTimeoutMs?: number;
 }
 /**
  * Wraps an upstream `HostResolverCache` with a Cloudflare Cache-API layer.
@@ -93,8 +98,8 @@ interface CacheApiHostCacheOptions {
  *
  * @deprecated Prefer `createCacheAdapterHostCache` with `createCloudflareCache`
  * from `@authhero/cloudflare-adapter`. The adapter-based wrapper supports
- * stale-while-revalidate and works with any `CacheAdapter` (Cloudflare,
- * Redis, in-memory, …).
+ * stale-while-revalidate, stale-if-error, and works with any `CacheAdapter`
+ * (Cloudflare, Redis, in-memory, …).
  */
 declare function createCacheApiHostCache(options: CacheApiHostCacheOptions): HostResolverCache;
 declare function buildCacheApiKey(namespace: string, host: string): Request;
@@ -104,15 +109,19 @@ interface CacheAdapterHostCacheOptions {
     cache: CacheAdapter;
     freshTtlMs: number;
     staleTtlMs?: number;
+    staleIfErrorTtlMs?: number;
     negativeTtlMs?: number;
     keyPrefix?: string;
     waitUntil?: (promise: Promise<unknown>) => void;
+    cacheReadTimeoutMs?: number;
+    cacheWriteTimeoutMs?: number;
 }
 /**
  * Wraps an upstream `HostResolverCache` with a generic `CacheAdapter` layer.
- * Adds stale-while-revalidate semantics on top of any cache implementation
- * — Cloudflare Cache API (via `CloudflareCache` from `@authhero/cloudflare-adapter`),
- * Redis, in-memory, or anything else satisfying the `CacheAdapter` interface.
+ * Adds stale-while-revalidate and stale-if-error semantics on top of any
+ * cache implementation — Cloudflare Cache API (via `CloudflareCache` from
+ * `@authhero/cloudflare-adapter`), Redis, in-memory, or anything else
+ * satisfying the `CacheAdapter` interface.
  *
  * Typical use on Cloudflare Workers:
  *
@@ -126,6 +135,7 @@ interface CacheAdapterHostCacheOptions {
  *   cache,
  *   freshTtlMs: 60 * 60_000,           // 1 hour fresh
  *   staleTtlMs: 23 * 60 * 60_000,      // SWR for 23 more hours (24h total)
+ *   staleIfErrorTtlMs: 24 * 60 * 60_000, // serve last-known-good for one more day on upstream errors
  *   waitUntil: (p) => ctx.waitUntil(p),
  * });
  * ```
@@ -187,6 +197,7 @@ declare const serviceBindingHandler: HandlerDefinition<{
     binding: string;
     preserve_host: boolean;
     upstream_url?: string | undefined;
+    timeout_ms?: number | undefined;
 }>;
 
 declare const dispatchNamespaceHandler: HandlerDefinition<{
@@ -194,6 +205,7 @@ declare const dispatchNamespaceHandler: HandlerDefinition<{
     script_name: string;
     cpu_ms?: number | undefined;
     subrequests?: number | undefined;
+    timeout_ms?: number | undefined;
 }>;
 
 declare const redirectHandler: HandlerDefinition<{