@revealui/cache 0.1.5 → 0.2.1

package/README.md

@@ -75,7 +75,7 @@ Optional peer dependency: `next` (>=14.0.0)  -  required for ISR helpers.
 |--------|------|---------|
 | `configureCacheLogger` | Function | Set custom logger (defaults to console) |
 
-## JOSHUA Alignment
+## Design Principles
 
 - **Adaptive**: ISR presets scale from real-time (10s) to immutable (1y) based on content volatility
 - **Unified**: Cache tags follow the same taxonomy as CMS collections  -  invalidation is automatic

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { C as CacheStore } from './types-CmU1eRbl.js';
 export { a as CacheEntry } from './types-CmU1eRbl.js';
-import { NextRequest, NextResponse } from 'next/server';
 
 /**
  * CDN Configuration and Cache Management
@@ -160,14 +159,47 @@ declare function getCacheTTL(headers: Headers): number;
 /**
  * Edge Caching and ISR (Incremental Static Regeneration)
  *
- * Utilities for Next.js edge caching, ISR, and on-demand revalidation
+ * Framework-agnostic helpers for edge caching, ISR-style revalidation, edge
+ * rate limiting, geolocation, A/B testing, personalization, and CDN cache
+ * headers. Works in any runtime that exposes Web-standard `Request` /
+ * `Response` — NextRequest/NextResponse pass via structural typing, Hono's
+ * `c.req.raw` / `c.res` pass directly, Cloudflare Workers Request/Response
+ * pass directly, etc. The package no longer carries a `next` peer dep.
+ */
+/**
+ * Framework-agnostic request shape for edge-cache helpers — compatible with
+ * NextRequest, Hono `c.req.raw`, Cloudflare Workers Request, and any other
+ * Web-standard `Request` subclass that exposes a NextRequest-style `cookies`
+ * map. Narrowed to the read-only subset we actually consume.
+ *
+ * Consumers using a bare Web `Request` (no `cookies` field — e.g., plain
+ * `fetch` requests) must wrap it before calling helpers that read cookies
+ * (`getABTestVariant`, `getPersonalizationConfig`). Helpers that only read
+ * headers (`getGeoLocation`, `EdgeRateLimiter.check` with default key) work
+ * with bare `Request` directly via subtype compatibility.
+ */
+interface CacheRequest extends Request {
+    readonly cookies: {
+        get(name: string): {
+            readonly value: string;
+        } | undefined;
+    };
+}
+/**
+ * Framework-agnostic response shape for edge-cache helpers — compatible with
+ * NextResponse, Hono `c.res`, Cloudflare Workers Response, and any other
+ * Web-standard `Response` subclass. Helpers in this file only consume the
+ * standard `headers.set()` surface.
  */
-
+type CacheResponse = Response;
 /**
- * Next.js extends the standard RequestInit with a `next` property
- * for ISR revalidation and cache tags.
+ * Framework-agnostic ISR-style fetch options. Extends Web-standard
+ * `RequestInit` with a `next` property that mirrors Next.js's ISR
+ * revalidation + cache-tag shape. Runtimes that don't honor the `next`
+ * field (anything outside Next.js) ignore it silently — the helper still
+ * works as a plain `fetch` wrapper.
  */
-interface NextFetchRequestInit extends RequestInit {
+interface CachedFetchRequestInit extends RequestInit {
     next?: {
         revalidate?: number | false;
         tags?: string[];
@@ -254,9 +286,11 @@ interface EdgeCacheConfig {
 /**
  * Create edge cached fetch
  */
-declare function createEdgeCachedFetch(config?: EdgeCacheConfig): <T>(url: string, options?: NextFetchRequestInit) => Promise<T>;
+declare function createEdgeCachedFetch(config?: EdgeCacheConfig): <T>(url: string, options?: CachedFetchRequestInit) => Promise<T>;
 /**
- * Unstable cache wrapper (Next.js 14+)
+ * Memoizing cache wrapper for any async function. TTL-based eviction.
+ * Framework-agnostic — does NOT use Next.js's `unstable_cache`; this is
+ * a plain in-memory wrapper that works in any runtime.
  */
 declare function createCachedFunction<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>, options?: {
     tags?: string[];
@@ -268,7 +302,7 @@ declare function createCachedFunction<TArgs extends unknown[], TReturn>(fn: (...
 interface EdgeRateLimitConfig {
     limit: number;
     window: number;
-    key?: (request: NextRequest) => string;
+    key?: (request: CacheRequest) => string;
 }
 declare class EdgeRateLimiter {
     private config;
@@ -277,7 +311,7 @@ declare class EdgeRateLimiter {
     /**
      * Check rate limit
      */
-    check(request: NextRequest): {
+    check(request: CacheRequest): {
         allowed: boolean;
         limit: number;
         remaining: number;
@@ -298,11 +332,11 @@ interface GeoLocation {
     latitude?: number;
     longitude?: number;
 }
-declare function getGeoLocation(request: NextRequest): GeoLocation | null;
+declare function getGeoLocation(request: CacheRequest): GeoLocation | null;
 /**
  * Edge A/B testing with cache
  */
-declare function getABTestVariant(request: NextRequest, testName: string, variants: string[]): string;
+declare function getABTestVariant(request: CacheRequest, testName: string, variants: string[]): string;
 /**
  * Edge personalization cache
  */
@@ -313,25 +347,25 @@ interface PersonalizationConfig {
     device?: 'mobile' | 'tablet' | 'desktop';
     variant?: string;
 }
-declare function getPersonalizationConfig(request: NextRequest): PersonalizationConfig;
+declare function getPersonalizationConfig(request: CacheRequest): PersonalizationConfig;
 /**
  * Edge cache headers helper
  */
-declare function setEdgeCacheHeaders(response: NextResponse, config: {
+declare function setEdgeCacheHeaders(response: CacheResponse, config: {
     maxAge?: number;
     sMaxAge?: number;
     staleWhileRevalidate?: number;
     tags?: string[];
-}): NextResponse;
+}): CacheResponse;
 /**
  * Preload links for critical resources
  */
-declare function addPreloadLinks(response: NextResponse, resources: Array<{
+declare function addPreloadLinks(response: CacheResponse, resources: Array<{
     href: string;
     as: string;
     type?: string;
     crossorigin?: boolean;
-}>): NextResponse;
+}>): CacheResponse;
 /**
  * Cache warming for ISR pages
  */
@@ -445,4 +479,4 @@ declare function configureCacheLogger(logger: CacheLogger): void;
  */
 declare function getCacheLogger(): CacheLogger;
 
-export { type CDNCacheConfig, type CDNPurgeConfig, CDN_CACHE_PRESETS, CacheInvalidationChannel, type CacheLogger, CacheStore, DEFAULT_CDN_CONFIG, type EdgeCacheConfig, type EdgeRateLimitConfig, EdgeRateLimiter, type GeoLocation, type ISRConfig, ISR_PRESETS, type InvalidationChannelOptions, type InvalidationEvent, type InvalidationEventType, type PersonalizationConfig, addPreloadLinks, configureCacheLogger, createCachedFunction, createEdgeCachedFetch, generateCacheControl, generateCacheTags, generateCloudflareConfig, generateStaticParams, generateVercelCacheConfig, getABTestVariant, getCacheLogger, getCacheTTL, getGeoLocation, getPersonalizationConfig, purgeAllCache, purgeCDNCache, purgeCacheByTag, revalidatePath, revalidatePaths, revalidateTag, revalidateTags, setEdgeCacheHeaders, shouldCacheResponse, warmCDNCache, warmISRCache };
+export { type CDNCacheConfig, type CDNPurgeConfig, CDN_CACHE_PRESETS, CacheInvalidationChannel, type CacheLogger, type CacheRequest, type CacheResponse, CacheStore, DEFAULT_CDN_CONFIG, type EdgeCacheConfig, type EdgeRateLimitConfig, EdgeRateLimiter, type GeoLocation, type ISRConfig, ISR_PRESETS, type InvalidationChannelOptions, type InvalidationEvent, type InvalidationEventType, type PersonalizationConfig, addPreloadLinks, configureCacheLogger, createCachedFunction, createEdgeCachedFetch, generateCacheControl, generateCacheTags, generateCloudflareConfig, generateStaticParams, generateVercelCacheConfig, getABTestVariant, getCacheLogger, getCacheTTL, getGeoLocation, getPersonalizationConfig, purgeAllCache, purgeCDNCache, purgeCacheByTag, revalidatePath, revalidatePaths, revalidateTag, revalidateTags, setEdgeCacheHeaders, shouldCacheResponse, warmCDNCache, warmISRCache };

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@revealui/cache",
-  "version": "0.1.5",
-  "description": "CDN config, edge cache, ISR presets, and revalidation helpers for Vercel and Hono. Ships with RevealUI.",
+  "version": "0.2.1",
+  "description": "Framework-agnostic CDN config, edge cache, ISR-style presets, and revalidation helpers. Compatible with NextRequest/NextResponse, Hono, and Cloudflare Workers via structural typing — no `next` peer dep.",
   "license": "MIT",
   "dependencies": {
-    "@revealui/security": "0.3.1"
+    "@revealui/security": "0.4.0"
   },
   "devDependencies": {
-    "@electric-sql/pglite": "^0.4.4",
+    "@electric-sql/pglite": "^0.4.5",
     "@types/node": "^25.6.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
@@ -31,14 +31,6 @@
     "dist"
   ],
   "main": "./dist/index.js",
-  "peerDependencies": {
-    "next": "^14.0.0 || ^15.5.10 || ^16.2.3"
-  },
-  "peerDependenciesMeta": {
-    "next": {
-      "optional": true
-    }
-  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"