@treeseed/core 0.4.13 → 0.5.2

package/dist/utils/web-cache.js

@@ -0,0 +1,149 @@
+import { EDITORIAL_PREVIEW_COOKIE } from "@treeseed/sdk/platform/published-content";
+import { getTreeseedDeployConfig } from "@treeseed/sdk/platform/plugins";
+const STATIC_FILE_PATTERN = /\.[a-z0-9]+$/i;
+const PRIVATE_PATH_PREFIXES = ["/api", "/auth", "/admin", "/app", "/internal"];
+const DEFAULT_LONG_LIVED_CACHE_POLICY = {
+  browserTtlSeconds: 0,
+  edgeTtlSeconds: 31536e3,
+  staleWhileRevalidateSeconds: 86400,
+  staleIfErrorSeconds: 86400
+};
+const DEFAULT_SOURCE_PAGE_PATHS = ["/", "/contact", "/404"];
+const CONTENT_INDEX_PATHS = /* @__PURE__ */ new Set([
+  "/agents",
+  "/books",
+  "/notes",
+  "/objectives",
+  "/proposals",
+  "/people",
+  "/decisions",
+  "/questions"
+]);
+function hasCookieHeader(request, cookieName) {
+  const cookieHeader = request.headers.get("cookie") ?? "";
+  return cookieHeader.includes(`${cookieName}=`);
+}
+function hasPreviewQuery(url) {
+  return url.searchParams.has("preview");
+}
+function isStaticAssetPath(pathname) {
+  return STATIC_FILE_PATTERN.test(pathname);
+}
+function isPrivatePath(pathname) {
+  return PRIVATE_PATH_PREFIXES.some(
+    (prefix) => pathname === prefix || pathname.startsWith(`${prefix}/`)
+  );
+}
+function normalizePath(pathname) {
+  if (!pathname || pathname === "/") {
+    return "/";
+  }
+  return pathname.replace(/\/+$/u, "");
+}
+function configuredSourcePagePaths() {
+  const configured = getTreeseedDeployConfig().surfaces?.web?.cache?.sourcePages?.paths;
+  return new Set((configured && configured.length ? configured : DEFAULT_SOURCE_PAGE_PATHS).map((entry) => normalizePath(entry)));
+}
+function isContentHtmlPath(pathname) {
+  const normalized = normalizePath(pathname);
+  if (CONTENT_INDEX_PATHS.has(normalized)) {
+    return true;
+  }
+  for (const prefix of CONTENT_INDEX_PATHS) {
+    if (normalized.startsWith(`${prefix}/`)) {
+      return true;
+    }
+  }
+  return normalized !== "/" && !configuredSourcePagePaths().has(normalized);
+}
+function classifyTreeseedWebRequest(request, url) {
+  if (!["GET", "HEAD"].includes(request.method)) {
+    return { kind: "api_no_cache", reason: "method" };
+  }
+  if (hasPreviewQuery(url)) {
+    return { kind: "preview_no_cache", reason: "preview_query" };
+  }
+  if (hasCookieHeader(request, EDITORIAL_PREVIEW_COOKIE)) {
+    return { kind: "preview_no_cache", reason: "preview_cookie" };
+  }
+  if (isPrivatePath(url.pathname)) {
+    if (normalizePath(url.pathname) === "/api" || normalizePath(url.pathname).startsWith("/api/")) {
+      return { kind: "api_no_cache", reason: "api_path" };
+    }
+    return { kind: "private_no_cache", reason: "private_path" };
+  }
+  if (isStaticAssetPath(url.pathname)) {
+    return { kind: "static_asset" };
+  }
+  if (configuredSourcePagePaths().has(normalizePath(url.pathname))) {
+    return { kind: "source_page_html" };
+  }
+  return isContentHtmlPath(url.pathname) ? { kind: "content_page_html" } : { kind: "source_page_html" };
+}
+function isHtmlResponse(response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  return contentType.includes("text/html");
+}
+function responseSetsCookie(response) {
+  return response.headers.has("set-cookie");
+}
+function publicBrowserCacheControl(browserTtlSeconds) {
+  if (browserTtlSeconds <= 0) {
+    return "public, max-age=0, must-revalidate";
+  }
+  return `public, max-age=${browserTtlSeconds}, must-revalidate`;
+}
+function publicCdnCacheControl(edgeTtlSeconds, staleWhileRevalidateSeconds, staleIfErrorSeconds) {
+  return [
+    "public",
+    `s-maxage=${edgeTtlSeconds}`,
+    `stale-while-revalidate=${staleWhileRevalidateSeconds}`,
+    `stale-if-error=${staleIfErrorSeconds}`
+  ].join(", ");
+}
+function resolveWebCachePolicy() {
+  const cache = getTreeseedDeployConfig().surfaces?.web?.cache ?? {};
+  return {
+    sourcePages: {
+      browserTtlSeconds: cache.sourcePages?.browserTtlSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.browserTtlSeconds,
+      edgeTtlSeconds: cache.sourcePages?.edgeTtlSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.edgeTtlSeconds,
+      staleWhileRevalidateSeconds: cache.sourcePages?.staleWhileRevalidateSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.staleWhileRevalidateSeconds,
+      staleIfErrorSeconds: cache.sourcePages?.staleIfErrorSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.staleIfErrorSeconds
+    },
+    contentPages: {
+      browserTtlSeconds: cache.contentPages?.browserTtlSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.browserTtlSeconds,
+      edgeTtlSeconds: cache.contentPages?.edgeTtlSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.edgeTtlSeconds,
+      staleWhileRevalidateSeconds: cache.contentPages?.staleWhileRevalidateSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.staleWhileRevalidateSeconds,
+      staleIfErrorSeconds: cache.contentPages?.staleIfErrorSeconds ?? DEFAULT_LONG_LIVED_CACHE_POLICY.staleIfErrorSeconds
+    }
+  };
+}
+function applyTreeseedWebCacheHeaders(request, url, response) {
+  const classification = classifyTreeseedWebRequest(request, url);
+  if (classification.kind === "preview_no_cache" || classification.kind === "api_no_cache" || classification.kind === "private_no_cache") {
+    response.headers.set("Cache-Control", "no-store");
+    response.headers.set("CDN-Cache-Control", "no-store");
+    return response;
+  }
+  if (classification.kind === "static_asset") {
+    return response;
+  }
+  if (response.status !== 200 || !isHtmlResponse(response) || responseSetsCookie(response)) {
+    return response;
+  }
+  const policy = classification.kind === "source_page_html" ? resolveWebCachePolicy().sourcePages : resolveWebCachePolicy().contentPages;
+  response.headers.set("Cache-Control", publicBrowserCacheControl(policy.browserTtlSeconds));
+  response.headers.set(
+    "CDN-Cache-Control",
+    publicCdnCacheControl(
+      policy.edgeTtlSeconds,
+      policy.staleWhileRevalidateSeconds,
+      policy.staleIfErrorSeconds
+    )
+  );
+  return response;
+}
+export {
+  applyTreeseedWebCacheHeaders,
+  classifyTreeseedWebRequest
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/core",
-  "version": "0.4.13",
+  "version": "0.5.2",
   "description": "Treeseed integrated platform starter for Astro/Starlight web runtimes and Hono API runtimes.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -20,6 +20,7 @@
   "files": [
     "README.md",
     "dist",
+    "scripts/verify-driver.mjs",
     "tsconfigs",
     "templates",
     "style",
@@ -57,9 +58,9 @@
     "test": "npm run test:unit",
     "lint": "npm run fixtures:check && npm run starlight:patch && npm run build:dist",
     "verify:direct": "npm run release:verify",
-    "verify:local": "node --input-type=module -e \"process.env.TREESEED_VERIFY_DRIVER='direct'; await import('@treeseed/sdk/scripts/verify-driver')\"",
-    "verify:action": "node --input-type=module -e \"process.env.TREESEED_VERIFY_DRIVER='act'; await import('@treeseed/sdk/scripts/verify-driver')\"",
-    "verify": "node --input-type=module -e \"await import('@treeseed/sdk/scripts/verify-driver')\"",
+    "verify:local": "node --input-type=module -e \"process.env.TREESEED_VERIFY_DRIVER='direct'; await import('./scripts/verify-driver.mjs')\"",
+    "verify:action": "node --input-type=module -e \"process.env.TREESEED_VERIFY_DRIVER='act'; await import('./scripts/verify-driver.mjs')\"",
+    "verify": "node --input-type=module -e \"await import('./scripts/verify-driver.mjs')\"",
     "test:smoke": "node ./scripts/run-ts.mjs ./scripts/test-smoke.ts",
     "fixtures:resolve": "node ./scripts/run-ts.mjs ./scripts/fixture-tools.ts resolve",
     "fixtures:check": "node ./scripts/run-ts.mjs ./scripts/fixture-tools.ts check",
@@ -69,12 +70,12 @@
     "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
   },
   "dependencies": {
-    "@treeseed/sdk": "^0.4.13",
     "@astrojs/check": "^0.9.8",
     "@astrojs/cloudflare": "^12.6.13",
     "@astrojs/sitemap": "3.7.0",
     "@astrojs/starlight": "0.37.6",
     "@tailwindcss/vite": "^4.1.4",
+    "@treeseed/sdk": "^0.5.2",
     "astro": "^5.6.1",
     "esbuild": "^0.28.0",
     "hono": "^4.8.2",
@@ -83,8 +84,8 @@
     "rehype-katex": "^7.0.1",
     "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.1",
-    "remark-mdx": "^3.1.1",
     "remark-math": "^6.0.0",
+    "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",
     "remark-stringify": "^11.0.0",
     "tailwindcss": "^4.1.4",
@@ -197,6 +198,10 @@
       "types": "./dist/api/app.d.ts",
       "default": "./dist/api/app.js"
     },
+    "./launch": {
+      "types": "./dist/launch.d.ts",
+      "default": "./dist/launch.js"
+    },
     "./site-resources": {
       "types": "./dist/site-resources.d.ts",
       "default": "./dist/site-resources.js"

package/scripts/verify-driver.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+import { spawnSync } from 'node:child_process';
+
+function runDirectVerify() {
+	const result = spawnSync('npm', ['run', 'verify:direct'], {
+		cwd: process.cwd(),
+		env: process.env,
+		stdio: 'inherit',
+	});
+	process.exit(result.status ?? 1);
+}
+
+const entrypointCheckOnly = process.env.TREESEED_VERIFY_ENTRYPOINT_CHECK === 'true';
+
+try {
+	await import('@treeseed/sdk/scripts/verify-driver');
+	if (entrypointCheckOnly) {
+		process.exit(0);
+	}
+} catch (error) {
+	if (error && typeof error === 'object' && 'code' in error && error.code === 'ERR_MODULE_NOT_FOUND') {
+		if (entrypointCheckOnly) {
+			process.stderr.write('Treeseed core verify: @treeseed/sdk is required for verify entrypoint resolution.\n');
+			process.exit(1);
+		}
+		if (process.env.TREESEED_VERIFY_DRIVER === 'act') {
+			process.stderr.write('Treeseed core verify: `act` mode requires @treeseed/sdk to be installed.\n');
+			process.exit(1);
+		}
+		runDirectVerify();
+	}
+	throw error;
+}

package/templates/github/deploy.workflow.yml

@@ -98,7 +98,7 @@ jobs:
               while IFS= read -r path; do
                 [[ -z "${path}" ]] && continue
                 case "${path}" in
-                  src/content/*|content/*|books/*|docs/*|public/books/*|migrations/*)
+                  src/content/*|content/*|books/*|docs/*|migrations/*)
                     content_changed="true"
                     ;;
                   *)
@@ -287,6 +287,7 @@ __WORKING_DIRECTORY_BLOCK__
       TREESEED_RAILWAY_PROJECT_ID: ${{ vars.TREESEED_RAILWAY_PROJECT_ID }}
       TREESEED_RAILWAY_ENVIRONMENT_ID: ${{ vars.TREESEED_RAILWAY_ENVIRONMENT_ID }}
       TREESEED_RAILWAY_WORKER_SERVICE_ID: ${{ vars.TREESEED_RAILWAY_WORKER_SERVICE_ID }}
+      TREESEED_CONTENT_SERVING_MODE: published_runtime
       TREESEED_WORKFLOW_ACTION: deploy_code
       TREESEED_WORKFLOW_ENVIRONMENT: ${{ needs.classify.outputs.scope }}
       TREESEED_WORKFLOW_PROJECT: ${{ inputs.project_id || vars.TREESEED_PROJECT_ID }}
@@ -294,6 +295,15 @@ __WORKING_DIRECTORY_BLOCK__
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          submodules: false
+          sparse-checkout: |
+            /*
+            !/src/content/
+            !/src/content/**
+            !/public/books/
+            !/public/books/**
+          sparse-checkout-cone-mode: false
 
       - name: Setup Node
         uses: actions/setup-node@v4