@cancia/astro 0.5.0 → 0.6.0

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

@@ -166,10 +166,20 @@ function setBakedConfig(config) {
 function setCanciaRuntime(runtime) {
   _runtime = runtime;
 }
+function __resetRuntimeForTests() {
+  _runtime = null;
+  _bakedConfig = null;
+}
 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 isPublic = baked.public === true;
+  if (!isPublic && !token) {
+    throw new Error(
+      "[cancia] CANCIA_TOKEN is not set but this site is not public \u2014 refusing to start to avoid serving an open, unauthenticated mutation API. Set CANCIA_TOKEN in the deployed process, or set public:true if anonymous editing is intended."
+    );
+  }
+  const secret = isPublic ? void 0 : token;
   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;
@@ -261,5 +271,6 @@ export {
   makeR2UploadHandler,
   setBakedConfig,
   setCanciaRuntime,
+  __resetRuntimeForTests,
   getCanciaRuntime
 };

package/dist/content.d.ts

@@ -0,0 +1,60 @@
+/** Flat content map as returned by /api/cancia/content and kv.getAll: "key.lang" → value. */
+type ContentMap = Record<string, string>;
+/** A translator: `(key, fallback) => cms[`${key}.${lang}`] ?? fallback`. */
+type Translate = (key: string, fallback: string) => string;
+interface ContentReaderOptions {
+    /** Site id (the `?site=` query param and the storage `site` column). */
+    site: string;
+    /**
+     * Build-time content API base. Default: `process.env.CANCIA_CONTENT_URL`.
+     * When set (non-empty), `getCMS()` FETCHES from
+     * `${url}/api/cancia/content?site=<site>` instead of reading the DB directly.
+     * This is how a static build on a runtime-only volume gets live content.
+     */
+    url?: string;
+    /**
+     * Bearer token for the fetch. Default: `process.env.CANCIA_TOKEN`. Required by
+     * a non-public site (036 fail-closed) — without it the fetch 401s and the
+     * reader falls back to the direct DB read.
+     */
+    token?: string;
+    /**
+     * Direct-DB fallback path. Default:
+     * `process.env.CANCIA_DB_PATH ?? "<cwd>/cancia.db"`.
+     * Ignored when a `readDb` override is supplied.
+     */
+    dbPath?: string;
+    /** Default language for `makeT`/`get`. Default: `"en"`. */
+    lang?: string;
+    /** Injectable fetch (tests). Default: global `fetch`. */
+    fetch?: typeof fetch;
+    /**
+     * Optional DB-read override. Lets a non-sqlite project (e.g. json-file
+     * storage) supply its own fallback WITHOUT this reader importing every
+     * adapter. Default: read via `createSqliteAdapterV2({ dbPath })` (the
+     * recommended backend).
+     */
+    readDb?: () => Promise<ContentMap>;
+}
+interface ContentReader {
+    /**
+     * Read all content for the site as a flat `"key.lang" → value` map.
+     * Chain: fetch (when `url` set) → direct DB read → `{}`. NEVER throws.
+     */
+    getCMS(): Promise<ContentMap>;
+    /** Build a translator over a content map for the reader's `lang`. */
+    makeT(cms: ContentMap): Translate;
+    /** Sugar: `const { t, cms } = await reader.get()` in a page's frontmatter. */
+    get(): Promise<{
+        t: Translate;
+        cms: ContentMap;
+    }>;
+}
+/**
+ * Create a content reader. Reads are transport-agnostic (network OR local file)
+ * and never throw — a static build reads content the same way whether it's a
+ * local DB, the site's own API, or a future hosted Cancia DB.
+ */
+declare function createContentReader(opts: ContentReaderOptions): ContentReader;
+
+export { type ContentMap, type ContentReader, type ContentReaderOptions, type Translate, createContentReader };

package/dist/content.js

@@ -0,0 +1,52 @@
+import "./chunk-FOSOWSXV.js";
+import "./chunk-CJDIVWO3.js";
+import {
+  createSqliteAdapterV2
+} from "./chunk-GNWD7EL2.js";
+import "./chunk-U7V53JX7.js";
+import "./chunk-L2VKQJPY.js";
+import "./chunk-7IA5B5CF.js";
+
+// src/content.ts
+function createContentReader(opts) {
+  const site = opts.site;
+  const lang = opts.lang ?? "en";
+  const url = opts.url ?? process.env.CANCIA_CONTENT_URL;
+  const token = opts.token ?? process.env.CANCIA_TOKEN;
+  const fetchImpl = opts.fetch ?? globalThis.fetch;
+  function readDb() {
+    if (opts.readDb) return opts.readDb();
+    const dbPath = opts.dbPath ?? process.env.CANCIA_DB_PATH ?? `${process.cwd()}/cancia.db`;
+    return createSqliteAdapterV2({ dbPath }).kv.getAll(site);
+  }
+  async function fetchFromApi(base) {
+    const endpoint = `${base.replace(/\/+$/, "")}/api/cancia/content?site=${encodeURIComponent(site)}`;
+    const res = await fetchImpl(endpoint, {
+      headers: token ? { Authorization: `Bearer ${token}` } : {}
+    });
+    if (!res.ok) throw new Error(`Content fetch failed: ${res.status}`);
+    return await res.json();
+  }
+  async function getCMS() {
+    try {
+      return url ? await fetchFromApi(url) : await readDb();
+    } catch {
+      try {
+        return await readDb();
+      } catch {
+        return {};
+      }
+    }
+  }
+  function makeT(cms) {
+    return (key, fallback) => cms[`${key}.${lang}`] ?? fallback;
+  }
+  async function get() {
+    const cms = await getCMS();
+    return { t: makeT(cms), cms };
+  }
+  return { getCMS, makeT, get };
+}
+export {
+  createContentReader
+};

package/dist/endpoints/lists.js

@@ -1,13 +1,13 @@
-import {
-  makeListsRoutes
-} from "../chunk-22DJVJBR.js";
-import "../chunk-NG5GJME5.js";
-import "../chunk-7IA5B5CF.js";
 import {
   extractRoute,
   invalidateOnSave
 } from "../chunk-VGRG5DN7.js";
+import {
+  makeListsRoutes
+} from "../chunk-22DJVJBR.js";
+import "../chunk-NG5GJME5.js";
 import "../chunk-X6ZFFGIA.js";
+import "../chunk-7IA5B5CF.js";
 
 // src/endpoints/lists.ts
 import { getCanciaRuntime } from "virtual:cancia/runtime";

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   makeR2UploadHandler,
   makeUploadRoute,
   setCanciaRuntime
-} from "./chunk-YZH7QWZV.js";
+} from "./chunk-AGNPUTKS.js";
 import "./chunk-5IPHDIC6.js";
 import {
   defineField,

package/dist/runtime.d.ts

@@ -146,6 +146,14 @@ declare function setBakedConfig(config: BakedConfig): void;
  * to lazy init instead.
  */
 declare function setCanciaRuntime(runtime: CanciaRuntime): void;
+/**
+ * TEST-ONLY: clear both module singletons so the next getCanciaRuntime() rebuilds
+ * from scratch. Production never calls this — the virtual module supplies baked
+ * config exactly once and endpoints share the built runtime for the process
+ * lifetime. Needed only because a mocked virtual:cancia/runtime module survives
+ * vitest's vi.resetModules() (its singletons would otherwise leak across cases).
+ */
+declare function __resetRuntimeForTests(): void;
 declare function getCanciaRuntime(): CanciaRuntime;
 
-export { type BakedConfig, type BakedR2Config, type BakedStorageDescriptor, type CanciaRuntime, type PublishMode, getCanciaRuntime, setBakedConfig, setCanciaRuntime };
+export { type BakedConfig, type BakedR2Config, type BakedStorageDescriptor, type CanciaRuntime, type PublishMode, __resetRuntimeForTests, getCanciaRuntime, setBakedConfig, setCanciaRuntime };

package/dist/runtime.js

@@ -1,14 +1,16 @@
 import {
+  __resetRuntimeForTests,
   getCanciaRuntime,
   setBakedConfig,
   setCanciaRuntime
-} from "./chunk-YZH7QWZV.js";
+} from "./chunk-AGNPUTKS.js";
 import "./chunk-5IPHDIC6.js";
 import "./chunk-GNWD7EL2.js";
 import "./chunk-U7V53JX7.js";
 import "./chunk-L2VKQJPY.js";
 import "./chunk-7IA5B5CF.js";
 export {
+  __resetRuntimeForTests,
   getCanciaRuntime,
   setBakedConfig,
   setCanciaRuntime

package/dist/storage/index.js

@@ -1,3 +1,4 @@
+import "../chunk-FOSOWSXV.js";
 import {
   createSQLiteAdapter
 } from "../chunk-CJDIVWO3.js";

package/package.json

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