@cedros/data-react 0.1.0

package/dist/admin/sections/DataOpsSection.js

@@ -0,0 +1,245 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useDeferredValue, useMemo, useState } from "react";
+import { requestJson } from "../api.js";
+import { AdminButton, Card, JsonEditor, StatusNotice } from "../components.js";
+import { appendDataOpsHistory } from "../history.js";
+export default function DataOpsSection({ pluginContext }) {
+    const canWriteOps = pluginContext.hasPermission("data:ops:write");
+    const [status, setStatus] = useState("");
+    const [statusTone, setStatusTone] = useState("neutral");
+    const [importPayload, setImportPayload] = useState("");
+    const [overwriteContracts, setOverwriteContracts] = useState(true);
+    const [loading, setLoading] = useState(false);
+    const deferredImportPayload = useDeferredValue(importPayload);
+    const parsedImport = useMemo(() => parseSiteExport(deferredImportPayload), [deferredImportPayload]);
+    const importParsePending = isImportPayloadPending(importPayload, deferredImportPayload);
+    const importBlocked = loading ||
+        importPayload.trim().length === 0 ||
+        (!importParsePending && !!parsedImport.error) ||
+        !canWriteOps;
+    const runBootstrap = useCallback(async () => {
+        if (!canWriteOps) {
+            setStatus("You do not have permission to run data operations.");
+            setStatusTone("error");
+            return;
+        }
+        setLoading(true);
+        setStatus("");
+        setStatusTone("neutral");
+        try {
+            await requestJson(pluginContext, "/admin/bootstrap", {
+                method: "POST"
+            });
+            const historyResult = appendDataOpsHistory({
+                operation: "bootstrap",
+                status: "success",
+                message: "Defaults initialized."
+            });
+            setStatus(withHistoryWarning("Defaults initialized.", historyResult.warning));
+            setStatusTone("success");
+        }
+        catch (error) {
+            const historyResult = appendDataOpsHistory({
+                operation: "bootstrap",
+                status: "error",
+                message: error.message
+            });
+            setStatus(withHistoryWarning(error.message, historyResult.warning));
+            setStatusTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [canWriteOps, pluginContext]);
+    const exportSite = useCallback(async () => {
+        if (!canWriteOps) {
+            setStatus("You do not have permission to run data operations.");
+            setStatusTone("error");
+            return;
+        }
+        setLoading(true);
+        setStatus("");
+        setStatusTone("neutral");
+        try {
+            const payload = await requestJson(pluginContext, "/site/export");
+            const payloadJson = JSON.stringify(payload, null, 2);
+            setImportPayload(payloadJson);
+            const historyResult = appendDataOpsHistory({
+                operation: "export",
+                status: "success",
+                message: "Site export generated.",
+                artifact: formatHistoryArtifact("export", summarizeSiteExport(payload))
+            });
+            setStatus(withHistoryWarning("Export loaded into editor.", historyResult.warning));
+            setStatusTone("success");
+        }
+        catch (error) {
+            const historyResult = appendDataOpsHistory({
+                operation: "export",
+                status: "error",
+                message: error.message
+            });
+            setStatus(withHistoryWarning(error.message, historyResult.warning));
+            setStatusTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [canWriteOps, pluginContext]);
+    const importSite = useCallback(async () => {
+        if (!canWriteOps) {
+            setStatus("You do not have permission to run data operations.");
+            setStatusTone("error");
+            return;
+        }
+        const currentImport = resolveImportPayload(importPayload, deferredImportPayload, parsedImport);
+        if (currentImport.error) {
+            setStatus(currentImport.error);
+            setStatusTone("error");
+            return;
+        }
+        if (!currentImport.value) {
+            setStatus("Import payload is required.");
+            setStatusTone("error");
+            return;
+        }
+        setLoading(true);
+        setStatus("");
+        setStatusTone("neutral");
+        try {
+            await requestJson(pluginContext, "/import", {
+                method: "POST",
+                body: {
+                    export: currentImport.value,
+                    overwrite_contracts: overwriteContracts
+                }
+            });
+            const historyResult = appendDataOpsHistory({
+                operation: "import",
+                status: "success",
+                message: "Import complete.",
+                artifact: currentImport.summary === null
+                    ? undefined
+                    : formatHistoryArtifact("import", currentImport.summary, overwriteContracts)
+            });
+            const successMessage = overwriteContracts
+                ? "Import complete. Contracts were overwritten from payload."
+                : "Import complete. Existing strict contracts and contract history were preserved.";
+            setStatus(withHistoryWarning(successMessage, historyResult.warning));
+            setStatusTone("success");
+        }
+        catch (error) {
+            const historyResult = appendDataOpsHistory({
+                operation: "import",
+                status: "error",
+                message: error.message,
+                artifact: currentImport.summary === null
+                    ? undefined
+                    : formatHistoryArtifact("import", currentImport.summary, overwriteContracts)
+            });
+            setStatus(withHistoryWarning(error.message, historyResult.warning));
+            setStatusTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [
+        canWriteOps,
+        deferredImportPayload,
+        importPayload,
+        overwriteContracts,
+        parsedImport,
+        pluginContext
+    ]);
+    return (_jsxs("div", { className: "cedros-data", children: [_jsxs("header", { className: "cedros-data__header", children: [_jsxs("div", { children: [_jsx("h2", { className: "cedros-data__title", children: "Data Operations" }), _jsx("p", { className: "cedros-data__subtitle", children: "Bootstrap defaults and run import/export for this deployment." }), !canWriteOps && (_jsx("p", { className: "cedros-data__subtitle", children: "Read-only mode. Missing `data:ops:write` permission." }))] }), _jsxs("div", { className: "cedros-data-actions", children: [_jsx(AdminButton, { variant: "secondary", onClick: () => void runBootstrap(), disabled: loading || !canWriteOps, title: !canWriteOps ? "Requires data:ops:write" : undefined, children: "Initialize Defaults" }), _jsx(AdminButton, { variant: "secondary", onClick: () => void exportSite(), disabled: loading || !canWriteOps, title: !canWriteOps ? "Requires data:ops:write" : undefined, children: "Export Site" }), _jsx(AdminButton, { variant: "primary", onClick: () => void importSite(), disabled: importBlocked, title: !canWriteOps ? "Requires data:ops:write" : undefined, children: "Import JSON" })] })] }), _jsx(Card, { title: "Import / Export Payload", subtitle: "Review exported JSON or paste a payload to import.", children: _jsx(JsonEditor, { label: "SiteExport JSON", value: importPayload, onChange: (event) => setImportPayload(event.target.value), placeholder: "Paste SiteExport JSON here to import", disabled: !canWriteOps }) }), _jsxs(Card, { title: "Import Options", subtitle: "Choose safe import behavior before applying payloads.", children: [_jsxs("label", { className: "cedros-data-checkbox-row", children: [_jsx("input", { type: "checkbox", checked: overwriteContracts, onChange: (event) => setOverwriteContracts(event.target.checked), disabled: loading || !canWriteOps }), _jsx("span", { children: "Overwrite stored strict contracts and contract history from import payload" })] }), _jsx("div", { className: "cedros-data-key", children: importParsePending ? ("Parsing payload") : parsedImport.summary ? (_jsxs(_Fragment, { children: ["Payload summary", parsedImport.summary.displayName
+                                    ? ` • deployment: ${parsedImport.summary.displayName}`
+                                    : "", " ", "\u2022 collections: ", parsedImport.summary.collections, " ", "\u2022 contracts: ", parsedImport.summary.contracts, " ", "\u2022 entries: ", parsedImport.summary.entries, " ", "\u2022 custom schema: ", parsedImport.summary.hasCustomSchema ? "yes" : "no"] })) : ("Payload not parsed") }), !importParsePending && parsedImport.error && (_jsx(StatusNotice, { tone: "error", message: parsedImport.error }))] }), status && _jsx(StatusNotice, { tone: statusTone, message: status })] }));
+}
+export function parseSiteExport(raw) {
+    if (!raw.trim()) {
+        return { value: null, summary: null, error: null };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        return { value: null, summary: null, error: `Invalid import JSON: ${error.message}` };
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return {
+            value: null,
+            summary: null,
+            error: "Invalid import JSON: root value must be an object matching SiteExport."
+        };
+    }
+    const value = parsed;
+    return {
+        value,
+        summary: {
+            displayName: readDisplayName(value.site),
+            collections: Array.isArray(value.collections) ? value.collections.length : 0,
+            contracts: Array.isArray(value.contracts) ? value.contracts.length : 0,
+            entries: countEntries(value.entries),
+            hasCustomSchema: value.custom_schema !== null && value.custom_schema !== undefined
+        },
+        error: null
+    };
+}
+export function isImportPayloadPending(raw, deferredRaw) {
+    return raw.trim().length > 0 && raw !== deferredRaw;
+}
+export function resolveImportPayload(raw, deferredRaw, deferredParsed) {
+    if (!isImportPayloadPending(raw, deferredRaw)) {
+        return deferredParsed;
+    }
+    return parseSiteExport(raw);
+}
+function readDisplayName(site) {
+    if (!site || typeof site !== "object" || Array.isArray(site)) {
+        return "";
+    }
+    const displayName = site.display_name;
+    return typeof displayName === "string" ? displayName : "";
+}
+function countEntries(entries) {
+    if (!Array.isArray(entries)) {
+        return 0;
+    }
+    return entries.reduce((total, item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            return total;
+        }
+        const entryList = item.entries;
+        if (!Array.isArray(entryList)) {
+            return total;
+        }
+        return total + entryList.length;
+    }, 0);
+}
+function summarizeSiteExport(payload) {
+    return {
+        displayName: readDisplayName(payload.site),
+        collections: Array.isArray(payload.collections) ? payload.collections.length : 0,
+        contracts: Array.isArray(payload.contracts) ? payload.contracts.length : 0,
+        entries: countEntries(payload.entries),
+        hasCustomSchema: payload.custom_schema !== null && payload.custom_schema !== undefined
+    };
+}
+function withHistoryWarning(message, warning) {
+    if (!warning) {
+        return message;
+    }
+    return `${message} ${warning}`;
+}
+export function formatHistoryArtifact(operation, summary, overwriteContracts) {
+    return JSON.stringify({
+        operation,
+        displayName: summary.displayName || undefined,
+        collections: summary.collections,
+        contracts: summary.contracts,
+        entries: summary.entries,
+        hasCustomSchema: summary.hasCustomSchema,
+        ...(operation === "import" ? { overwriteContracts: overwriteContracts === true } : {})
+    }, null, 2);
+}

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

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

package/dist/admin/sections/HistorySection.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { AdminButton, Card, JsonEditor, StatusNotice } from "../components.js";
+import { clearDataOpsHistory, readDataOpsHistory } from "../history.js";
+export default function HistorySection({ pluginContext }) {
+    const [records, setRecords] = useState([]);
+    const [activeId, setActiveId] = useState("");
+    const [status, setStatus] = useState("");
+    const [tone, setTone] = useState("neutral");
+    const load = useCallback(() => {
+        const history = readDataOpsHistory();
+        setRecords(history);
+        setActiveId((current) => current || history[0]?.id || "");
+    }, []);
+    useEffect(() => {
+        load();
+    }, [load]);
+    const active = useMemo(() => records.find((record) => record.id === activeId) ?? null, [activeId, records]);
+    const clear = useCallback(() => {
+        const result = clearDataOpsHistory();
+        load();
+        setStatus(result.warning ? `History cleared. ${result.warning}` : "History cleared.");
+        setTone("success");
+    }, [load]);
+    return (_jsxs("div", { className: "cedros-data", children: [_jsxs("header", { className: "cedros-data__header", children: [_jsxs("div", { children: [_jsx("h2", { className: "cedros-data__title", children: "Import / Export History" }), _jsx("p", { className: "cedros-data__subtitle", children: "Local operation history for this deployment." })] }), _jsxs("div", { className: "cedros-data-actions", children: [_jsx(AdminButton, { variant: "secondary", onClick: load, children: "Refresh" }), _jsx(AdminButton, { variant: "danger", onClick: clear, children: "Clear History" })] })] }), _jsxs("div", { className: "cedros-data-grid cedros-data-grid--page", children: [_jsx(Card, { title: `Operations (${records.length})`, subtitle: "Newest first.", children: _jsxs("div", { className: "cedros-data-list", children: [records.length === 0 && _jsx("div", { className: "cedros-data-empty", children: "No history records yet." }), records.map((record) => (_jsxs("button", { className: `cedros-data-list-item ${record.id === activeId ? "cedros-data-list-item--active" : ""}`, onClick: () => setActiveId(record.id), children: [_jsxs("div", { style: { display: "flex", justifyContent: "space-between", gap: "0.5rem" }, children: [_jsx("strong", { children: record.operation }), _jsx("span", { className: "cedros-data-pill", children: record.status })] }), _jsx("div", { className: "cedros-data-key", children: new Date(record.createdAt).toLocaleString() }), _jsx("div", { className: "cedros-data-key", children: record.message })] }, record.id)))] }) }), _jsx(Card, { title: "Artifact", subtitle: "Stored operation summary; full payloads are not persisted in local history.", children: active ? (_jsx(JsonEditor, { label: `${active.operation} artifact`, value: active.artifact || "// No summary captured for this operation.", readOnly: true })) : (_jsx("div", { className: "cedros-data-empty", children: "Select an operation to inspect." })) })] }), status && _jsx(StatusNotice, { tone: tone, message: status })] }));
+}

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

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

package/dist/admin/sections/MonetizationSection.js

@@ -0,0 +1,140 @@
+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, JsonEditor, SelectInput, StatusNotice, TextInput } from "../components.js";
+const DEFAULT_CONFIG = {
+    enabled: false,
+    defaultAccessMode: "free",
+    defaultPreviewParagraphs: 3,
+    subscriptionProductId: "",
+    creditsPerArticle: 0,
+    freeReadsPerMonth: 0
+};
+export default function MonetizationSection({ pluginContext }) {
+    const canWrite = pluginContext.hasPermission("data:settings:write");
+    const [payload, setPayload] = useState({ ...DEFAULT_CONFIG });
+    const [config, setConfig] = useState(DEFAULT_CONFIG);
+    const [rawEditor, setRawEditor] = useState(JSON.stringify(DEFAULT_CONFIG, null, 2));
+    const [status, setStatus] = useState("");
+    const [tone, setTone] = useState("neutral");
+    const [loading, setLoading] = useState(false);
+    const load = useCallback(async () => {
+        setLoading(true);
+        setStatus("");
+        setTone("neutral");
+        try {
+            const entries = await requestJson(pluginContext, "/entries/query", {
+                method: "POST",
+                body: {
+                    collection_name: "site_settings",
+                    entry_keys: ["monetization"],
+                    contains: null,
+                    limit: 1,
+                    offset: 0
+                }
+            });
+            const raw = normalizePayload(entries[0]?.payload ?? DEFAULT_CONFIG);
+            const typed = toConfig(raw);
+            setPayload(raw);
+            setConfig(typed);
+            setRawEditor(JSON.stringify(raw, null, 2));
+        }
+        catch (error) {
+            setStatus(error.message);
+            setTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [pluginContext]);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    const save = useCallback(async (nextPayload) => {
+        if (!canWrite) {
+            setStatus("You do not have permission to edit monetization settings.");
+            setTone("error");
+            return;
+        }
+        setLoading(true);
+        setStatus("");
+        setTone("neutral");
+        try {
+            await requestJson(pluginContext, "/entries/upsert", {
+                method: "POST",
+                body: {
+                    collection_name: "site_settings",
+                    entry_key: "monetization",
+                    payload: nextPayload
+                }
+            });
+            setPayload(nextPayload);
+            setConfig(toConfig(nextPayload));
+            setRawEditor(JSON.stringify(nextPayload, null, 2));
+            setStatus("Monetization settings saved.");
+            setTone("success");
+        }
+        catch (error) {
+            setStatus(error.message);
+            setTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [canWrite, pluginContext]);
+    const saveForm = useCallback(async () => {
+        await save(mergeConfigIntoPayload(payload, config));
+    }, [save, config, payload]);
+    const applyRaw = useCallback(async () => {
+        let parsed;
+        try {
+            parsed = JSON.parse(rawEditor);
+        }
+        catch (error) {
+            setStatus(`Invalid JSON: ${error.message}`);
+            setTone("error");
+            return;
+        }
+        await save(normalizePayload(parsed));
+    }, [rawEditor, save]);
+    return (_jsxs("div", { className: "cedros-data", children: [_jsxs("header", { className: "cedros-data__header", children: [_jsxs("div", { children: [_jsx("h2", { className: "cedros-data__title", children: "Monetization" }), _jsx("p", { className: "cedros-data__subtitle", children: "Configure content monetization and paywall defaults." }), !canWrite && (_jsx("p", { className: "cedros-data__subtitle", children: "Read-only mode. 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 saveForm(), disabled: loading || !canWrite, title: !canWrite ? "Requires data:settings:write" : undefined, children: "Save Form" }), _jsx(AdminButton, { variant: "secondary", onClick: () => void applyRaw(), disabled: loading || !canWrite, title: !canWrite ? "Requires data:settings:write" : undefined, children: "Save JSON" })] })] }), _jsxs("div", { className: "cedros-data-grid cedros-data-grid--two", children: [_jsxs(Card, { title: "Monetization Settings", subtitle: "Default content access and pricing.", children: [_jsxs("label", { className: "cedros-data-checkbox-row", children: [_jsx("input", { type: "checkbox", checked: config.enabled, onChange: (e) => setConfig((prev) => ({ ...prev, enabled: e.target.checked })), disabled: !canWrite }), "Enabled"] }), _jsxs(SelectInput, { label: "Default Access Mode", value: config.defaultAccessMode, onChange: (e) => setConfig((prev) => ({ ...prev, defaultAccessMode: e.target.value })), disabled: !canWrite, children: [_jsx("option", { value: "free", children: "Free" }), _jsx("option", { value: "preview", children: "Preview" }), _jsx("option", { value: "locked", children: "Locked" })] }), _jsx(TextInput, { label: "Preview Paragraphs", type: "number", value: String(config.defaultPreviewParagraphs), onChange: (e) => setConfig((prev) => ({
+                                    ...prev,
+                                    defaultPreviewParagraphs: parseInt(e.target.value, 10) || 3
+                                })), placeholder: "3", disabled: !canWrite }), _jsx(TextInput, { label: "Subscription Product ID", value: config.subscriptionProductId, onChange: (e) => setConfig((prev) => ({ ...prev, subscriptionProductId: e.target.value })), placeholder: "product_xxx", disabled: !canWrite }), _jsx(TextInput, { label: "Credits per Article", type: "number", value: String(config.creditsPerArticle), onChange: (e) => setConfig((prev) => ({
+                                    ...prev,
+                                    creditsPerArticle: parseInt(e.target.value, 10) || 0
+                                })), placeholder: "0", disabled: !canWrite }), _jsx(TextInput, { label: "Free Reads per Month", type: "number", value: String(config.freeReadsPerMonth), onChange: (e) => setConfig((prev) => ({
+                                    ...prev,
+                                    freeReadsPerMonth: Math.max(0, parseInt(e.target.value, 10) || 0)
+                                })), placeholder: "0", disabled: !canWrite }), _jsx("p", { className: "cedros-data__subtitle", style: { margin: 0 }, children: "Number of articles readers can view for free each month before the paywall activates. Set to 0 to disable." })] }), _jsx(Card, { title: "Monetization JSON", subtitle: "Advanced editor for pricing, payment methods, and more.", children: _jsx(JsonEditor, { label: "site_settings/monetization", value: rawEditor, onChange: (e) => setRawEditor(e.target.value), disabled: !canWrite }) })] }), status && _jsx(StatusNotice, { tone: tone, message: status })] }));
+}
+function normalizePayload(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    return { ...value };
+}
+function mergeConfigIntoPayload(payload, config) {
+    return { ...normalizePayload(payload), ...config };
+}
+function toConfig(value) {
+    const source = normalizePayload(value);
+    return {
+        enabled: typeof source.enabled === "boolean" ? source.enabled : DEFAULT_CONFIG.enabled,
+        defaultAccessMode: typeof source.defaultAccessMode === "string" && source.defaultAccessMode
+            ? source.defaultAccessMode
+            : DEFAULT_CONFIG.defaultAccessMode,
+        defaultPreviewParagraphs: typeof source.defaultPreviewParagraphs === "number"
+            ? source.defaultPreviewParagraphs
+            : DEFAULT_CONFIG.defaultPreviewParagraphs,
+        subscriptionProductId: typeof source.subscriptionProductId === "string"
+            ? source.subscriptionProductId
+            : DEFAULT_CONFIG.subscriptionProductId,
+        creditsPerArticle: typeof source.creditsPerArticle === "number"
+            ? source.creditsPerArticle
+            : DEFAULT_CONFIG.creditsPerArticle,
+        freeReadsPerMonth: typeof source.freeReadsPerMonth === "number"
+            ? source.freeReadsPerMonth
+            : DEFAULT_CONFIG.freeReadsPerMonth
+    };
+}

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

@@ -0,0 +1,13 @@
+import type { AdminSectionProps } from "../types.js";
+interface NavigationItem {
+    key: string;
+    label: string;
+    route: string;
+}
+type NavigationPayload = Record<string, unknown>;
+export default function NavigationSection({ pluginContext }: AdminSectionProps): React.JSX.Element;
+export declare function normalizeNavigationPayload(value: unknown): NavigationPayload;
+export declare function addNavigationItemToPayload(payload: NavigationPayload, item: NavigationItem): NavigationPayload;
+export declare function removeNavigationItemFromPayload(payload: NavigationPayload, key: string): NavigationPayload;
+export declare function moveNavigationItemInPayload(payload: NavigationPayload, from: number, to: number): NavigationPayload;
+export {};

package/dist/admin/sections/NavigationSection.js

@@ -0,0 +1,195 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { requestJson } from "../api.js";
+import { AdminButton, Card, JsonEditor, StatusNotice, TextInput } from "../components.js";
+const DEFAULT_NAV = {
+    key: "main",
+    items: []
+};
+export default function NavigationSection({ pluginContext }) {
+    const canWriteNavigation = pluginContext.hasPermission("data:navigation:write");
+    const [payload, setPayload] = useState(normalizeNavigationPayload(DEFAULT_NAV));
+    const [rawEditor, setRawEditor] = useState(JSON.stringify(DEFAULT_NAV, null, 2));
+    const [newLabel, setNewLabel] = useState("");
+    const [newRoute, setNewRoute] = useState("");
+    const [status, setStatus] = useState("");
+    const [tone, setTone] = useState("neutral");
+    const [loading, setLoading] = useState(false);
+    const record = useMemo(() => toNavigationRecord(payload), [payload]);
+    const load = useCallback(async () => {
+        setLoading(true);
+        setStatus("");
+        setTone("neutral");
+        try {
+            const entries = await requestJson(pluginContext, "/entries/query", {
+                method: "POST",
+                body: {
+                    collection_name: "navigation",
+                    entry_keys: ["main"],
+                    contains: null,
+                    limit: 1,
+                    offset: 0
+                }
+            });
+            const nextPayload = normalizeNavigationPayload(entries[0]?.payload ?? DEFAULT_NAV);
+            setPayload(nextPayload);
+            setRawEditor(JSON.stringify(nextPayload, null, 2));
+        }
+        catch (error) {
+            setStatus(error.message);
+            setTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [pluginContext]);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    const save = useCallback(async (nextPayload) => {
+        if (!canWriteNavigation) {
+            setStatus("You do not have permission to edit navigation.");
+            setTone("error");
+            return;
+        }
+        setLoading(true);
+        setStatus("");
+        setTone("neutral");
+        try {
+            await requestJson(pluginContext, "/entries/upsert", {
+                method: "POST",
+                body: {
+                    collection_name: "navigation",
+                    entry_key: "main",
+                    payload: nextPayload
+                }
+            });
+            setPayload(nextPayload);
+            setRawEditor(JSON.stringify(nextPayload, null, 2));
+            setStatus("Navigation saved.");
+            setTone("success");
+        }
+        catch (error) {
+            setStatus(error.message);
+            setTone("error");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [canWriteNavigation, pluginContext]);
+    const addItem = useCallback(async () => {
+        if (!canWriteNavigation) {
+            setStatus("You do not have permission to edit navigation.");
+            setTone("error");
+            return;
+        }
+        const label = newLabel.trim();
+        const route = newRoute.trim();
+        if (!label || !route) {
+            setStatus("Both label and route are required.");
+            setTone("error");
+            return;
+        }
+        const key = `${label.toLowerCase().replace(/[^a-z0-9]+/g, "-") || "item"}-${record.items.length + 1}`;
+        await save(addNavigationItemToPayload(payload, { key, label, route }));
+        setNewLabel("");
+        setNewRoute("");
+    }, [canWriteNavigation, newLabel, newRoute, payload, record.items.length, save]);
+    const removeItem = useCallback(async (key) => {
+        await save(removeNavigationItemFromPayload(payload, key));
+    }, [payload, save]);
+    const applyRaw = useCallback(async () => {
+        let parsed;
+        try {
+            parsed = JSON.parse(rawEditor);
+        }
+        catch (error) {
+            setStatus(`Invalid JSON: ${error.message}`);
+            setTone("error");
+            return;
+        }
+        const next = normalizeNavigationPayload(parsed);
+        await save(next);
+    }, [rawEditor, save]);
+    return (_jsxs("div", { className: "cedros-data", children: [_jsxs("header", { className: "cedros-data__header", children: [_jsxs("div", { children: [_jsx("h2", { className: "cedros-data__title", children: "Navigation" }), _jsx("p", { className: "cedros-data__subtitle", children: "Edit the main menu links for this site." }), !canWriteNavigation && (_jsx("p", { className: "cedros-data__subtitle", children: "Read-only mode. Missing `data:navigation: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 applyRaw(), disabled: loading || !canWriteNavigation, title: !canWriteNavigation ? "Requires data:navigation:write" : undefined, children: "Save JSON" })] })] }), _jsxs("div", { className: "cedros-data-grid cedros-data-grid--two", children: [_jsxs(Card, { title: "Main Menu Items", subtitle: `${record.items.length} item(s)`, children: [_jsxs("div", { className: "cedros-data-actions", children: [_jsx(TextInput, { label: "Label", value: newLabel, onChange: (event) => setNewLabel(event.target.value), placeholder: "Pricing", disabled: !canWriteNavigation }), _jsx(TextInput, { label: "Route", value: newRoute, onChange: (event) => setNewRoute(event.target.value), placeholder: "/pricing", disabled: !canWriteNavigation }), _jsx(AdminButton, { variant: "secondary", onClick: () => void addItem(), disabled: loading || !canWriteNavigation, title: !canWriteNavigation ? "Requires data:navigation:write" : undefined, children: "Add Item" })] }), _jsxs("div", { className: "cedros-data-list", children: [record.items.length === 0 && _jsx("div", { className: "cedros-data-empty", children: "No navigation items." }), record.items.map((item, index) => (_jsxs("div", { className: "cedros-data-list-item cedros-data-list-item--active", children: [_jsx("div", { children: item.label }), _jsx("div", { className: "cedros-data-key", children: item.route }), _jsxs("div", { className: "cedros-data-actions", style: { marginTop: "0.4rem" }, children: [_jsx(AdminButton, { variant: "secondary", size: "sm", onClick: () => void save(moveNavigationItemInPayload(payload, index, index - 1)), disabled: loading || !canWriteNavigation || index === 0, children: "Up" }), _jsx(AdminButton, { variant: "secondary", size: "sm", onClick: () => void save(moveNavigationItemInPayload(payload, index, index + 1)), disabled: loading || !canWriteNavigation || index === record.items.length - 1, children: "Down" }), _jsx(AdminButton, { variant: "danger", size: "sm", onClick: () => void removeItem(item.key), disabled: loading || !canWriteNavigation, children: "Remove" })] })] }, item.key)))] })] }), _jsx(Card, { title: "Navigation JSON", subtitle: "Advanced editor for full navigation payload.", children: _jsx(JsonEditor, { label: "navigation/main", value: rawEditor, onChange: (event) => setRawEditor(event.target.value), disabled: !canWriteNavigation }) })] }), status && _jsx(StatusNotice, { tone: tone, message: status })] }));
+}
+export function normalizeNavigationPayload(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return {
+            key: DEFAULT_NAV.key,
+            items: []
+        };
+    }
+    const source = value;
+    return {
+        ...source,
+        items: Array.isArray(source.items)
+            ? source.items.map((item) => item && typeof item === "object" && !Array.isArray(item)
+                ? { ...item }
+                : item)
+            : []
+    };
+}
+export function addNavigationItemToPayload(payload, item) {
+    const next = normalizeNavigationPayload(payload);
+    const rawItems = readRawNavigationItems(next);
+    return {
+        ...next,
+        key: typeof next.key === "string" ? next.key : DEFAULT_NAV.key,
+        items: [...rawItems, { ...item }]
+    };
+}
+export function removeNavigationItemFromPayload(payload, key) {
+    const next = normalizeNavigationPayload(payload);
+    const rawItems = readRawNavigationItems(next).filter((item, index) => readNavigationItem(item, index).key !== key);
+    return {
+        ...next,
+        key: typeof next.key === "string" ? next.key : DEFAULT_NAV.key,
+        items: rawItems
+    };
+}
+export function moveNavigationItemInPayload(payload, from, to) {
+    const next = normalizeNavigationPayload(payload);
+    const rawItems = readRawNavigationItems(next);
+    if (to < 0 || to >= rawItems.length || from === to) {
+        return next;
+    }
+    const reordered = [...rawItems];
+    const [moved] = reordered.splice(from, 1);
+    if (moved === undefined) {
+        return next;
+    }
+    reordered.splice(to, 0, moved);
+    return {
+        ...next,
+        key: typeof next.key === "string" ? next.key : DEFAULT_NAV.key,
+        items: reordered
+    };
+}
+function readRawNavigationItems(payload) {
+    return Array.isArray(payload.items) ? [...payload.items] : [];
+}
+function toNavigationRecord(value) {
+    const source = normalizeNavigationPayload(value);
+    const key = typeof source.key === "string" ? source.key : "main";
+    const items = readRawNavigationItems(source).map((item, index) => readNavigationItem(item, index));
+    return { key, items };
+}
+function readNavigationItem(value, index) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return {
+            key: `item-${index + 1}`,
+            label: `Item ${index + 1}`,
+            route: "/"
+        };
+    }
+    const source = value;
+    const label = typeof source.label === "string" ? source.label : `Item ${index + 1}`;
+    return {
+        key: typeof source.key === "string"
+            ? source.key
+            : `${label.toLowerCase().replace(/[^a-z0-9]+/g, "-") || "item"}-${index + 1}`,
+        label,
+        route: typeof source.route === "string" ? source.route : "/"
+    };
+}

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

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