@swell/apps-sdk 1.0.161 → 1.0.162

package/dist/src/cache/html-cache/html-cache-factory.d.ts

@@ -1,8 +1,9 @@
 import type { KVNamespace } from '@cloudflare/workers-types';
-import { HtmlCache } from './html-cache';
+import { HtmlCache, type CacheRules } from './html-cache';
 export type HtmlCacheEnv = {
     NAMESPACE?: KVNamespace;
     HTML_CACHE_EPOCH?: string;
     HTML_CACHE_BACKEND?: 'kv' | 'worker';
+    HTML_CACHE_RULES?: CacheRules;
 };
-export declare function getHtmlCache(env?: HtmlCacheEnv): HtmlCache | null;
+export declare function getHtmlCache(env?: HtmlCacheEnv, cacheRules?: CacheRules): HtmlCache | null;

package/dist/src/cache/html-cache/html-cache.d.ts

@@ -1,5 +1,33 @@
 import type { CacheBackend, CachedEntry } from './html-cache-backend';
-type DeploymentMode = 'live' | 'preview' | 'editor';
+/**
+ * Configuration for path-specific cache behavior.
+ * Paths support wildcards:
+ *   - * matches any characters except /
+ *   - ** matches any characters including /
+ * Examples: '/account/*', '/api/**', '*.json'
+ * First matching rule wins.
+ */
+export interface PathRule {
+    path: string;
+    ttl?: number;
+    swr?: number;
+    skip?: boolean;
+}
+export interface CacheRules {
+    defaults?: {
+        live?: {
+            ttl: number;
+            swr: number;
+        };
+        preview?: {
+            ttl: number;
+            swr: number;
+        };
+    };
+    pathRules?: PathRule[];
+}
+export declare const DEFAULT_CACHE_RULES: CacheRules;
+type DeploymentMode = 'live' | 'preview';
 export interface CacheResult {
     found: boolean;
     stale?: boolean;
@@ -18,13 +46,14 @@ export interface CacheResult {
 export declare class HtmlCache {
     protected epoch: string;
     protected backend: CacheBackend;
-    constructor(epoch: string, backend: CacheBackend);
+    protected cacheRules: CacheRules;
+    constructor(epoch: string, backend: CacheBackend, cacheRules?: CacheRules);
     get(request: Request): Promise<CacheResult | null>;
     getWithConditionals(request: Request): Promise<CacheResult | null>;
     put(request: Request, response: Response): Promise<void>;
     delete(requestOrKey: Request | string): Promise<void>;
-    isReadCacheCandidate(request: Request): boolean;
-    isWriteCacheCandidate(request: Request, response: Response): boolean;
+    canReadFromCache(request: Request): boolean;
+    canWriteToCache(request: Request, response: Response): boolean;
     createRevalidationRequest(request: Request): Request;
     protected buildClientResponse(entry: CachedEntry, isStale: boolean, age: number): Response;
     protected buildCacheKey(request: Request): string;
@@ -34,12 +63,19 @@ export declare class HtmlCache {
     protected sanitizeClientHeaders(headers: Headers): void;
     protected generateVersionHash(headers: Headers): string;
     protected extractSwellData(headers: Headers): Record<string, unknown>;
-    protected isCacheable(request: Request): boolean;
+    protected isRequestCacheable(request: Request): boolean;
     protected isResponseCacheable(response: Response): boolean;
     protected getDeploymentMode(headers: Headers): DeploymentMode;
     protected getTTLForRequest(request: Request): number;
     protected getSWRForRequest(request: Request): number;
     protected getEntryAge(entry: CachedEntry): number;
+    /**
+     * Converts wildcard pattern to regex and tests against path.
+     * - * matches any characters except /
+     * - ** matches any characters including /
+     */
+    protected pathMatches(pattern: string, path: string): boolean;
+    protected normalizeHeaders(headers: Headers): Record<string, string>;
     protected normalizeSearchParams(searchParams: URLSearchParams): string;
 }
 export {};

package/dist/src/cache/html-cache/index.d.ts

@@ -1,4 +1,4 @@
-export type { CacheResult } from './html-cache';
-export { HtmlCache } from './html-cache';
+export type { CacheResult, CacheRules, PathRule } from './html-cache';
+export { HtmlCache, DEFAULT_CACHE_RULES } from './html-cache';
 export { getHtmlCache } from './html-cache-factory';
 export type { HtmlCacheEnv } from './html-cache-factory';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@swell/apps-sdk",
   "type": "module",
-  "version": "1.0.161",
+  "version": "1.0.162",
   "description": "Swell SDK for building isomorphic apps.",
   "author": "Swell",
   "license": "MIT",