@revealui/core 0.2.1 → 0.5.0

package/dist/caching/cdn-config.d.ts

@@ -1,155 +0,0 @@
-/**
- * CDN Configuration and Cache Management
- *
- * Utilities for CDN caching, edge caching, and cache invalidation
- */
-/**
- * CDN Cache Configuration
- */
-export interface CDNCacheConfig {
-    provider?: 'cloudflare' | 'vercel' | 'fastly' | 'custom';
-    zones?: string[];
-    ttl?: number;
-    staleWhileRevalidate?: number;
-    staleIfError?: number;
-    bypassCache?: boolean;
-    cacheKey?: string[];
-    varyHeaders?: string[];
-}
-export declare const DEFAULT_CDN_CONFIG: CDNCacheConfig;
-/**
- * Generate Cache-Control header
- */
-export declare function generateCacheControl(config: {
-    maxAge?: number;
-    sMaxAge?: number;
-    staleWhileRevalidate?: number;
-    staleIfError?: number;
-    public?: boolean;
-    private?: boolean;
-    immutable?: boolean;
-    noCache?: boolean;
-    noStore?: boolean;
-}): string;
-/**
- * Cache presets for different asset types
- */
-export declare const CDN_CACHE_PRESETS: {
-    readonly immutable: {
-        readonly maxAge: 31536000;
-        readonly sMaxAge: 31536000;
-        readonly public: true;
-        readonly immutable: true;
-    };
-    readonly static: {
-        readonly maxAge: 2592000;
-        readonly sMaxAge: 31536000;
-        readonly staleWhileRevalidate: 86400;
-        readonly public: true;
-    };
-    readonly api: {
-        readonly maxAge: 0;
-        readonly sMaxAge: 60;
-        readonly staleWhileRevalidate: 30;
-        readonly public: true;
-    };
-    readonly page: {
-        readonly maxAge: 0;
-        readonly sMaxAge: 300;
-        readonly staleWhileRevalidate: 60;
-        readonly public: true;
-    };
-    readonly private: {
-        readonly maxAge: 300;
-        readonly private: true;
-        readonly staleWhileRevalidate: 60;
-    };
-    readonly noCache: {
-        readonly noStore: true;
-    };
-    readonly revalidate: {
-        readonly maxAge: 0;
-        readonly sMaxAge: 0;
-        readonly noCache: true;
-    };
-};
-/**
- * CDN Purge Configuration
- */
-export interface CDNPurgeConfig {
-    provider: 'cloudflare' | 'vercel' | 'fastly';
-    apiKey?: string;
-    apiSecret?: string;
-    zoneId?: string;
-    distributionId?: string;
-}
-/**
- * Purge CDN cache
- */
-export declare function purgeCDNCache(urls: string[], config: CDNPurgeConfig): Promise<{
-    success: boolean;
-    purged: number;
-    errors?: string[];
-}>;
-/**
- * Purge by cache tag
- */
-export declare function purgeCacheByTag(tags: string[], config: CDNPurgeConfig): Promise<{
-    success: boolean;
-    purged: number;
-    errors?: string[];
-}>;
-/**
- * Purge everything
- */
-export declare function purgeAllCache(config: CDNPurgeConfig): Promise<{
-    success: boolean;
-    errors?: string[];
-}>;
-/**
- * CDN cache warming
- */
-export declare function warmCDNCache(urls: string[], options?: {
-    concurrency?: number;
-    headers?: Record<string, string>;
-}): Promise<{
-    warmed: number;
-    failed: number;
-    errors: string[];
-}>;
-/**
- * Generate cache tags
- */
-export declare function generateCacheTags(resource: {
-    type: string;
-    id?: string | number;
-    related?: string[];
-}): string[];
-/**
- * Edge cache configuration for Vercel
- */
-export declare function generateVercelCacheConfig(preset: keyof typeof CDN_CACHE_PRESETS): {
-    headers: {
-        'Cache-Control': string;
-        'CDN-Cache-Control': string;
-        'Vercel-CDN-Cache-Control': string;
-    };
-};
-/**
- * Edge cache configuration for Cloudflare
- */
-export declare function generateCloudflareConfig(preset: keyof typeof CDN_CACHE_PRESETS, options?: {
-    cacheTags?: string[];
-    bypassOnCookie?: string;
-}): {
-    headers: Record<string, string>;
-};
-/**
- * Check if response should be cached
- */
-export declare function shouldCacheResponse(status: number, headers: Headers): boolean;
-/**
- * Calculate cache TTL from headers
- */
-export declare function getCacheTTL(headers: Headers): number;
-//# sourceMappingURL=cdn-config.d.ts.map

package/dist/caching/cdn-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cdn-config.d.ts","sourceRoot":"","sources":["../../src/caching/cdn-config.ts"],"names":[],"mappings":"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"}

package/dist/caching/cdn-config.js

@@ -1,411 +0,0 @@
-/**
- * CDN Configuration and Cache Management
- *
- * Utilities for CDN caching, edge caching, and cache invalidation
- */
-export const DEFAULT_CDN_CONFIG = {
-    provider: 'vercel',
-    ttl: 31536000, // 1 year for static assets
-    staleWhileRevalidate: 86400, // 1 day
-    staleIfError: 604800, // 1 week
-    bypassCache: false,
-    cacheKey: ['url', 'headers.accept', 'headers.accept-encoding'],
-    varyHeaders: ['Accept', 'Accept-Encoding'],
-};
-/**
- * Generate Cache-Control header
- */
-export function generateCacheControl(config) {
-    const directives = [];
-    // Visibility
-    if (config.noStore) {
-        directives.push('no-store');
-        return directives.join(', ');
-    }
-    if (config.noCache) {
-        directives.push('no-cache');
-        return directives.join(', ');
-    }
-    if (config.public) {
-        directives.push('public');
-    }
-    else if (config.private) {
-        directives.push('private');
-    }
-    // Max age
-    if (config.maxAge !== undefined) {
-        directives.push(`max-age=${config.maxAge}`);
-    }
-    // Shared max age (CDN)
-    if (config.sMaxAge !== undefined) {
-        directives.push(`s-maxage=${config.sMaxAge}`);
-    }
-    // Stale-while-revalidate
-    if (config.staleWhileRevalidate !== undefined) {
-        directives.push(`stale-while-revalidate=${config.staleWhileRevalidate}`);
-    }
-    // Stale-if-error
-    if (config.staleIfError !== undefined) {
-        directives.push(`stale-if-error=${config.staleIfError}`);
-    }
-    // Immutable
-    if (config.immutable) {
-        directives.push('immutable');
-    }
-    return directives.join(', ');
-}
-/**
- * Cache presets for different asset types
- */
-export const CDN_CACHE_PRESETS = {
-    // Static assets with hashed filenames (immutable)
-    immutable: {
-        maxAge: 31536000, // 1 year
-        sMaxAge: 31536000,
-        public: true,
-        immutable: true,
-    },
-    // Static assets (images, fonts)
-    static: {
-        maxAge: 2592000, // 30 days
-        sMaxAge: 31536000, // 1 year on CDN
-        staleWhileRevalidate: 86400, // 1 day
-        public: true,
-    },
-    // API responses (short-lived)
-    api: {
-        maxAge: 0,
-        sMaxAge: 60, // 1 minute on CDN
-        staleWhileRevalidate: 30,
-        public: true,
-    },
-    // HTML pages (dynamic)
-    page: {
-        maxAge: 0,
-        sMaxAge: 300, // 5 minutes on CDN
-        staleWhileRevalidate: 60,
-        public: true,
-    },
-    // User-specific data
-    private: {
-        maxAge: 300, // 5 minutes
-        private: true,
-        staleWhileRevalidate: 60,
-    },
-    // No caching
-    noCache: {
-        noStore: true,
-    },
-    // Revalidate every request
-    revalidate: {
-        maxAge: 0,
-        sMaxAge: 0,
-        noCache: true,
-    },
-};
-/**
- * Purge CDN cache
- */
-export async function purgeCDNCache(urls, config) {
-    const { provider } = config;
-    switch (provider) {
-        case 'cloudflare':
-            return purgeCloudflare(urls, config);
-        case 'vercel':
-            return purgeVercel(urls, config);
-        case 'fastly':
-            return purgeFastly(urls, config);
-        default:
-            throw new Error(`Unsupported CDN provider: ${provider}`);
-    }
-}
-/**
- * Purge Cloudflare cache
- */
-async function purgeCloudflare(urls, config) {
-    const { apiKey, zoneId } = config;
-    if (!(apiKey && zoneId)) {
-        throw new Error('Cloudflare API key and zone ID required');
-    }
-    try {
-        const response = await fetch(`https://api.cloudflare.com/client/v4/zones/${zoneId}/purge_cache`, {
-            method: 'POST',
-            headers: {
-                Authorization: `Bearer ${apiKey}`,
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({ files: urls }),
-        });
-        const data = await response.json();
-        return {
-            success: data.success,
-            purged: urls.length,
-            errors: data.errors,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            purged: 0,
-            errors: [error instanceof Error ? error.message : 'Unknown error'],
-        };
-    }
-}
-/**
- * Purge Vercel cache
- */
-async function purgeVercel(urls, config) {
-    const { apiKey } = config;
-    if (!apiKey) {
-        throw new Error('Vercel API token required');
-    }
-    try {
-        const response = await fetch('https://api.vercel.com/v1/purge', {
-            method: 'POST',
-            headers: {
-                Authorization: `Bearer ${apiKey}`,
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({ urls }),
-        });
-        const data = await response.json();
-        return {
-            success: response.ok,
-            purged: urls.length,
-            errors: data.error ? [data.error.message] : undefined,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            purged: 0,
-            errors: [error instanceof Error ? error.message : 'Unknown error'],
-        };
-    }
-}
-/**
- * Purge Fastly cache
- */
-async function purgeFastly(urls, config) {
-    const { apiKey } = config;
-    if (!apiKey) {
-        throw new Error('Fastly API key required');
-    }
-    try {
-        const results = await Promise.all(urls.map(async (url) => {
-            const response = await fetch(url, {
-                method: 'PURGE',
-                headers: {
-                    'Fastly-Key': apiKey,
-                },
-            });
-            return response.ok;
-        }));
-        const purged = results.filter(Boolean).length;
-        return {
-            success: purged === urls.length,
-            purged,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            purged: 0,
-            errors: [error instanceof Error ? error.message : 'Unknown error'],
-        };
-    }
-}
-/**
- * Purge by cache tag
- */
-export async function purgeCacheByTag(tags, config) {
-    const { provider, apiKey, zoneId } = config;
-    if (provider === 'cloudflare') {
-        if (!(apiKey && zoneId)) {
-            throw new Error('Cloudflare API key and zone ID required');
-        }
-        try {
-            const response = await fetch(`https://api.cloudflare.com/client/v4/zones/${zoneId}/purge_cache`, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${apiKey}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({ tags }),
-            });
-            const data = await response.json();
-            return {
-                success: data.success,
-                purged: tags.length,
-                errors: data.errors,
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                purged: 0,
-                errors: [error instanceof Error ? error.message : 'Unknown error'],
-            };
-        }
-    }
-    throw new Error(`Cache tag purging not supported for ${provider}`);
-}
-/**
- * Purge everything
- */
-export async function purgeAllCache(config) {
-    const { provider, apiKey, zoneId } = config;
-    if (provider === 'cloudflare') {
-        if (!(apiKey && zoneId)) {
-            throw new Error('Cloudflare API key and zone ID required');
-        }
-        try {
-            const response = await fetch(`https://api.cloudflare.com/client/v4/zones/${zoneId}/purge_cache`, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${apiKey}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({ purge_everything: true }),
-            });
-            const data = await response.json();
-            return {
-                success: data.success,
-                errors: data.errors,
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                errors: [error instanceof Error ? error.message : 'Unknown error'],
-            };
-        }
-    }
-    throw new Error(`Purge all not supported for ${provider}`);
-}
-/**
- * CDN cache warming
- */
-export async function warmCDNCache(urls, options = {}) {
-    const { concurrency = 5, headers = {} } = options;
-    const results = [];
-    const chunks = [];
-    // Split into chunks
-    for (let i = 0; i < urls.length; i += concurrency) {
-        chunks.push(urls.slice(i, i + concurrency));
-    }
-    // Warm cache in chunks
-    for (const chunk of chunks) {
-        const chunkResults = await Promise.all(chunk.map(async (url) => {
-            try {
-                const response = await fetch(url, { headers });
-                return {
-                    success: response.ok,
-                    error: response.ok ? undefined : `${response.status} ${response.statusText}`,
-                };
-            }
-            catch (error) {
-                return {
-                    success: false,
-                    error: error instanceof Error ? error.message : 'Unknown error',
-                };
-            }
-        }));
-        results.push(...chunkResults);
-    }
-    const warmed = results.filter((r) => r.success).length;
-    const failed = results.filter((r) => !r.success).length;
-    const errors = results.flatMap((r) => (r.error ? [r.error] : []));
-    return { warmed, failed, errors };
-}
-/**
- * Generate cache tags
- */
-export function generateCacheTags(resource) {
-    const tags = [];
-    // Type tag
-    tags.push(resource.type);
-    // ID tag
-    if (resource.id) {
-        tags.push(`${resource.type}:${resource.id}`);
-    }
-    // Related tags
-    if (resource.related) {
-        tags.push(...resource.related);
-    }
-    return tags;
-}
-/**
- * Edge cache configuration for Vercel
- */
-export function generateVercelCacheConfig(preset) {
-    const config = CDN_CACHE_PRESETS[preset];
-    const cacheControl = generateCacheControl(config);
-    return {
-        headers: {
-            'Cache-Control': cacheControl,
-            'CDN-Cache-Control': cacheControl,
-            'Vercel-CDN-Cache-Control': cacheControl,
-        },
-    };
-}
-/**
- * Edge cache configuration for Cloudflare
- */
-export function generateCloudflareConfig(preset, options = {}) {
-    const config = CDN_CACHE_PRESETS[preset];
-    const cacheControl = generateCacheControl(config);
-    const headers = {
-        'Cache-Control': cacheControl,
-    };
-    // Cache tags
-    if (options.cacheTags && options.cacheTags.length > 0) {
-        headers['Cache-Tag'] = options.cacheTags.join(',');
-    }
-    // Bypass on cookie
-    if (options.bypassOnCookie) {
-        headers['Cache-Control'] = `${cacheControl}, bypass=${options.bypassOnCookie}`;
-    }
-    return { headers };
-}
-/**
- * Check if response should be cached
- */
-export function shouldCacheResponse(status, headers) {
-    // Don't cache errors
-    if (status >= 400) {
-        return false;
-    }
-    // Check Cache-Control header
-    const cacheControl = headers.get('cache-control') || '';
-    if (cacheControl.includes('no-store') ||
-        cacheControl.includes('no-cache') ||
-        cacheControl.includes('private')) {
-        return false;
-    }
-    return true;
-}
-/**
- * Calculate cache TTL from headers
- */
-export function getCacheTTL(headers) {
-    const cacheControl = headers.get('cache-control') || '';
-    // Check s-maxage first (CDN)
-    const sMaxAgeMatch = cacheControl.match(/s-maxage=(\d+)/);
-    if (sMaxAgeMatch?.[1]) {
-        return parseInt(sMaxAgeMatch[1], 10);
-    }
-    // Check max-age
-    const maxAgeMatch = cacheControl.match(/max-age=(\d+)/);
-    if (maxAgeMatch?.[1]) {
-        return parseInt(maxAgeMatch[1], 10);
-    }
-    // Check Expires header
-    const expires = headers.get('expires');
-    if (expires) {
-        const expiresDate = new Date(expires);
-        const now = new Date();
-        return Math.max(0, Math.floor((expiresDate.getTime() - now.getTime()) / 1000));
-    }
-    return 0;
-}