@authhero/proxy 0.10.15 → 0.11.0

package/dist/proxy.d.ts

@@ -16,14 +16,21 @@ interface ResolvedHost {
  * its management API. `resolveHost` is the cross-tenant lookup the proxy data
  * plane needs on every incoming request — it maps a request `Host` header to
  * the owning tenant, custom domain, and route set.
+ *
+ * `options.signal` aborts when the caller's deadline fires. Implementations
+ * backed by cancellable I/O (fetch) should pass it through so the work stops;
+ * others may ignore it, and the caller's timeout still races them.
  */
 interface ProxyDataAdapter {
     proxyRoutes: ProxyRoutesAdapter;
-    resolveHost(host: string): Promise<ResolvedHost | null>;
+    resolveHost(host: string, options?: ResolveHostOptions): Promise<ResolvedHost | null>;
+}
+interface ResolveHostOptions {
+    signal?: AbortSignal;
 }
 
 interface HostResolverCache {
-    resolveHost(host: string): Promise<ResolvedHost | null>;
+    resolveHost(host: string, options?: ResolveHostOptions): Promise<ResolvedHost | null>;
 }
 interface HostCacheOptions {
     freshTtlMs: number;
@@ -436,4 +443,4 @@ declare function createKvProxyAdapter(options: KvProxyAdapterOptions): ProxyData
 declare const PROXY_RESOLVE_HOST_SCOPE = "proxy:resolve_host";
 
 export { DEFAULT_KV_HOST_KEY_PREFIX, FORWARDED_HEADERS_HANDLER_TYPE, HandlerRegistry, PROXY_RESOLVE_HOST_SCOPE, basicAuthHandler, buildCacheAdapterKey, buildCacheApiKey, buildKvHostKey, buildMatchFilter, cacheHandler, compileHostApp, corsHandler, createCacheAdapterHostCache, createCacheApiHostCache, createHttpProxyAdapter, createInMemoryHostCache, createKvProxyAdapter, createProxyApp, createProxyDataPlaneHandler, createProxyDataPlaneRouter, createServiceBindingFetch, createStaticProxyAdapter, defineHandler, dispatchNamespaceHandler, forwardedHeadersHandler, headersHandler, httpHandler, httpRoute, isCloudflareIp, matchesAnyHost, matchesHost, redirectHandler, registerBuiltinHandlers, rewriteCookiesHandler, rewriteLocationHandler, serviceBindingHandler, sortRoutes, staticHandler, withForwardedHeaders, withForwardedHeadersFor };
-export type { CacheAdapterHostCacheOptions, CacheApiHostCacheOptions, HandlerBuildContext, HandlerDefinition, HandlerSpecLike, HostCacheOptions, HostResolverCache, HttpProxyAdapterOptions, KvNamespaceReader, KvNamespaceWriter, KvProxyAdapterOptions, ProxyAppOptions, ProxyDataAdapter, ProxyDataPlaneOptions, ProxyRouteHandlerSpec, ResolvedHost, ServiceBindingFetcher, StaticHostConfig, StaticProxyAdapterOptions, StaticRouteInput };
+export type { CacheAdapterHostCacheOptions, CacheApiHostCacheOptions, HandlerBuildContext, HandlerDefinition, HandlerSpecLike, HostCacheOptions, HostResolverCache, HttpProxyAdapterOptions, KvNamespaceReader, KvNamespaceWriter, KvProxyAdapterOptions, ProxyAppOptions, ProxyDataAdapter, ProxyDataPlaneOptions, ProxyRouteHandlerSpec, ResolveHostOptions, ResolvedHost, ServiceBindingFetcher, StaticHostConfig, StaticProxyAdapterOptions, StaticRouteInput };