@cancia/astro 0.4.1 → 0.5.0

package/dist/cache.d.ts

@@ -0,0 +1,20 @@
+/** Prefix for every Cancia route cache tag. */
+declare const CANCIA_CACHE_TAG_PREFIX = "cancia:route:";
+/**
+ * Build the cache tag for a route. Normalises the input so the same page always
+ * yields the same tag regardless of how the route string was captured:
+ *   • strips a query string and hash fragment
+ *   • ensures a single leading "/"
+ *   • collapses to "/" for the root and strips the trailing slash otherwise
+ * then prefixes `cancia:route:`.
+ *
+ * Examples:
+ *   canciaCacheTag("/")              -> "cancia:route:/"
+ *   canciaCacheTag("/about/")        -> "cancia:route:/about"
+ *   canciaCacheTag("about")          -> "cancia:route:/about"
+ *   canciaCacheTag("/blog?page=2")   -> "cancia:route:/blog"
+ *   canciaCacheTag("/x#y")           -> "cancia:route:/x"
+ */
+declare function canciaCacheTag(route: string): string;
+
+export { CANCIA_CACHE_TAG_PREFIX, canciaCacheTag };

package/dist/cache.js

@@ -0,0 +1,8 @@
+import {
+  CANCIA_CACHE_TAG_PREFIX,
+  canciaCacheTag
+} from "./chunk-X6ZFFGIA.js";
+export {
+  CANCIA_CACHE_TAG_PREFIX,
+  canciaCacheTag
+};

package/dist/chunk-5RCLBWRH.js

@@ -0,0 +1,97 @@
+import {
+  createGitHubClient
+} from "./chunk-U7V53JX7.js";
+
+// src/publish-hook.ts
+async function firePublish(hook, opts = {}) {
+  if (!hook) return { ok: false, kind: "no-hook" };
+  const headers = { ...opts.headers ?? {} };
+  if (opts.token) headers.Authorization = `Bearer ${opts.token}`;
+  const init = { method: opts.method ?? "POST" };
+  if (Object.keys(headers).length > 0) init.headers = headers;
+  try {
+    const res = await fetch(hook, init);
+    if (!res.ok) return { ok: false, kind: "bad-response", status: res.status };
+    return { ok: true };
+  } catch {
+    return { ok: false, kind: "unreachable" };
+  }
+}
+
+// src/publish-dispatch.ts
+var CANCIA_PUBLISH_EVENT = "cancia-publish";
+async function fireDispatch(opts) {
+  if (!opts.repo || !opts.token) return { ok: false, kind: "not-configured" };
+  const client = createGitHubClient({
+    repo: opts.repo,
+    // branch is irrelevant for dispatch (repo-level event) but required by the
+    // client's options — a harmless placeholder.
+    branch: "main",
+    token: opts.token,
+    fetch: opts.fetch,
+    apiBase: opts.apiBase
+  });
+  try {
+    await client.dispatch(opts.eventType ?? CANCIA_PUBLISH_EVENT, opts.clientPayload);
+    return { ok: true };
+  } catch {
+    return { ok: false, kind: "failed" };
+  }
+}
+
+// src/publish-modes.ts
+function json(body, status = 200) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+async function runPublish(cfg) {
+  const mode = cfg.mode;
+  if (mode === "live" || mode === "invalidate") {
+    return json({ ok: true, mode });
+  }
+  if (mode === "redeploy") {
+    return runRedeploy(cfg.hook, cfg.hookOptions);
+  }
+  if (mode === "dispatch") {
+    return runDispatch(cfg.repo, cfg.githubToken);
+  }
+  if (cfg.repo && cfg.githubToken) {
+    return runDispatch(cfg.repo, cfg.githubToken);
+  }
+  return runRedeploy(cfg.hook, cfg.hookOptions);
+}
+async function runRedeploy(hook, hookOptions) {
+  const result = await firePublish(hook, hookOptions);
+  if (result.ok) return json({ ok: true });
+  if (result.kind === "no-hook") {
+    return json(
+      {
+        error: "No publish mechanism configured. Set a publish repo + CANCIA_GITHUB_TOKEN, or CANCIA_DEPLOY_HOOK."
+      },
+      503
+    );
+  }
+  if (result.kind === "bad-response") {
+    return json({ error: `Deploy hook responded with ${result.status}` }, 502);
+  }
+  return json({ error: "Failed to reach deploy hook" }, 502);
+}
+async function runDispatch(repo, token) {
+  if (!repo || !token) {
+    return json(
+      {
+        error: "No publish mechanism configured. Set a publish repo + CANCIA_GITHUB_TOKEN, or CANCIA_DEPLOY_HOOK."
+      },
+      503
+    );
+  }
+  const dispatched = await fireDispatch({ repo, token });
+  if (dispatched.ok) return json({ ok: true });
+  return json({ error: "GitHub repository_dispatch failed" }, 502);
+}
+
+export {
+  runPublish
+};

package/dist/{chunk-AE4SIY24.js → chunk-CJDIVWO3.js}

@@ -1,9 +1,12 @@
 // src/storage/sqlite.ts
 import { createRequire } from "module";
+import { mkdirSync } from "fs";
+import { dirname } from "path";
 var require2 = createRequire(import.meta.url);
 var _db = null;
 function createDB(dbPath) {
   const Database = require2("better-sqlite3");
+  if (dbPath !== ":memory:") mkdirSync(dirname(dbPath), { recursive: true });
   const sqlite = new Database(dbPath);
   sqlite.pragma("journal_mode = WAL");
   sqlite.exec(`

package/dist/{chunk-5AUIPW2I.js → chunk-GNWD7EL2.js}

@@ -11,9 +11,12 @@ import {
 // src/storage/sqlite-v2.ts
 import { createRequire } from "module";
 import { randomUUID } from "crypto";
+import { mkdirSync } from "fs";
+import { dirname } from "path";
 var require2 = createRequire(import.meta.url);
 function openDB(dbPath) {
   const Database = require2("better-sqlite3");
+  if (dbPath !== ":memory:") mkdirSync(dirname(dbPath), { recursive: true });
   const db = new Database(dbPath);
   db.pragma("journal_mode = WAL");
   db.pragma("foreign_keys = ON");

package/dist/chunk-VGRG5DN7.js

@@ -0,0 +1,31 @@
+import {
+  canciaCacheTag
+} from "./chunk-X6ZFFGIA.js";
+
+// src/cache-invalidate.ts
+async function invalidateOnSave(cache, publishMode, route) {
+  if (publishMode !== "invalidate") return;
+  if (!cache || !cache.enabled) return;
+  if (!route || typeof route !== "string") return;
+  try {
+    await cache.invalidate({ tags: [canciaCacheTag(route)] });
+  } catch {
+  }
+}
+function extractRoute(body, requestUrl) {
+  if (body && typeof body === "object" && "route" in body) {
+    const r = body.route;
+    if (typeof r === "string" && r.length > 0) return r;
+  }
+  try {
+    const q = new URL(requestUrl).searchParams.get("route");
+    if (q) return q;
+  } catch {
+  }
+  return void 0;
+}
+
+export {
+  invalidateOnSave,
+  extractRoute
+};

package/dist/chunk-X6ZFFGIA.js

@@ -0,0 +1,20 @@
+// src/cache.ts
+var CANCIA_CACHE_TAG_PREFIX = "cancia:route:";
+function canciaCacheTag(route) {
+  return CANCIA_CACHE_TAG_PREFIX + normalizeRoute(route);
+}
+function normalizeRoute(route) {
+  let r = typeof route === "string" ? route : "";
+  const q = r.indexOf("?");
+  if (q !== -1) r = r.slice(0, q);
+  const h = r.indexOf("#");
+  if (h !== -1) r = r.slice(0, h);
+  r = "/" + r.replace(/^\/+/, "");
+  if (r.length > 1) r = r.replace(/\/+$/, "");
+  return r === "" ? "/" : r;
+}
+
+export {
+  CANCIA_CACHE_TAG_PREFIX,
+  canciaCacheTag
+};

package/dist/{chunk-U46HCJN3.js → chunk-YZH7QWZV.js}

@@ -1,15 +1,15 @@
+import {
+  detectImageType,
+  isValidSite
+} from "./chunk-5IPHDIC6.js";
 import {
   createGitBackedAdapter,
   createSqliteAdapterV2
-} from "./chunk-5AUIPW2I.js";
+} from "./chunk-GNWD7EL2.js";
 import {
   createJsonFileAdapter,
   createJsonFileAdapterV2
 } from "./chunk-L2VKQJPY.js";
-import {
-  detectImageType,
-  isValidSite
-} from "./chunk-5IPHDIC6.js";
 
 // src/routes/upload.ts
 import { writeFile, mkdir } from "fs/promises";
@@ -170,7 +170,8 @@ function buildRuntimeFromBaked(baked) {
   const projectRoot = baked.projectRoot || process.cwd();
   const token = process.env.CANCIA_TOKEN?.trim() || "";
   const secret = baked.public ? void 0 : token || void 0;
-  const deployHook = process.env.CANCIA_DEPLOY_HOOK || void 0;
+  const redeployHook = baked.redeployHook || void 0;
+  const deployHook = redeployHook || process.env.CANCIA_DEPLOY_HOOK || void 0;
   const deployHookToken = process.env.CANCIA_DEPLOY_HOOK_TOKEN || void 0;
   const publishRepo = baked.publishRepo || void 0;
   const publishGithubToken = process.env.CANCIA_GITHUB_TOKEN?.trim() || void 0;
@@ -192,6 +193,8 @@ function buildRuntimeFromBaked(baked) {
     deployHookHeaders: baked.deployHookHeaders,
     publishRepo,
     publishGithubToken,
+    publishMode: baked.publishMode,
+    redeployHook,
     maxUploadMB: baked.maxUploadMB
   };
 }

package/dist/endpoints/content.d.ts

@@ -1,9 +1,9 @@
+import { APIContext } from 'astro';
+
 declare function GET({ request }: {
     request: Request;
 }): Promise<Response>;
-declare function POST({ request }: {
-    request: Request;
-}): Promise<Response>;
+declare function POST(context: APIContext): Promise<Response>;
 declare function DELETE({ request }: {
     request: Request;
 }): Promise<Response>;

package/dist/endpoints/content.js

@@ -1,3 +1,9 @@
+import {
+  extractRoute,
+  invalidateOnSave
+} from "../chunk-VGRG5DN7.js";
+import "../chunk-X6ZFFGIA.js";
+
 // src/endpoints/content.ts
 import { getCanciaRuntime } from "virtual:cancia/runtime";
 function checkAuth(req, secret) {
@@ -19,8 +25,9 @@ async function GET({ request }) {
     headers: { "Content-Type": "application/json" }
   });
 }
-async function POST({ request }) {
-  const { storage, secret } = getCanciaRuntime();
+async function POST(context) {
+  const { request } = context;
+  const { storage, secret, publishMode } = getCanciaRuntime();
   const deny = checkAuth(request, secret);
   if (deny) return deny;
   const body = await request.json().catch(() => null);
@@ -30,6 +37,7 @@ async function POST({ request }) {
       { status: 400 }
     );
   await storage.set(body.site, body.key, body.lang, body.value);
+  await invalidateOnSave(context.cache, publishMode, extractRoute(body, request.url));
   return new Response(JSON.stringify({ ok: true }), {
     headers: { "Content-Type": "application/json" }
   });

package/dist/endpoints/lists.d.ts

@@ -1,14 +1,10 @@
+import { APIContext } from 'astro';
+
 declare function GET({ request }: {
     request: Request;
 }): Promise<Response>;
-declare function POST({ request }: {
-    request: Request;
-}): Promise<Response>;
-declare function PATCH({ request }: {
-    request: Request;
-}): Promise<Response>;
-declare function DELETE({ request }: {
-    request: Request;
-}): Promise<Response>;
+declare function POST(context: APIContext): Promise<Response>;
+declare function PATCH(context: APIContext): Promise<Response>;
+declare function DELETE(context: APIContext): Promise<Response>;
 
 export { DELETE, GET, PATCH, POST };

package/dist/endpoints/lists.js

@@ -3,6 +3,11 @@ import {
 } from "../chunk-22DJVJBR.js";
 import "../chunk-NG5GJME5.js";
 import "../chunk-7IA5B5CF.js";
+import {
+  extractRoute,
+  invalidateOnSave
+} from "../chunk-VGRG5DN7.js";
+import "../chunk-X6ZFFGIA.js";
 
 // src/endpoints/lists.ts
 import { getCanciaRuntime } from "virtual:cancia/runtime";
@@ -16,17 +21,26 @@ function getRoutes() {
     defaultLocale: rt.defaultLocale
   });
 }
+async function handleMutation(context, method) {
+  const { request } = context;
+  const response = await getRoutes().handle(request, method);
+  if (response.ok) {
+    const { publishMode } = getCanciaRuntime();
+    await invalidateOnSave(context.cache, publishMode, extractRoute(void 0, request.url));
+  }
+  return response;
+}
 async function GET({ request }) {
   return getRoutes().handle(request, "GET");
 }
-async function POST({ request }) {
-  return getRoutes().handle(request, "POST");
+async function POST(context) {
+  return handleMutation(context, "POST");
 }
-async function PATCH({ request }) {
-  return getRoutes().handle(request, "PATCH");
+async function PATCH(context) {
+  return handleMutation(context, "PATCH");
 }
-async function DELETE({ request }) {
-  return getRoutes().handle(request, "DELETE");
+async function DELETE(context) {
+  return handleMutation(context, "DELETE");
 }
 export {
   DELETE,

package/dist/endpoints/publish.js

@@ -1,7 +1,6 @@
 import {
-  fireDispatch,
-  firePublish
-} from "../chunk-BMCI2F2Y.js";
+  runPublish
+} from "../chunk-5RCLBWRH.js";
 import "../chunk-U7V53JX7.js";
 
 // src/endpoints/publish.ts
@@ -14,6 +13,7 @@ async function POST({ request }) {
     deployHookHeaders,
     publishRepo,
     publishGithubToken,
+    publishMode,
     secret
   } = getCanciaRuntime();
   if (secret) {
@@ -21,42 +21,18 @@ async function POST({ request }) {
     if (token !== secret)
       return new Response(JSON.stringify({ error: "Unauthorized" }), { status: 401 });
   }
-  const ghToken = publishGithubToken ?? process.env.CANCIA_GITHUB_TOKEN?.trim();
-  if (publishRepo && ghToken) {
-    const dispatched = await fireDispatch({ repo: publishRepo, token: ghToken });
-    if (dispatched.ok)
-      return new Response(JSON.stringify({ ok: true }), {
-        headers: { "Content-Type": "application/json" }
-      });
-    return new Response(
-      JSON.stringify({ error: "GitHub repository_dispatch failed" }),
-      { status: 502 }
-    );
-  }
   const hook = deployHook ?? process.env.CANCIA_DEPLOY_HOOK;
-  const result = await firePublish(hook, {
-    token: deployHookToken,
-    method: deployHookMethod,
-    headers: deployHookHeaders
-  });
-  if (result.ok)
-    return new Response(JSON.stringify({ ok: true }), {
-      headers: { "Content-Type": "application/json" }
-    });
-  if (result.kind === "no-hook")
-    return new Response(
-      JSON.stringify({
-        error: "No publish mechanism configured. Set a publish repo + CANCIA_GITHUB_TOKEN, or CANCIA_DEPLOY_HOOK."
-      }),
-      { status: 503 }
-    );
-  if (result.kind === "bad-response")
-    return new Response(
-      JSON.stringify({ error: `Deploy hook responded with ${result.status}` }),
-      { status: 502 }
-    );
-  return new Response(JSON.stringify({ error: "Failed to reach deploy hook" }), {
-    status: 502
+  const ghToken = publishGithubToken ?? process.env.CANCIA_GITHUB_TOKEN?.trim();
+  return runPublish({
+    mode: publishMode,
+    hook,
+    hookOptions: {
+      token: deployHookToken,
+      method: deployHookMethod,
+      headers: deployHookHeaders
+    },
+    repo: publishRepo,
+    githubToken: ghToken
   });
 }
 export {

package/dist/index.d.ts

@@ -60,21 +60,51 @@ interface CanciaIntegrationOptions {
     /** Optional extra headers merged into the deploy-hook request. */
     deployHookHeaders?: Record<string, string>;
     /**
-     * The host-independent standard publish path (031). When set, the Publish
-     * button fires a GitHub `repository_dispatch` (event `cancia-publish`) on
-     * this repo instead of the raw deploy hook — a workflow in the repo
-     * (templates/cancia-publish.yml) makes an empty commit → the host's normal
-     * git integration rebuilds. Identical for every host; no host API / IP
-     * allowlist. The token is NEVER baked — it is read from
-     * `process.env.CANCIA_GITHUB_TOKEN` at runtime (a fine-grained PAT with
-     * `contents:write`, which covers repository_dispatch). Precedence:
-     * publish-dispatch (if repo + token) → deploy hook (030) → 503.
+     * Publish mode (034) — how an edit becomes live, adapted to the site's render
+     * mode. Cancia has ONE publish method with THREE modes plus the legacy
+     * dispatch path:
      *
-     * If a git-backed `git.repo` is already declared, that repo is reused as the
-     * publish target unless overridden here.
+     *   • `{ mode: "live" }` — SSR, uncached (`prerender=false`). Save IS publish:
+     *     `getCMS()` reads live per request, so there is NO trigger and NO Publish
+     *     button. Correct for a pure-SSR site.
+     *   • `{ mode: "invalidate" }` — SSR + a `cache` provider (ISR). On save the
+     *     server tag-invalidates the edited page
+     *     (`cache.invalidate({ tags: [canciaCacheTag(route)] })`). Instant + cached.
+     *     No Publish button (save is publish).
+     *   • `{ mode: "redeploy", hook? }` — static (`prerender=true`). On PUBLISH the
+     *     host's deploy hook is fired (no commit, no junk). This is the recommended
+     *     static default. Hook precedence: `redeploy.hook` (baked) →
+     *     `CANCIA_DEPLOY_HOOK` (env). Token always `CANCIA_DEPLOY_HOOK_TOKEN` (env).
+     *   • `{ mode: "dispatch", github: { repo } }` — static, GitHub
+     *     `repository_dispatch` (031, legacy). A workflow in the repo makes an empty
+     *     commit → the host's git integration rebuilds. Kept as the git-commit
+     *     alternative; NO LONGER the recommended default.
+     *   • `{ github: { repo } }` — BACK-COMPAT: a bare `github` (what 031 configs
+     *     use) is treated as `{ mode: "dispatch", github }`. No existing config
+     *     breaks.
+     *
+     * Omitted entirely, the mode is resolved from context: a deploy hook (config
+     * or CANCIA_DEPLOY_HOOK env) → `redeploy`; else a publish repo (or a reused
+     * git-backed `git.repo`) → `dispatch`; else → `live`.
+     *
+     * Secrets are NEVER baked — the GitHub PAT (`CANCIA_GITHUB_TOKEN`) and the
+     * deploy-hook token (`CANCIA_DEPLOY_HOOK_TOKEN`) are read from env at runtime.
      */
     publish?: {
-        github?: {
+        mode: "live";
+    } | {
+        mode: "invalidate";
+    } | {
+        mode: "redeploy";
+        hook?: string;
+    } | {
+        mode: "dispatch";
+        github: {
+            repo: string;
+        };
+    } | {
+        /** BACK-COMPAT (031): a bare `github` is treated as dispatch. */
+        github: {
             /** "owner/name" of the repo whose `cancia-publish` workflow rebuilds. */
             repo: string;
         };

package/dist/index.js

@@ -1,7 +1,6 @@
 import {
-  fireDispatch,
-  firePublish
-} from "./chunk-BMCI2F2Y.js";
+  runPublish
+} from "./chunk-5RCLBWRH.js";
 import {
   makeListsRoutes
 } from "./chunk-22DJVJBR.js";
@@ -14,7 +13,8 @@ import {
   makeR2UploadHandler,
   makeUploadRoute,
   setCanciaRuntime
-} from "./chunk-U46HCJN3.js";
+} from "./chunk-YZH7QWZV.js";
+import "./chunk-5IPHDIC6.js";
 import {
   defineField,
   defineList,
@@ -26,12 +26,12 @@ import {
 } from "./chunk-UR5WC3RA.js";
 import {
   createSQLiteAdapter
-} from "./chunk-AE4SIY24.js";
+} from "./chunk-CJDIVWO3.js";
 import {
   closeSqliteAdapterV2,
   createGitBackedAdapter,
   createSqliteAdapterV2
-} from "./chunk-5AUIPW2I.js";
+} from "./chunk-GNWD7EL2.js";
 import "./chunk-U7V53JX7.js";
 import {
   createJsonFileAdapter,
@@ -41,7 +41,6 @@ import {
   RevConflictError
 } from "./chunk-7IA5B5CF.js";
 import "./chunk-BOIQNZAO.js";
-import "./chunk-5IPHDIC6.js";
 
 // src/integration.ts
 import { loadEnv } from "vite";
@@ -95,7 +94,7 @@ function makeContentRoute(storage, secret) {
 }
 
 // src/routes/publish.ts
-function makePublishRoute(deployHook, secret, hookOptions, dispatch) {
+function makePublishRoute(deployHook, secret, hookOptions, dispatch, mode) {
   return async ({ request }) => {
     if (secret) {
       const token = request.headers.get("Authorization")?.replace("Bearer ", "").trim();
@@ -103,40 +102,14 @@ function makePublishRoute(deployHook, secret, hookOptions, dispatch) {
         return new Response(JSON.stringify({ error: "Unauthorized" }), { status: 401 });
       }
     }
-    if (dispatch?.repo && dispatch?.token) {
-      const dispatched = await fireDispatch({ repo: dispatch.repo, token: dispatch.token });
-      if (dispatched.ok) {
-        return new Response(JSON.stringify({ ok: true }), {
-          headers: { "Content-Type": "application/json" }
-        });
-      }
-      return new Response(
-        JSON.stringify({ error: "GitHub repository_dispatch failed" }),
-        { status: 502 }
-      );
-    }
     const hook = deployHook ?? process.env.CANCIA_DEPLOY_HOOK;
-    const result = await firePublish(hook, hookOptions);
-    if (result.ok) {
-      return new Response(JSON.stringify({ ok: true }), {
-        headers: { "Content-Type": "application/json" }
-      });
-    }
-    if (result.kind === "no-hook") {
-      return new Response(
-        JSON.stringify({
-          error: "No publish mechanism configured. Set a publish repo + CANCIA_GITHUB_TOKEN, or CANCIA_DEPLOY_HOOK."
-        }),
-        { status: 503 }
-      );
-    }
-    if (result.kind === "bad-response") {
-      return new Response(
-        JSON.stringify({ error: `Deploy hook responded with ${result.status}` }),
-        { status: 502 }
-      );
-    }
-    return new Response(JSON.stringify({ error: "Failed to reach deploy hook" }), { status: 502 });
+    return runPublish({
+      mode,
+      hook,
+      hookOptions,
+      repo: dispatch?.repo,
+      githubToken: dispatch?.token
+    });
   };
 }
 
@@ -226,6 +199,27 @@ CANCIA_TOKEN=${token}
 }
 
 // src/integration.ts
+function resolvePublish(opts, hasDeployHookEnv) {
+  const publish = opts.publish;
+  const configRedeployHook = publish && "mode" in publish && publish.mode === "redeploy" ? publish.hook : void 0;
+  const hasDeployHook = !!(opts.deployHook || configRedeployHook || hasDeployHookEnv);
+  const explicitRepo = publish && "github" in publish ? publish.github.repo : void 0;
+  const publishRepo = explicitRepo ?? opts.git?.repo;
+  let publishMode;
+  if (publish && "mode" in publish) {
+    publishMode = publish.mode;
+  } else if (publish && "github" in publish) {
+    publishMode = "dispatch";
+  } else {
+    if (hasDeployHook) publishMode = "redeploy";
+    else if (publishRepo) publishMode = "dispatch";
+    else publishMode = "live";
+  }
+  let canPublish = false;
+  if (publishMode === "redeploy") canPublish = hasDeployHook;
+  else if (publishMode === "dispatch") canPublish = !!publishRepo;
+  return { publishMode, redeployHook: configRedeployHook, publishRepo, canPublish };
+}
 function buildDefaultV2Store(opts, projectRoot) {
   if (opts.db?.kind === "sqlite") {
     const path = opts.db.path ? isAbsolute(opts.db.path) ? opts.db.path : join2(projectRoot, opts.db.path) : join2(projectRoot, "cancia.db");
@@ -241,6 +235,8 @@ function canciaIntegration(opts = {}) {
   let resolvedUploadHandler;
   let resolvedDeployHook;
   let resolvedPublishRepo;
+  let resolvedPublishMode = "live";
+  let resolvedRedeployHook;
   let resolvedLocales = ["en"];
   let bakedConfig = null;
   return {
@@ -271,9 +267,12 @@ function canciaIntegration(opts = {}) {
           console.log(`
   \x1B[32mcancia\x1B[0m  No CANCIA_TOKEN found \u2014 generated one for you.`);
         }
-        const hasDeployHook = !!(opts.deployHook ?? env.CANCIA_DEPLOY_HOOK ?? process.env.CANCIA_DEPLOY_HOOK);
-        resolvedPublishRepo = opts.publish?.github?.repo ?? opts.git?.repo;
-        const canPublish = hasDeployHook || !!resolvedPublishRepo;
+        const hasDeployHookEnv = !!(env.CANCIA_DEPLOY_HOOK ?? process.env.CANCIA_DEPLOY_HOOK);
+        const resolved = resolvePublish(opts, hasDeployHookEnv);
+        resolvedPublishMode = resolved.publishMode;
+        resolvedRedeployHook = resolved.redeployHook;
+        resolvedPublishRepo = resolved.publishRepo;
+        const canPublish = resolved.canPublish;
         let storageDescriptor;
         if (opts.git) {
           storageDescriptor = {
@@ -312,6 +311,8 @@ function canciaIntegration(opts = {}) {
           deployHookMethod: opts.deployHookMethod,
           deployHookHeaders: opts.deployHookHeaders,
           publishRepo: resolvedPublishRepo,
+          publishMode: resolvedPublishMode,
+          redeployHook: resolvedRedeployHook,
           storage: storageDescriptor,
           r2: r2Baked
         };
@@ -370,7 +371,7 @@ function canciaIntegration(opts = {}) {
       "astro:server:setup": ({ server }) => {
         storage = opts.storage ?? createJsonFileAdapter(opts.dbPath);
         const secret = resolvedToken;
-        const deployHook = opts.deployHook ?? process.env.CANCIA_DEPLOY_HOOK;
+        const deployHook = resolvedRedeployHook ?? opts.deployHook ?? process.env.CANCIA_DEPLOY_HOOK;
         const deployHookToken = process.env.CANCIA_DEPLOY_HOOK_TOKEN || opts.deployHookToken;
         const publishGithubToken = process.env.CANCIA_GITHUB_TOKEN?.trim() || void 0;
         let uploadHandler;
@@ -408,6 +409,8 @@ function canciaIntegration(opts = {}) {
           deployHookHeaders: opts.deployHookHeaders,
           publishRepo: resolvedPublishRepo,
           publishGithubToken,
+          publishMode: resolvedPublishMode,
+          redeployHook: resolvedRedeployHook,
           maxUploadMB: opts.maxUploadMB ?? 10
         });
         const contentRoutes = makeContentRoute(storage, routeSecret);
@@ -420,7 +423,8 @@ function canciaIntegration(opts = {}) {
             method: opts.deployHookMethod,
             headers: opts.deployHookHeaders
           },
-          { repo: resolvedPublishRepo, token: publishGithubToken }
+          { repo: resolvedPublishRepo, token: publishGithubToken },
+          resolvedPublishMode
         );
         const authRoute = makeAuthRoute(secret);
         const listsRoutes = makeListsRoutes({
@@ -552,7 +556,7 @@ function canciaIntegration(opts = {}) {
         } else {
           uploadHandler = opts.uploadHandler ?? makeLocalUploadHandler({ maxMB: opts.maxUploadMB });
         }
-        const deployHook = opts.deployHook ?? process.env.CANCIA_DEPLOY_HOOK;
+        const deployHook = resolvedRedeployHook ?? opts.deployHook ?? process.env.CANCIA_DEPLOY_HOOK;
         const deployHookToken = process.env.CANCIA_DEPLOY_HOOK_TOKEN || opts.deployHookToken;
         const publishGithubToken = process.env.CANCIA_GITHUB_TOKEN?.trim() || void 0;
         const storageV2 = opts.storageV2 === null ? void 0 : opts.storageV2 ?? buildDefaultV2Store(opts, resolvedRootPath);
@@ -571,6 +575,8 @@ function canciaIntegration(opts = {}) {
           deployHookHeaders: opts.deployHookHeaders,
           publishRepo: resolvedPublishRepo,
           publishGithubToken,
+          publishMode: resolvedPublishMode,
+          redeployHook: resolvedRedeployHook,
           maxUploadMB: opts.maxUploadMB ?? 10
         });
       }

package/dist/runtime.d.ts

@@ -2,6 +2,16 @@ import { C as CanciaStorage, a as CanciaStorageV2 } from './types-BMlLS-OS.js';
 import { U as UploadHandler } from './upload-DwCGjXbz.js';
 import { G as GitHubCommitter } from './github-client-Db0pIrqE.js';
 
+/**
+ * The resolved publish mode (034). One of:
+ *   • "live"       — SSR, uncached; save IS publish (no trigger).
+ *   • "invalidate" — SSR + cache provider (ISR); a save tag-invalidates the page.
+ *   • "redeploy"   — static; publish fires the host's deploy hook (no commit).
+ *   • "dispatch"   — static; publish fires a GitHub repository_dispatch (031).
+ * `live`/`invalidate` have no Publish button (canPublish false); `redeploy`/
+ * `dispatch` do (when their trigger is resolvable).
+ */
+type PublishMode = "live" | "invalidate" | "redeploy" | "dispatch";
 interface CanciaRuntime {
     /** v1 KV-only storage. Kept for the existing /content endpoint. */
     storage: CanciaStorage;
@@ -49,6 +59,18 @@ interface CanciaRuntime {
      * read from CANCIA_GITHUB_TOKEN at runtime, never baked into dist/.
      */
     publishGithubToken?: string | undefined;
+    /**
+     * The resolved publish mode (034). Drives the publish endpoint's dispatch and
+     * the save-time invalidate. Optional so eager dev/build callers that predate
+     * 034 still typecheck; absent is treated as the legacy dispatch/hook path.
+     */
+    publishMode?: PublishMode | undefined;
+    /**
+     * Deploy-hook URL baked from `publish.redeploy.hook` (non-secret-ish). The
+     * runtime falls back to CANCIA_DEPLOY_HOOK / deployHook when this is absent.
+     * Non-secret, baked.
+     */
+    redeployHook?: string | undefined;
     maxUploadMB: number;
 }
 /** Describes which storage adapter to build lazily in the server process. */
@@ -97,6 +119,17 @@ interface BakedConfig {
      * runtime. Absent = no dispatch path (falls through to the deploy hook).
      */
     publishRepo?: string | undefined;
+    /**
+     * The resolved publish mode (034). Optional so baked configs from before 034
+     * still typecheck (undefined → runtime treats as the legacy dispatch/hook
+     * path). Baked, non-secret.
+     */
+    publishMode?: PublishMode | undefined;
+    /**
+     * Deploy-hook URL from `publish.redeploy.hook`, baked when the operator gave it
+     * in config. Absent → the runtime reads CANCIA_DEPLOY_HOOK from env. Non-secret.
+     */
+    redeployHook?: string | undefined;
     /** How to build the v2 storage adapter at runtime. Absent = no v2 storage. */
     storage: BakedStorageDescriptor | undefined;
     /** When set, build an R2 upload handler; secrets come from env at runtime. */
@@ -115,4 +148,4 @@ declare function setBakedConfig(config: BakedConfig): void;
 declare function setCanciaRuntime(runtime: CanciaRuntime): void;
 declare function getCanciaRuntime(): CanciaRuntime;
 
-export { type BakedConfig, type BakedR2Config, type BakedStorageDescriptor, type CanciaRuntime, getCanciaRuntime, setBakedConfig, setCanciaRuntime };
+export { type BakedConfig, type BakedR2Config, type BakedStorageDescriptor, type CanciaRuntime, type PublishMode, getCanciaRuntime, setBakedConfig, setCanciaRuntime };

package/dist/runtime.js

@@ -2,12 +2,12 @@ import {
   getCanciaRuntime,
   setBakedConfig,
   setCanciaRuntime
-} from "./chunk-U46HCJN3.js";
-import "./chunk-5AUIPW2I.js";
+} from "./chunk-YZH7QWZV.js";
+import "./chunk-5IPHDIC6.js";
+import "./chunk-GNWD7EL2.js";
 import "./chunk-U7V53JX7.js";
 import "./chunk-L2VKQJPY.js";
 import "./chunk-7IA5B5CF.js";
-import "./chunk-5IPHDIC6.js";
 export {
   getCanciaRuntime,
   setBakedConfig,

package/dist/storage/index.js

@@ -1,11 +1,11 @@
 import {
   createSQLiteAdapter
-} from "../chunk-AE4SIY24.js";
+} from "../chunk-CJDIVWO3.js";
 import {
   closeSqliteAdapterV2,
   createGitBackedAdapter,
   createSqliteAdapterV2
-} from "../chunk-5AUIPW2I.js";
+} from "../chunk-GNWD7EL2.js";
 import {
   createGitHubClient
 } from "../chunk-U7V53JX7.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cancia/astro",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Astro integration for Cancia CMS — inline editing with zero separate server",
   "license": "MIT",
   "repository": {
@@ -28,6 +28,10 @@
       "types": "./dist/storage/index.d.ts",
       "import": "./dist/storage/index.js"
     },
+    "./cache": {
+      "types": "./dist/cache.d.ts",
+      "import": "./dist/cache.js"
+    },
     "./richtext": {
       "types": "./dist/richtext/index.d.ts",
       "import": "./dist/richtext/index.js"

package/dist/chunk-BMCI2F2Y.js

@@ -1,45 +0,0 @@
-import {
-  createGitHubClient
-} from "./chunk-U7V53JX7.js";
-
-// src/publish-hook.ts
-async function firePublish(hook, opts = {}) {
-  if (!hook) return { ok: false, kind: "no-hook" };
-  const headers = { ...opts.headers ?? {} };
-  if (opts.token) headers.Authorization = `Bearer ${opts.token}`;
-  const init = { method: opts.method ?? "POST" };
-  if (Object.keys(headers).length > 0) init.headers = headers;
-  try {
-    const res = await fetch(hook, init);
-    if (!res.ok) return { ok: false, kind: "bad-response", status: res.status };
-    return { ok: true };
-  } catch {
-    return { ok: false, kind: "unreachable" };
-  }
-}
-
-// src/publish-dispatch.ts
-var CANCIA_PUBLISH_EVENT = "cancia-publish";
-async function fireDispatch(opts) {
-  if (!opts.repo || !opts.token) return { ok: false, kind: "not-configured" };
-  const client = createGitHubClient({
-    repo: opts.repo,
-    // branch is irrelevant for dispatch (repo-level event) but required by the
-    // client's options — a harmless placeholder.
-    branch: "main",
-    token: opts.token,
-    fetch: opts.fetch,
-    apiBase: opts.apiBase
-  });
-  try {
-    await client.dispatch(opts.eventType ?? CANCIA_PUBLISH_EVENT, opts.clientPayload);
-    return { ok: true };
-  } catch {
-    return { ok: false, kind: "failed" };
-  }
-}
-
-export {
-  firePublish,
-  fireDispatch
-};