@authhero/proxy 0.4.5 → 0.5.1

package/dist/types/data-plane/cache-adapter-cache.d.ts

@@ -0,0 +1,39 @@
+import type { CacheAdapter } from "@authhero/adapter-interfaces";
+import type { HostResolverCache } from "./cache";
+export interface CacheAdapterHostCacheOptions {
+    upstream: HostResolverCache;
+    cache: CacheAdapter;
+    freshTtlMs: number;
+    staleTtlMs?: number;
+    negativeTtlMs?: number;
+    keyPrefix?: string;
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+/**
+ * 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.
+ *
+ * Typical use on Cloudflare Workers:
+ *
+ * ```ts
+ * import { createCloudflareCache } from "@authhero/cloudflare-adapter";
+ * import { createCacheAdapterHostCache, createInMemoryHostCache } from "@authhero/proxy";
+ *
+ * const cache = createCloudflareCache({ cacheName: "authhero-proxy-hosts" });
+ * const resolver = createCacheAdapterHostCache({
+ *   upstream: createInMemoryHostCache(data, { freshTtlMs: 60_000 }),
+ *   cache,
+ *   freshTtlMs: 60 * 60_000,           // 1 hour fresh
+ *   staleTtlMs: 23 * 60 * 60_000,      // SWR for 23 more hours (24h total)
+ *   waitUntil: (p) => ctx.waitUntil(p),
+ * });
+ * ```
+ *
+ * Invalidation is the caller's responsibility — when a host's routes change,
+ * call `cache.delete(buildCacheAdapterKey(keyPrefix, host))` from the control
+ * plane. Otherwise entries expire on their own TTL.
+ */
+export declare function createCacheAdapterHostCache(options: CacheAdapterHostCacheOptions): HostResolverCache;
+export declare function buildCacheAdapterKey(keyPrefix: string, host: string): string;

package/dist/types/data-plane/cache-api-cache.d.ts

@@ -15,6 +15,11 @@ export interface CacheApiHostCacheOptions {
  * Invalidation is the caller's responsibility — typically the control plane
  * issues `cache.delete(syntheticKey(...))` on every proxy_route mutation,
  * and each colo's cache expires on its own TTL otherwise.
+ *
+ * @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, …).
  */
 export declare function createCacheApiHostCache(options: CacheApiHostCacheOptions): HostResolverCache;
 export declare function buildCacheApiKey(namespace: string, host: string): Request;

package/dist/types/http-adapter/index.d.ts

@@ -4,6 +4,7 @@ export interface HttpProxyAdapterOptions {
     clientId: string;
     clientSecret: string;
     audience?: string;
+    scope?: string;
     resolveHostPath?: string;
     tokenRefreshSkewSeconds?: number;
     timeoutMs?: number;

package/dist/types/index.d.ts

@@ -8,6 +8,8 @@ export { createInMemoryHostCache } from "./data-plane/cache";
 export type { HostCacheOptions, HostResolverCache } from "./data-plane/cache";
 export { createCacheApiHostCache, buildCacheApiKey, } from "./data-plane/cache-api-cache";
 export type { CacheApiHostCacheOptions } from "./data-plane/cache-api-cache";
+export { createCacheAdapterHostCache, buildCacheAdapterKey, } from "./data-plane/cache-adapter-cache";
+export type { CacheAdapterHostCacheOptions } from "./data-plane/cache-adapter-cache";
 export { HandlerRegistry, defineHandler } from "./data-plane/registry";
 export type { HandlerDefinition, HandlerBuildContext, } from "./data-plane/registry";
 export { registerBuiltinHandlers, corsHandler, basicAuthHandler, headersHandler, cacheHandler, forwardedHeadersHandler, rewriteCookiesHandler, rewriteLocationHandler, httpHandler, serviceBindingHandler, dispatchNamespaceHandler, redirectHandler, staticHandler, } from "./data-plane/handlers";
@@ -17,3 +19,4 @@ export { createStaticProxyAdapter, httpRoute } from "./static";
 export type { StaticProxyAdapterOptions, StaticHostConfig, StaticRouteInput, } from "./static";
 export { createHttpProxyAdapter } from "./http-adapter";
 export type { HttpProxyAdapterOptions } from "./http-adapter";
+export { PROXY_RESOLVE_HOST_SCOPE } from "./constants";

package/package.json

@@ -11,7 +11,7 @@
     "type": "git",
     "url": "https://github.com/markusahlstrand/authhero"
   },
-  "version": "0.4.5",
+  "version": "0.5.1",
   "files": [
     "dist"
   ],
@@ -39,7 +39,7 @@
     "hono": "^4.6.8"
   },
   "dependencies": {
-    "@authhero/adapter-interfaces": "3.0.0"
+    "@authhero/adapter-interfaces": "3.1.0"
   },
   "scripts": {
     "build": "vite build && tsc -p tsconfig.types.json && rollup -c rollup.dts.config.mjs",