@cancia/astro 0.5.1 → 0.6.0

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/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.1",
+  "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"