@cedros/data-react 0.1.5 → 0.1.7

package/README.md

@@ -31,9 +31,14 @@ Packaging smoke:
 ## Package exports
 
 - `@cedros/data-react`
-  - `defaultPageTemplates`
-  - `DefaultPageKey`, `PageTemplateContract`
-  - re-exports admin + site-template modules
+  - `CedrosDataProvider`, `useCedrosDataTheme`, `useCedrosDataThemeOptional`
+  - `CmsContent`, `getOrCreateVisitorId`, `sanitizeCmsHtml`, `renderCmsMarkdown`
+  - theme/page/content types
+- `@cedros/data-react/server`
+  - `generatePageMetadata`, `buildPageMetadata`
+  - `fetchBlogPost`, `listContentSlugs`, `listBlogSlugs`, `listLearnPathIds`
+  - `loadSitemapEntries`
+  - all accept `ServerFetchOptions` with optional `apiKey` (falls back to `CEDROS_X_API_KEY` env)
 - `@cedros/data-react/admin`
   - `cedrosDataPlugin`
   - section IDs/groups/types
@@ -91,6 +96,9 @@ Content:
 - `pages`
 - `navigation`
 - `site-settings`
+- `layout` — nav width, link position/style, footer width
+- `tipping`
+- `monetization`
 
 Data model:
 - `collections`
@@ -102,8 +110,44 @@ Operations:
 - `data-ops`
 - `history`
 
+## Theme system (CedrosDataProvider)
+
+`CedrosDataProvider` matches the theme API used by cedros-login and cedros-pay:
+
+```tsx
+import { CedrosDataProvider } from "@cedros/data-react";
+
+<CedrosDataProvider
+  theme="dark"
+  themeOverrides={{
+    "--cedros-background": "#292524",
+    "--cedros-foreground": "#f5f5f4",
+    "--cedros-border": "#44403c",
+  }}
+>
+  <SiteLayout ... />
+</CedrosDataProvider>
+```
+
+Props:
+- `theme` — `'light'` | `'dark'` (default: `'light'`)
+- `themeOverrides` — typed `CedrosDataThemeOverrides` with 13 tokens + open-ended `[key: string]`
+- `unstyled` — disables all default className/style (for custom design systems)
+
+Hook:
+```tsx
+import { useCedrosDataTheme } from "@cedros/data-react";
+
+const { mode, isDark, className, style, unstyled } = useCedrosDataTheme();
+```
+
+Also exports `useCedrosDataThemeOptional()` which returns `null` outside a provider.
+
+The provider applies className (`.cedros-dark`) and inline style overrides on the **same element** so overrides always win via CSS specificity — matching cedros-pay/login behavior.
+
 ## Styling and dark mode
 
+- All component styles use `var(--cedros-*, fallback)` — no hardcoded colors, even in dark mode.
 - Admin UIs use tokenized variables aligned with cedros-login/cedros-pay conventions.
 - Dark mode responds to both:
   - `.cedros-dark`
@@ -117,11 +161,38 @@ import "@cedros/data-react/admin/styles.css";
 ## Site templates and components
 
 Layouts/navigation:
-- `SiteLayout`
-- `TopNav`
-- `SiteFooter`
+- `SiteLayout` — accepts `layout?: SiteLayoutOptions` for nav/footer configuration
+- `TopNav` — accepts `layout?: NavLayoutOptions`
+- `SiteFooter` — accepts `layout?: FooterLayoutOptions`
 - `DashboardShell`
 
+### Layout options
+
+Layout preferences are managed via the admin "Layout" section (stored as `site_settings/layout`). Pass them to `SiteLayout`:
+
+```tsx
+<SiteLayout
+  siteTitle="My Site"
+  navigation={navItems}
+  layout={{
+    nav: {
+      width: "full",           // "contained" (default) | "full"
+      linkPosition: "center",  // "right" (default) | "center"
+      linkStyle: "text",       // "pill" (default) | "text"
+    },
+    footer: {
+      width: "full",           // "contained" (default) | "full"
+    },
+  }}
+>
+  {children}
+</SiteLayout>
+```
+
+- **width: "full"** — logo and actions stretch to viewport edges
+- **linkPosition: "center"** — nav links centered between brand and right slot
+- **linkStyle: "text"** — plain text links instead of pill buttons
+
 Core page templates:
 - `HomePageTemplate`
 - `ContactPageTemplate`
@@ -146,13 +217,18 @@ Tipping:
 Docs templates:
 - `DocsIndexTemplate`
 - `DocArticleTemplate` (GitBook-style left nav + right TOC)
+- both accept `headless` to skip the built-in `SiteLayout`, or `renderLayout={(content) => ...}` to wrap the docs UI in an existing app shell
 
 Content rendering and helpers:
 - `MarkdownContent`
 - `Breadcrumbs`
 - `ContentPagination`
 - `withActiveRouteState`
+- `fetchDocEntry`
 - `buildDocsSidebarSections`
+- `buildDocsTree`
+- `buildHierarchicalDocsSidebarSections`
+- `buildDocsPrevNext`
 - `withActiveDocsSidebar`
 - `prepareBlogIndex`
 - `prepareDocsIndex`
@@ -248,6 +324,32 @@ Docs/blog templates default to `bodyMarkdown`.
 
 This keeps markdown as the safe default and avoids unsafe HTML rendering by default.
 
+Docs search helpers also inspect optional `bodyMarkdown`, `bodyText`, `bodyHtml`, and `searchText` fields on docs entries, so callers can opt into body/full-text matching without changing the query API.
+
+## Server helpers and API key
+
+`@cedros/data-react/server` provides Next.js data-fetching helpers that call cedros-data directly:
+
+```tsx
+import { generatePageMetadata, loadSitemapEntries, fetchBlogPost } from "@cedros/data-react/server";
+
+// All helpers accept ServerFetchOptions:
+const meta = await generatePageMetadata("about", {
+  serverUrl: process.env.CEDROS_DATA_URL,
+  apiKey: process.env.CEDROS_X_API_KEY,  // optional, sent as x-api-key header
+});
+```
+
+The API key resolves from (in order):
+1. `options.apiKey` if explicitly passed
+2. `process.env.CEDROS_X_API_KEY` environment variable
+3. No header sent (unauthenticated — works with direct cedros-data access)
+
+Environment variables for server URL resolution:
+1. `options.serverUrl` if explicitly passed
+2. `CEDROS_DATA_URL`
+3. `NEXT_PUBLIC_BACKEND_API_URL`
+
 ## Default page contract
 
 The package exports the default page template contract used by server bootstrap:

package/dist/admin/icons.d.ts

@@ -12,4 +12,5 @@ export declare const Icons: {
     history: ReactNode;
     tipping: ReactNode;
     monetization: ReactNode;
+    layout: ReactNode;
 };

package/dist/admin/icons.js

@@ -14,5 +14,6 @@ export const Icons = {
     dataOps: icon("M4 4h16v16H4z M8 8h8 M8 12h8 M8 16h4"),
     history: icon("M12 8v5l3 2M20 12a8 8 0 11-2.34-5.66"),
     tipping: icon("M12 2a7 7 0 00-7 7c0 5.25 7 13 7 13s7-7.75 7-13a7 7 0 00-7-7z"),
-    monetization: icon("M12 1v22M17 5H9.5a3.5 3.5 0 000 7h5a3.5 3.5 0 010 7H6")
+    monetization: icon("M12 1v22M17 5H9.5a3.5 3.5 0 000 7h5a3.5 3.5 0 010 7H6"),
+    layout: icon("M4 3h16a1 1 0 011 1v16a1 1 0 01-1 1H4a1 1 0 01-1-1V4a1 1 0 011-1zM3 9h18M9 21V9")
 };

package/dist/admin/plugin.js

@@ -14,6 +14,7 @@ const MediaSection = lazy(() => import("./sections/media/MediaSection.js"));
 const HistorySection = lazy(() => import("./sections/HistorySection.js"));
 const TippingSection = lazy(() => import("./sections/TippingSection.js"));
 const MonetizationSection = lazy(() => import("./sections/MonetizationSection.js"));
+const LayoutSection = lazy(() => import("./sections/LayoutSection.js"));
 export const cedrosDataPlugin = {
     id: "cedros-data",
     name: "Cedros Data",
@@ -114,6 +115,14 @@ export const cedrosDataPlugin = {
             group: CEDROS_DATA_GROUPS.content,
             order: 5,
             requiredPermission: "data:settings:read"
+        },
+        {
+            id: CEDROS_DATA_SECTIONS.layout,
+            label: "Layout",
+            icon: Icons.layout,
+            group: CEDROS_DATA_GROUPS.content,
+            order: 6,
+            requiredPermission: "data:settings:read"
         }
     ],
     groups: [
@@ -133,7 +142,8 @@ export const cedrosDataPlugin = {
         [CEDROS_DATA_SECTIONS.dataOps]: DataOpsSection,
         [CEDROS_DATA_SECTIONS.history]: HistorySection,
         [CEDROS_DATA_SECTIONS.tipping]: TippingSection,
-        [CEDROS_DATA_SECTIONS.monetization]: MonetizationSection
+        [CEDROS_DATA_SECTIONS.monetization]: MonetizationSection,
+        [CEDROS_DATA_SECTIONS.layout]: LayoutSection
     },
     createPluginContext(hostContext) {
         const custom = readCedrosDataCustomContext(hostContext);

package/dist/admin/sectionIds.d.ts

@@ -11,8 +11,9 @@ export declare const CEDROS_DATA_SECTIONS: {
     readonly history: "history";
     readonly tipping: "tipping";
     readonly monetization: "monetization";
+    readonly layout: "layout";
 };
-export declare const CEDROS_DATA_SECTION_IDS: readonly ["cedros-data:pages", "cedros-data:navigation", "cedros-data:site-settings", "cedros-data:media", "cedros-data:collections", "cedros-data:schema-designer", "cedros-data:contract-verify", "cedros-data:custom-data", "cedros-data:data-ops", "cedros-data:history", "cedros-data:tipping", "cedros-data:monetization"];
+export declare const CEDROS_DATA_SECTION_IDS: readonly ["cedros-data:pages", "cedros-data:navigation", "cedros-data:site-settings", "cedros-data:media", "cedros-data:collections", "cedros-data:schema-designer", "cedros-data:contract-verify", "cedros-data:custom-data", "cedros-data:data-ops", "cedros-data:history", "cedros-data:tipping", "cedros-data:monetization", "cedros-data:layout"];
 export declare const CEDROS_DATA_GROUPS: {
     readonly content: "Content";
     readonly dataModel: "Data Model";

package/dist/admin/sectionIds.js

@@ -10,7 +10,8 @@ export const CEDROS_DATA_SECTIONS = {
     dataOps: "data-ops",
     history: "history",
     tipping: "tipping",
-    monetization: "monetization"
+    monetization: "monetization",
+    layout: "layout"
 };
 export const CEDROS_DATA_SECTION_IDS = [
     "cedros-data:pages",
@@ -24,7 +25,8 @@ export const CEDROS_DATA_SECTION_IDS = [
     "cedros-data:data-ops",
     "cedros-data:history",
     "cedros-data:tipping",
-    "cedros-data:monetization"
+    "cedros-data:monetization",
+    "cedros-data:layout"
 ];
 export const CEDROS_DATA_GROUPS = {
     content: "Content",

package/dist/admin/sections/LayoutSection.d.ts

@@ -0,0 +1,2 @@
+import type { AdminSectionProps } from "../types.js";
+export default function LayoutSection({ pluginContext }: AdminSectionProps): React.JSX.Element;

package/dist/admin/sections/LayoutSection.js

@@ -0,0 +1,104 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from "react";
+import { requestJson } from "../api.js";
+import { AdminButton, Card, SelectInput, StatusNotice } from "../components.js";
+const DEFAULT_LAYOUT = {
+    navWidth: "contained",
+    navLinkPosition: "right",
+    navLinkStyle: "pill",
+    footerWidth: "contained"
+};
+export default function LayoutSection({ pluginContext }) {
+    const canWrite = pluginContext.hasPermission("data:settings:write");
+    const [settings, setSettings] = useState(DEFAULT_LAYOUT);
+    const [status, setStatus] = useState("");
+    const [tone, setTone] = useState("neutral");
+    const [loading, setLoading] = useState(false);
+    const load = useCallback(async () => {
+        setLoading(true);
+        setStatus("");
+        try {
+            const entries = await requestJson(pluginContext, "/entries/query", {
+                method: "POST",
+                body: {
+                    collection_name: "site_settings",
+                    entry_keys: ["layout"],
+                    contains: null,
+                    limit: 1,
+                    offset: 0
+                }
+            });
+            if (entries.length > 0) {
+                setSettings(parseLayoutSettings(entries[0].payload));
+            }
+        }
+        catch (error) {
+            setStatus(error.message);
+            setTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [pluginContext]);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    const save = useCallback(async () => {
+        if (!canWrite) {
+            setStatus("Missing data:settings:write permission.");
+            setTone("error");
+            return;
+        }
+        setLoading(true);
+        setStatus("");
+        try {
+            await requestJson(pluginContext, "/entries/upsert", {
+                method: "POST",
+                body: {
+                    collection_name: "site_settings",
+                    entry_key: "layout",
+                    payload: settings
+                }
+            });
+            setStatus("Layout settings saved.");
+            setTone("success");
+        }
+        catch (error) {
+            setStatus(error.message);
+            setTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [canWrite, pluginContext, settings]);
+    const update = useCallback((key, value) => {
+        setSettings((prev) => ({ ...prev, [key]: value }));
+    }, []);
+    return (_jsxs("div", { className: "cedros-data", children: [_jsxs("header", { className: "cedros-data__header", children: [_jsxs("div", { children: [_jsx("h2", { className: "cedros-data__title", children: "Layout" }), _jsx("p", { className: "cedros-data__subtitle", children: "Configure the site navigation bar and footer appearance." }), !canWrite && (_jsx("p", { className: "cedros-data__subtitle", children: "Read-only. Missing data:settings:write permission." }))] }), _jsxs("div", { className: "cedros-data-actions", children: [_jsx(AdminButton, { variant: "secondary", onClick: () => void load(), disabled: loading, children: "Refresh" }), _jsx(AdminButton, { variant: "primary", onClick: () => void save(), disabled: loading || !canWrite, children: "Save" })] })] }), _jsxs("div", { className: "cedros-data-grid cedros-data-grid--two", children: [_jsxs(Card, { title: "Navigation Bar", subtitle: "Controls the top nav header layout.", children: [_jsxs(SelectInput, { label: "Width", value: settings.navWidth, onChange: (e) => update("navWidth", e.target.value), disabled: !canWrite, children: [_jsx("option", { value: "contained", children: "Contained (max-width)" }), _jsx("option", { value: "full", children: "Full width (edge to edge)" })] }), _jsxs(SelectInput, { label: "Link Position", value: settings.navLinkPosition, onChange: (e) => update("navLinkPosition", e.target.value), disabled: !canWrite, children: [_jsx("option", { value: "right", children: "Right (next to actions)" }), _jsx("option", { value: "center", children: "Center" })] }), _jsxs(SelectInput, { label: "Link Style", value: settings.navLinkStyle, onChange: (e) => update("navLinkStyle", e.target.value), disabled: !canWrite, children: [_jsx("option", { value: "pill", children: "Pill buttons" }), _jsx("option", { value: "text", children: "Plain text links" })] })] }), _jsx(Card, { title: "Footer", subtitle: "Controls the site footer layout.", children: _jsxs(SelectInput, { label: "Width", value: settings.footerWidth, onChange: (e) => update("footerWidth", e.target.value), disabled: !canWrite, children: [_jsx("option", { value: "contained", children: "Contained (max-width)" }), _jsx("option", { value: "full", children: "Full width (edge to edge)" })] }) })] }), status && _jsx(StatusNotice, { tone: tone, message: status })] }));
+}
+function parseLayoutSettings(payload) {
+    return {
+        navWidth: isNavWidth(payload.navWidth) ? payload.navWidth : DEFAULT_LAYOUT.navWidth,
+        navLinkPosition: isNavLinkPosition(payload.navLinkPosition)
+            ? payload.navLinkPosition
+            : DEFAULT_LAYOUT.navLinkPosition,
+        navLinkStyle: isNavLinkStyle(payload.navLinkStyle)
+            ? payload.navLinkStyle
+            : DEFAULT_LAYOUT.navLinkStyle,
+        footerWidth: isFooterWidth(payload.footerWidth)
+            ? payload.footerWidth
+            : DEFAULT_LAYOUT.footerWidth
+    };
+}
+function isNavWidth(v) {
+    return v === "contained" || v === "full";
+}
+function isNavLinkPosition(v) {
+    return v === "center" || v === "right";
+}
+function isNavLinkStyle(v) {
+    return v === "text" || v === "pill";
+}
+function isFooterWidth(v) {
+    return v === "contained" || v === "full";
+}

package/dist/admin/styles.css

@@ -22,17 +22,17 @@
 
 .cedros-dark .cedros-data,
 .cedros-admin.cedros-admin--dark .cedros-data {
-  --cd-bg: hsl(222.2, 84%, 4.9%);
-  --cd-fg: hsl(210, 40%, 98%);
-  --cd-muted: hsl(215, 20.2%, 65.1%);
-  --cd-muted-bg: hsl(217.2, 32.6%, 17.5%);
-  --cd-border: hsl(217.2, 32.6%, 17.5%);
-  --cd-accent: hsl(217.2, 32.6%, 17.5%);
-  --cd-ring: hsl(212.7, 26.8%, 83.9%);
-  --cd-primary: hsl(210, 40%, 98%);
-  --cd-primary-fg: hsl(222.2, 47.4%, 11.2%);
-  --cd-success: hsl(142, 71%, 45%);
-  --cd-error: hsl(0, 84.2%, 60.2%);
+  --cd-bg: var(--cedros-background, hsl(222.2, 84%, 4.9%));
+  --cd-fg: var(--cedros-foreground, hsl(210, 40%, 98%));
+  --cd-muted: var(--cedros-muted-foreground, hsl(215, 20.2%, 65.1%));
+  --cd-muted-bg: var(--cedros-muted, hsl(217.2, 32.6%, 17.5%));
+  --cd-border: var(--cedros-border, hsl(217.2, 32.6%, 17.5%));
+  --cd-accent: var(--cedros-accent, hsl(217.2, 32.6%, 17.5%));
+  --cd-ring: var(--cedros-ring, hsl(212.7, 26.8%, 83.9%));
+  --cd-primary: var(--cedros-primary, hsl(210, 40%, 98%));
+  --cd-primary-fg: var(--cedros-primary-foreground, hsl(222.2, 47.4%, 11.2%));
+  --cd-success: var(--cedros-success, hsl(142, 71%, 45%));
+  --cd-error: var(--cedros-error, hsl(0, 84.2%, 60.2%));
 }
 
 .cedros-data__header {

package/dist/react/CedrosDataProvider.d.ts

@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+import type { CedrosDataThemeOverrides, CedrosDataThemeValue, ThemeMode } from "./theme.js";
+export interface CedrosDataProviderProps {
+    /** Light or dark mode. */
+    theme?: ThemeMode;
+    /** CSS variable overrides applied as inline styles. */
+    themeOverrides?: CedrosDataThemeOverrides;
+    /** When true, no default className or style is applied. */
+    unstyled?: boolean;
+    children: ReactNode;
+}
+/**
+ * Theme provider for cedros-data components.
+ *
+ * Applies `className` and inline `style` on the **same element** so that
+ * overrides always win over class-selector-based CSS variable declarations.
+ */
+export declare function CedrosDataProvider({ theme, themeOverrides, unstyled, children, }: CedrosDataProviderProps): React.JSX.Element;
+/**
+ * Returns the current theme context.
+ *
+ * Must be called inside a `<CedrosDataProvider>`.
+ */
+export declare function useCedrosDataTheme(): CedrosDataThemeValue;
+/**
+ * Returns the current theme context, or `null` when outside a provider.
+ */
+export declare function useCedrosDataThemeOptional(): CedrosDataThemeValue | null;

package/dist/react/CedrosDataProvider.js

@@ -0,0 +1,76 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef, useState } from "react";
+const CedrosDataThemeContext = createContext(null);
+/**
+ * Theme provider for cedros-data components.
+ *
+ * Applies `className` and inline `style` on the **same element** so that
+ * overrides always win over class-selector-based CSS variable declarations.
+ */
+export function CedrosDataProvider({ theme = "light", themeOverrides, unstyled = false, children, }) {
+    const stableOverrides = useStableOverrides(themeOverrides);
+    const value = useMemo(() => {
+        const isDark = theme === "dark";
+        if (unstyled) {
+            return { mode: theme, isDark, className: "", style: {}, unstyled: true, overrides: stableOverrides };
+        }
+        const className = isDark ? "cedros-dark" : "";
+        const style = overridesToStyle(stableOverrides);
+        return { mode: theme, isDark, className, style, unstyled: false, overrides: stableOverrides };
+    }, [theme, unstyled, stableOverrides]);
+    return (_jsx(CedrosDataThemeContext.Provider, { value: value, children: _jsx("div", { className: value.className || undefined, style: value.style, children: children }) }));
+}
+/**
+ * Returns the current theme context.
+ *
+ * Must be called inside a `<CedrosDataProvider>`.
+ */
+export function useCedrosDataTheme() {
+    const ctx = useContext(CedrosDataThemeContext);
+    if (!ctx) {
+        throw new Error("useCedrosDataTheme must be used within CedrosDataProvider");
+    }
+    return ctx;
+}
+/**
+ * Returns the current theme context, or `null` when outside a provider.
+ */
+export function useCedrosDataThemeOptional() {
+    return useContext(CedrosDataThemeContext);
+}
+// -- internals ----------------------------------------------------------------
+/** Deep-compare overrides so parent inline objects don't cause re-renders. */
+function useStableOverrides(overrides) {
+    const ref = useRef(overrides);
+    const [stable, setStable] = useState(overrides);
+    useEffect(() => {
+        if (shallowEqual(ref.current, overrides))
+            return;
+        ref.current = overrides;
+        setStable(overrides);
+    }, [overrides]);
+    return stable;
+}
+function shallowEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    return keysA.every((key) => a[key] === b[key]);
+}
+function overridesToStyle(overrides) {
+    if (!overrides)
+        return {};
+    const style = {};
+    for (const [key, value] of Object.entries(overrides)) {
+        if (value !== undefined) {
+            style[key] = value;
+        }
+    }
+    return style;
+}

package/dist/react/contentCollections.d.ts

@@ -0,0 +1,4 @@
+import type { ContentType } from "./types.js";
+export declare function collectionNameForContentType(contentType: ContentType): string;
+export declare function collectionNamesForContentType(contentType: ContentType): string[];
+export declare function queryEntriesByContentType<T>(serverUrl: string, contentType: ContentType, buildBody: (collectionName: string) => Record<string, unknown>, apiKey?: string): Promise<T>;

package/dist/react/contentCollections.js

@@ -0,0 +1,48 @@
+import { fetchJson } from "./fetch.js";
+const CANONICAL_CONTENT_TYPE_COLLECTIONS = {
+    page: "pages",
+    blog: "blog",
+    docs: "docs",
+    learn: "learn",
+    project: "projects",
+    airdrop: "airdrops",
+};
+const CONTENT_TYPE_COLLECTION_ALIASES = {
+    blog: ["blogs"],
+    learn: ["courses"],
+};
+export function collectionNameForContentType(contentType) {
+    return CANONICAL_CONTENT_TYPE_COLLECTIONS[contentType];
+}
+export function collectionNamesForContentType(contentType) {
+    const canonicalName = collectionNameForContentType(contentType);
+    const aliases = CONTENT_TYPE_COLLECTION_ALIASES[contentType] ?? [];
+    return [canonicalName, ...aliases.filter((alias) => alias !== canonicalName)];
+}
+export async function queryEntriesByContentType(serverUrl, contentType, buildBody, apiKey) {
+    return queryEntriesByCollectionNames(serverUrl, collectionNamesForContentType(contentType), buildBody, apiKey);
+}
+async function queryEntriesByCollectionNames(serverUrl, collectionNames, buildBody, apiKey) {
+    let lastCollectionNotFoundError;
+    const lastCollectionName = collectionNames[collectionNames.length - 1];
+    for (const collectionName of collectionNames) {
+        try {
+            return await fetchJson(serverUrl, "/entries/query", {
+                method: "POST",
+                body: buildBody(collectionName),
+                apiKey,
+            });
+        }
+        catch (error) {
+            if (!isCollectionNotFoundError(error) || collectionName === lastCollectionName) {
+                throw error;
+            }
+            lastCollectionNotFoundError = error;
+        }
+    }
+    throw (lastCollectionNotFoundError ??
+        new Error("@cedros/data-react: no collection names were configured"));
+}
+function isCollectionNotFoundError(error) {
+    return error instanceof Error && /collection not found/i.test(error.message);
+}

package/dist/react/entries.js

@@ -1,4 +1,5 @@
-import { fetchJson, resolveApiKey, resolveServerUrl } from "./fetch.js";
+import { resolveApiKey, resolveServerUrl } from "./fetch.js";
+import { queryEntriesByContentType } from "./contentCollections.js";
 /**
  * Fetches a single blog post by slug, optionally passing visitor_id for metered reads.
  *
@@ -10,7 +11,6 @@ export async function fetchBlogPost(slug, options) {
     const serverUrl = resolveServerUrl(options);
     const apiKey = resolveApiKey(options);
     const body = {
-        collection_name: "blog",
         entry_keys: [slug],
         limit: 1,
         offset: 0,
@@ -18,10 +18,9 @@ export async function fetchBlogPost(slug, options) {
     if (options?.visitorId) {
         body.visitor_id = options.visitorId;
     }
-    const entries = await fetchJson(serverUrl, "/entries/query", {
-        method: "POST",
-        body,
-        apiKey,
-    });
+    const entries = await queryEntriesByContentType(serverUrl, "blog", (collectionName) => ({
+        ...body,
+        collection_name: collectionName,
+    }), apiKey);
     return entries.length > 0 ? entries[0] : null;
 }

package/dist/react/index.d.ts

@@ -4,6 +4,8 @@
  * These exports are safe to use in React Client Components and
  * do not import any server-only modules.
  */
+export { CedrosDataProvider, useCedrosDataTheme, useCedrosDataThemeOptional, type CedrosDataProviderProps, } from "./CedrosDataProvider.js";
+export type { ThemeMode, CedrosDataThemeOverrides, CedrosDataThemeValue, } from "./theme.js";
 export { CmsContent, type CmsContentProps } from "./CmsContent.js";
 export { getOrCreateVisitorId } from "./visitor.js";
 export { sanitizeCmsHtml, renderCmsMarkdown } from "./sanitize.js";

package/dist/react/index.js

@@ -4,6 +4,7 @@
  * These exports are safe to use in React Client Components and
  * do not import any server-only modules.
  */
+export { CedrosDataProvider, useCedrosDataTheme, useCedrosDataThemeOptional, } from "./CedrosDataProvider.js";
 export { CmsContent } from "./CmsContent.js";
 export { getOrCreateVisitorId } from "./visitor.js";
 export { sanitizeCmsHtml, renderCmsMarkdown } from "./sanitize.js";

package/dist/react/sitemap.js

@@ -1,13 +1,5 @@
-import { fetchJson, resolveApiKey, resolveServerUrl } from "./fetch.js";
-/** Map of content types to their collection names in cedros-data. */
-const CONTENT_TYPE_COLLECTIONS = {
-    page: "pages",
-    blog: "blog",
-    docs: "docs",
-    learn: "learn",
-    project: "projects",
-    airdrop: "airdrops",
-};
+import { resolveApiKey, resolveServerUrl } from "./fetch.js";
+import { queryEntriesByContentType } from "./contentCollections.js";
 /** Default change frequency and priority for each content type. */
 const CONTENT_TYPE_DEFAULTS = {
     page: { changeFrequency: "monthly", priority: 0.8 },
@@ -67,17 +59,12 @@ export async function loadSitemapEntries(options) {
     return entries;
 }
 async function fetchCollectionSlugs(serverUrl, contentType, apiKey) {
-    const collectionName = CONTENT_TYPE_COLLECTIONS[contentType];
     const defaults = CONTENT_TYPE_DEFAULTS[contentType];
-    const records = await fetchJson(serverUrl, "/entries/query", {
-        method: "POST",
-        body: {
-            collection_name: collectionName,
-            limit: 1000,
-            offset: 0,
-        },
-        apiKey,
-    });
+    const records = await queryEntriesByContentType(serverUrl, contentType, (collectionName) => ({
+        collection_name: collectionName,
+        limit: 1000,
+        offset: 0,
+    }), apiKey);
     return records.map((record) => {
         const slug = record.payload.slug ??
             record.payload.route?.replace(/^\//, "") ??