@brightsideoy/kama 0.1.0-alpha.149 → 0.1.0-alpha.151

package/templates/astro-starter/middleware/api-purge.ts

@@ -1,130 +0,0 @@
-import { defineMiddleware } from "astro:middleware";
-import { env } from "cloudflare:workers";
-
-export const apiPurgeMiddleware = defineMiddleware(async (context, next) => {
-    const pathname = context.url.pathname;
-
-    // Bypass this middleware entirely if it's not a purge request
-    if (pathname !== "/api/purge" && pathname !== "/api/purge/") {
-        return next();
-    }
-
-    const locals = context.locals as any;
-    const cfContext = locals.cfContext;
-    const workerEnv = (typeof env !== "undefined" ? env : (process?.env || {})) as any;
-    const HTML_CACHE = workerEnv?.HTML_CACHE;
-
-    if (context.request.method !== "POST") {
-        return new Response(JSON.stringify({ error: "Method Not Allowed" }), { status: 405, headers: { "Content-Type": "application/json" } });
-    }
-
-    const authHeader = context.request.headers.get("Authorization");
-    const expectedToken = workerEnv.CLOUDFLARE_API_TOKEN;
-
-    if (!expectedToken || authHeader !== `Bearer ${expectedToken}`) {
-        return new Response(JSON.stringify({ error: "Unauthorized Token Mismatch" }), { status: 401, headers: { "Content-Type": "application/json" } });
-    }
-
-    try {
-        const body = await context.request.json();
-        const edgeCache = typeof caches !== "undefined" && caches.default ? caches.default : null;
-        const origin = context.url.origin;
-
-        // A. Purge Workers Caching Layer (Astro v6 cfContext)
-        if (typeof cfContext?.cache?.purge === 'function') {
-            try {
-                await cfContext.cache.purge({ purgeEverything: true });
-                console.log("✅ New Cloudflare Workers Cache Engine Purged");
-            } catch (e) {
-                console.error("❌ Failed to purge new Workers Cache Engine", e);
-            }
-        }
-
-        // B. Version-Based Instant Invalidation (0ms KV Write)
-        if (HTML_CACHE) {
-            try {
-                const now = Date.now().toString();
-
-                if (body.purge_everything) {
-                    await HTML_CACHE.put("site_version", now);
-                    console.log(`✅ [Version Tagging] Global site_version updated to ${now}`);
-                } else if (Array.isArray(body.urls) && body.urls.length > 0) {
-                    const purgeTasks = body.urls.map((targetUrl: string) => {
-                        const urlPath = new URL(targetUrl).pathname;
-                        const cleanPath = urlPath.replace(/\/$/, "") || "/";
-                        return HTML_CACHE.put(`v:${cleanPath}`, now);
-                    });
-                    await Promise.all(purgeTasks);
-                    console.log(`✅ [Version Tagging] Updated versions for ${body.urls.length} URLs`);
-                }
-            } catch (kvErr) {
-                console.error("❌ KV Version Tagging Error:", kvErr);
-            }
-        }
-
-        // C. Global Legacy Worker Cache Purge
-        if (body.purge_everything) {
-            if (edgeCache) {
-                const rootUrls = [origin, `${origin}/`, `${origin}/home`, `${origin}/home/`];
-                for (const url of rootUrls) await edgeCache.delete(new Request(url));
-            }
-            return new Response(JSON.stringify({ success: true, message: "All Worker Caches Purged" }), { status: 200, headers: { "Content-Type": "application/json" } });
-        }
-
-        // D. Surgical Legacy Worker Cache Purge
-        if (Array.isArray(body.urls) && body.urls.length > 0) {
-            const results = [];
-            for (const targetUrl of body.urls) {
-                const cleanUrl = targetUrl.split('?')[0];
-                const urlNoSlash = cleanUrl.replace(/\/$/, "");
-                const urlWithSlash = urlNoSlash + "/";
-                let p1 = false, p2 = false;
-
-                if (edgeCache) {
-                    p1 = await edgeCache.delete(new Request(urlNoSlash));
-                    p2 = await edgeCache.delete(new Request(urlWithSlash));
-                }
-                results.push({ url: targetUrl, purged: p1 || p2 });
-            }
-            return new Response(JSON.stringify({ success: true, message: "URLs processed", results }), { status: 200, headers: { "Content-Type": "application/json" } });
-        }
-
-        // E. Surgical Deletion for Deleted Pages
-        if (Array.isArray(body.deleted_urls) && body.deleted_urls.length > 0) {
-            const results: any[] = [];
-            const deleteTasks = body.deleted_urls.map(async (targetUrl: string) => {
-                const urlPath = new URL(targetUrl).pathname;
-                const cleanPath = urlPath.replace(/\/$/, "") || "/";
-                let purgedKv = false;
-
-                if (HTML_CACHE) {
-                    const [siteVer, pageVer] = await Promise.all([HTML_CACHE.get("site_version"), HTML_CACHE.get(`v:${cleanPath}`)]);
-                    if (siteVer || pageVer) {
-                        const activeCacheKey = `${cleanPath}:v:${siteVer || "1"}:${pageVer || "1"}`;
-                        await HTML_CACHE.delete(activeCacheKey);
-                        purgedKv = true;
-                    }
-                    await HTML_CACHE.delete(`v:${cleanPath}`);
-                }
-
-                const cleanUrl = targetUrl.split('?')[0];
-                const urlNoSlash = cleanUrl.replace(/\/$/, "");
-                let p1 = false, p2 = false;
-
-                if (edgeCache) {
-                    p1 = await edgeCache.delete(new Request(urlNoSlash));
-                    p2 = await edgeCache.delete(new Request(urlNoSlash + "/"));
-                }
-                results.push({ url: targetUrl, purgedKv, purgedLegacy: p1 || p2 });
-            });
-
-            await Promise.all(deleteTasks);
-            return new Response(JSON.stringify({ success: true, message: "Deleted URLs permanently removed", results }), { status: 200, headers: { "Content-Type": "application/json" } });
-        }
-
-        return new Response(JSON.stringify({ error: "Invalid payload format" }), { status: 400, headers: { "Content-Type": "application/json" } });
-
-    } catch (err: any) {
-        return new Response(JSON.stringify({ error: err.message }), { status: 500, headers: { "Content-Type": "application/json" } });
-    }
-});

package/templates/astro-starter/middleware/index.ts

@@ -1,10 +0,0 @@
-import { sequence } from "astro:middleware";
-import { apiPurgeMiddleware } from "./api-purge";
-import { kvCacheMiddleware } from "./kv-cache";
-import { responseHeadersMiddleware } from "./response-headers";
-
-export const onRequest = sequence(
-    apiPurgeMiddleware,
-    kvCacheMiddleware,
-    responseHeadersMiddleware
-);

package/templates/astro-starter/middleware/kv-cache.ts

@@ -1,76 +0,0 @@
-import { defineMiddleware } from "astro:middleware";
-import { env } from "cloudflare:workers";
-
-export const kvCacheMiddleware = defineMiddleware(async (context, next) => {
-    const pathname = context.url.pathname;
-    const locals = context.locals as any;
-    const cfContext = locals.cfContext;
-    const workerEnv = (typeof env !== "undefined" ? env : (process?.env || {})) as any;
-    const HTML_CACHE = workerEnv?.HTML_CACHE;
-
-    const isWarmer = context.request.headers.get("X-Cache-Warmer") === "true";
-    const isHtmlPage = !pathname.includes('.') && !pathname.startsWith('/api/');
-    const cleanLookupPath = pathname.replace(/\/$/, "") || "/";
-
-    let activeCacheKey = cleanLookupPath;
-
-    // 🎯 1. READ PHASE
-    if (isHtmlPage && HTML_CACHE && !isWarmer) {
-        try {
-            const [siteVer, pageVer] = await Promise.all([
-                HTML_CACHE.get("site_version"),
-                HTML_CACHE.get(`v:${cleanLookupPath}`)
-            ]);
-
-            activeCacheKey = `${cleanLookupPath}:v:${siteVer || "1"}:${pageVer || "1"}`;
-
-            const cachedHtml = await HTML_CACHE.get(activeCacheKey);
-            if (cachedHtml) {
-                return new Response(cachedHtml, {
-                    status: 200,
-                    headers: {
-                        "Content-Type": "text/html; charset=utf-8",
-                        "X-Cache-Status": "HIT-KV-STATICFILE",
-                        "X-Cache-Key": activeCacheKey,
-                        "Cache-Control": "no-store, no-cache, must-revalidate, proxy-revalidate"
-                    }
-                });
-            }
-        } catch (e) {
-            console.warn("[KV Cache] Lookup bypassed:", e);
-        }
-    }
-
-    // Process downstream SSR route
-    const response = await next();
-
-    // 🎯 2. WRITE PHASE
-    if (
-        isHtmlPage &&
-        HTML_CACHE &&
-        response.status === 200 &&
-        response.headers.get("content-type")?.includes("text/html")
-    ) {
-        const htmlText = await response.clone().text();
-
-        const writeTask = (async () => {
-            if (activeCacheKey === cleanLookupPath || isWarmer) {
-                const forcedVersion = Date.now().toString();
-                await HTML_CACHE.put(`v:${cleanLookupPath}`, forcedVersion);
-                const siteVer = await HTML_CACHE.get("site_version") || "1";
-                activeCacheKey = `${cleanLookupPath}:v:${siteVer}:${forcedVersion}`;
-            }
-
-            await HTML_CACHE.put(activeCacheKey, htmlText);
-            console.log(`✅ [KV Cache] Saved HTML under key: ${activeCacheKey}`);
-        })();
-
-        if (cfContext && typeof cfContext.waitUntil === 'function') {
-            cfContext.waitUntil(writeTask);
-        } else {
-            writeTask.catch((e: any) => console.error("KV write error:", e));
-        }
-    }
-
-    return response;
-});

package/templates/astro-starter/middleware/response-headers.ts

@@ -1,43 +0,0 @@
-import { defineMiddleware } from "astro:middleware";
-
-export const responseHeadersMiddleware = defineMiddleware(async (context, next) => {
-    // Process downstream routes first so we have the response to modify
-    const response = await next();
-    const pathname = context.url.pathname;
-
-    // 1. LLMs & XML Configs
-    if (pathname === "/llms.txt" || pathname === "/llms-full.txt") {
-        response.headers.set("Content-Type", "text/plain; charset=utf-8");
-        response.headers.set("Cache-Control", "public, max-age=3600");
-        response.headers.set("Access-Control-Allow-Origin", "*");
-    }
-    else if (pathname === "/llxml.txt") {
-        response.headers.set("Content-Type", "application/xml; charset=utf-8");
-        response.headers.set("Cache-Control", "public, max-age=3600");
-        response.headers.set("Access-Control-Allow-Origin", "*");
-    }
-
-    // 2. Static Asset Caching
-    else if (
-        pathname.startsWith("/media/") ||
-        pathname.startsWith("/_image") ||
-        pathname.match(/\.(png|jpg|jpeg|webp|avif|svg|gif|ico|woff2?|css|js)$/i)
-    ) {
-        response.headers.set("Cache-Control", "public, max-age=31536000, s-maxage=31536000, immutable");
-        response.headers.set("Access-Control-Allow-Origin", "*");
-    }
-
-    // 3. Security Headers for HTML
-    if (response.headers.get("content-type")?.includes("text/html")) {
-        response.headers.set("Strict-Transport-Security", "max-age=31536000; includeSubDomains; preload");
-        response.headers.set("X-Frame-Options", "SAMEORIGIN");
-        response.headers.set("X-Content-Type-Options", "nosniff");
-        response.headers.set("Cross-Origin-Opener-Policy", "same-origin-allow-popups");
-        response.headers.set(
-            "Content-Security-Policy",
-            "default-src 'self' https: data: 'unsafe-inline' 'unsafe-eval'; img-src 'self' https: data: blob:; connect-src 'self' https:; frame-ancestors 'self';"
-        );
-    }
-
-    return response;
-});