@prenta/admin 0.92.0

package/dist/lib/notifications-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-client.d.ts","sourceRoot":"","sources":["../../src/lib/notifications-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/notifications-client.js

@@ -0,0 +1,173 @@
+/**
+ * Notifications REST client — typed wrapper around the slice-6 endpoints
+ * (`/notifications`, `/notifications/unread-count`,
+ * `/notifications/:id/read`, `/notifications/read-all`).
+ *
+ * Lives in `cms-admin` so the bell, the toast layer, and any future
+ * background sync agent share one request path, error model, and DTO
+ * shape. The wire format mirrors `NotificationDTO` in
+ * `@prenta/core/realtime/notifications.ts`; we duplicate the
+ * shape here to avoid taking a hard dependency on the server module
+ * (which carries Prisma types that don't belong in the admin bundle).
+ */
+import { cmsApi, getApiBase } from './api.js';
+function failure(error, status) {
+    return { ok: false, error, status };
+}
+function envelope(res) {
+    if (res.error || res.data === undefined) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data };
+}
+function buildQuery(opts = {}) {
+    const params = new URLSearchParams();
+    if (opts.includeRead)
+        params.set('includeRead', 'true');
+    if (opts.pageSize !== undefined)
+        params.set('pageSize', String(opts.pageSize));
+    const qs = params.toString();
+    return qs ? `?${qs}` : '';
+}
+export async function listNotifications(opts = {}) {
+    const res = await cmsApi(`/notifications${buildQuery(opts)}`, {
+        method: 'GET',
+    });
+    return envelope(res);
+}
+export async function unreadCount() {
+    const res = await cmsApi(`/notifications/unread-count`, {
+        method: 'GET',
+    });
+    if (res.error || !res.data) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data.count };
+}
+export async function markNotificationRead(id) {
+    if (!id)
+        return failure('notification id is required', 0);
+    const res = await cmsApi(`/notifications/${encodeURIComponent(id)}/read`, {
+        method: 'POST',
+        body: '{}',
+    });
+    return envelope(res);
+}
+export async function markAllNotificationsRead() {
+    const res = await cmsApi(`/notifications/read-all`, {
+        method: 'POST',
+        body: '{}',
+    });
+    if (res.error || !res.data) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data.count };
+}
+export function subscribeNotificationStream(opts) {
+    // The `cmsApi()` helper handles base-path / origin resolution for
+    // fetch calls, but EventSource takes a raw URL. We mirror its
+    // logic locally — `/api/cms/notifications/stream` is correct for
+    // both the local dev server and any production deploy that mounts
+    // the CMS API at the default prefix. Custom prefixes are handled by
+    // the consumer override (factory).
+    // Resolve against `setApiBase()` so a consumer mounting the CMS at
+    // a non-default prefix (e.g. `/cms-api`) still hits the right SSE
+    // endpoint — `EventSource` doesn't go through `cmsApi()`, so we
+    // can't rely on its url-construction logic.
+    const url = `${getApiBase()}/notifications/stream`;
+    const make = opts.factory ?? defaultEventSourceFactory;
+    const source = make(url);
+    if (!source) {
+        // No EventSource available (SSR? JSDOM without polyfill? Or the
+        // injected factory deliberately returns null in tests). Return a
+        // no-op handle so callers can compose without conditional logic.
+        return { close: () => { } };
+    }
+    let closed = false;
+    const onReady = (event) => {
+        if (!opts.onReady)
+            return;
+        const data = parseEventData(event);
+        if (data && typeof data.userId === 'string') {
+            opts.onReady({ userId: data.userId });
+        }
+    };
+    const onNotification = (event) => {
+        const data = parseEventData(event);
+        if (data && isNotification(data)) {
+            opts.onNotification(data);
+        }
+    };
+    const onError = (event) => {
+        opts.onError?.(event);
+    };
+    source.addEventListener('ready', onReady);
+    source.addEventListener('notification', onNotification);
+    source.addEventListener('error', onError);
+    return {
+        close: () => {
+            if (closed)
+                return;
+            closed = true;
+            source.removeEventListener?.('ready', onReady);
+            source.removeEventListener?.('notification', onNotification);
+            source.removeEventListener?.('error', onError);
+            source.close();
+        },
+    };
+}
+function defaultEventSourceFactory(url) {
+    if (typeof EventSource === 'undefined')
+        return null;
+    // `withCredentials: true` so the admin session cookie travels with
+    // the connection upgrade — every notification stream requires auth
+    // and the same-origin cookie is the only credential we trust here.
+    return new EventSource(url, { withCredentials: true });
+}
+function parseEventData(event) {
+    // EventSource emits MessageEvents with `data: string`. Plain
+    // `Event` (e.g. the `error` event) has no payload; ignore.
+    const data = event.data;
+    if (typeof data !== 'string')
+        return null;
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+function isNotification(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    // Defensive: don't trust the wire blindly — verify the discriminant
+    // properties our consumers will read. A drift in the server-side
+    // wire format must surface as "missing fields" in the test suite,
+    // not as runtime errors deep in the bell's render path.
+    return (typeof v.id === 'string' &&
+        typeof v.userId === 'string' &&
+        typeof v.createdAt === 'string' &&
+        !!v.payload &&
+        typeof v.payload.kind === 'string');
+}
+/**
+ * Cheap single-line summary for the bell list — the server gives us a
+ * structured payload, but the dropdown wants one human-readable string
+ * per row. Falls back to `Notification` when an unknown kind sneaks in
+ * (defensive against future server-side additions).
+ */
+export function notificationSummary(notification) {
+    const actor = notification.payload.actorName ?? 'Someone';
+    switch (notification.payload.kind) {
+        case 'comment_reply':
+            return `${actor} replied: "${notification.payload.excerpt}"`;
+        case 'comment_resolved':
+            return `${actor} resolved your thread: "${notification.payload.rootExcerpt}"`;
+        case 'comment_mention':
+            return `${actor} mentioned you: "${notification.payload.excerpt}"`;
+        default:
+            return 'Notification';
+    }
+}
+//# sourceMappingURL=notifications-client.js.map

package/dist/lib/notifications-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-client.js","sourceRoot":"","sources":["../../src/lib/notifications-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/page-editor-service.d.ts

@@ -0,0 +1,64 @@
+import { createSection, addSection, removeSection, duplicateSection, toggleSectionVisibility, moveSection, reorderSections, updateSectionContent, updateSectionContentAtPath, updateSectionSettings, updateSectionMeta, type PageSection } from '@prenta/core/page-sections';
+export type { PageSection } from '@prenta/core/page-sections';
+export { createSection, addSection, removeSection, duplicateSection, toggleSectionVisibility, moveSection, reorderSections, updateSectionContent, updateSectionContentAtPath, updateSectionSettings, updateSectionMeta, };
+export type PageStatus = 'DRAFT' | 'PUBLISHED' | 'SCHEDULED' | 'ARCHIVED';
+export declare const PAGES_COLLECTION = "pages";
+export interface EditorPage {
+    id: string | null;
+    title: string;
+    slug: string;
+    path: string;
+    status: PageStatus;
+    /**
+     * Parent page for the tree hierarchy (`data.parentPageId`), or null for
+     * a top-level page. Preselected when arriving via "Add sub-page"
+     * (`/pages/new?parent=<id>`); editable in Page settings.
+     */
+    parentPageId: string | null;
+    sections: PageSection[];
+    seoTitle: string;
+    seoDescription: string;
+    publishedAt: string | null;
+    updatedAt: string | null;
+    scheduledAt: string | null;
+    scheduledUnpublishAt: string | null;
+    /**
+     * True when the document was authored in the visual Page Builder (it carries
+     * a `_layout` tree). Such a page's `sections` are *compiled* from the layout
+     * on every save (ADR 0002), so the flat editor opens it read-only and points
+     * the user to the Page Builder instead of silently fighting the next save.
+     */
+    builderOwned: boolean;
+}
+export interface ValidationResult {
+    /** blocking issues — publish is disabled while any exist */
+    errors: string[];
+    /** non-blocking advisories (e.g. SEO) */
+    warnings: string[];
+}
+/**
+ * Validate a page for save/publish. `forPublish` turns on the stricter
+ * rules (at least one visible section, required section fields, valid
+ * button URLs, image alt text). SEO gaps are surfaced as warnings.
+ *
+ * Per-section rules are delegated to the shared `validateSectionContent`
+ * in `@prenta/core/page-sections`, so the editor and the
+ * server/MCP enforce identical content rules. Page-level rules
+ * (title/path, "at least one visible section", SEO) stay here because
+ * they operate on the whole `EditorPage`.
+ */
+export declare function validatePage(page: EditorPage, forPublish?: boolean): ValidationResult;
+export declare function missingPageFields(config: unknown): string[];
+export declare function fetchPageForEditor(pageId: string): Promise<EditorPage>;
+/** Create a new page document, returning the new id. */
+export declare function createPage(page: EditorPage): Promise<EditorPage>;
+/** Save the current draft (no status change). */
+export declare function savePageDraft(page: EditorPage): Promise<EditorPage>;
+/** Publish: persist the latest content and flip status to PUBLISHED. */
+export declare function publishPage(page: EditorPage): Promise<EditorPage>;
+/**
+ * A blank page scaffold for `/pages/new`. `parentPageId` is preset when
+ * the flow was entered via "Add sub-page" in the Pages tree view.
+ */
+export declare function emptyPage(parentPageId?: string | null): EditorPage;
+//# sourceMappingURL=page-editor-service.d.ts.map

package/dist/lib/page-editor-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-editor-service.d.ts","sourceRoot":"","sources":["../../src/lib/page-editor-service.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAGjB,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAA;AAKnC,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAI7D,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,GAClB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAA;AAEzE,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC;;;;;OAKG;IACH,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,UAAQ,GAAG,gBAAgB,CAoCnF;AAoBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAE3D;AAmDD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAI5E;AAkCD,wDAAwD;AACxD,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAOtE;AAED,iDAAiD;AACjD,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAQzE;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAUvE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,YAAY,GAAE,MAAM,GAAG,IAAW,GAAG,UAAU,CAiBxE"}

package/dist/lib/page-editor-service.js

@@ -0,0 +1,209 @@
+/**
+ * Page Editor service — data layer for the flat, section-based page
+ * editor (`/pages/:id/edit`).
+ *
+ * A page is a document in the `pages` collection. The editor reads and
+ * writes a single JSON field, `data.sections`, holding an ordered list of
+ * `PageSection`s. Save draft = `PUT` the sections (+ title/slug/SEO) with
+ * no status change; publish = the same payload plus `status: 'PUBLISHED'`.
+ *
+ * Persistence reuses the existing collection document API, so there is no
+ * new endpoint and no Prisma migration — `sections` is declared as a
+ * `type: 'json'` field on the `pages` collection so the field-access layer
+ * doesn't strip it on write.
+ *
+ * The section mutation helpers (`addSection`, `moveSection`, …) are pure
+ * functions over `PageSection[]` so the editor state and the unit tests
+ * share one implementation.
+ */
+import { cmsApi } from './api.js';
+import { getSectionType, createSection, addSection, removeSection, duplicateSection, toggleSectionVisibility, moveSection, reorderSections, updateSectionContent, updateSectionContentAtPath, updateSectionSettings, updateSectionMeta, coerceSections as coerceSectionsCore, validateSectionContent, } from '@prenta/core/page-sections';
+import { validateSlug } from '@prenta/core/client';
+import { missingCollectionFields } from './collection-schema.js';
+// Re-export the pure section helpers so existing editor imports
+// (`../../lib/page-editor-service.js`) keep working after the move to core.
+export { createSection, addSection, removeSection, duplicateSection, toggleSectionVisibility, moveSection, reorderSections, updateSectionContent, updateSectionContentAtPath, updateSectionSettings, updateSectionMeta, };
+export const PAGES_COLLECTION = 'pages';
+// ─── Validation ──────────────────────────────────────────────────────
+function isBlank(v) {
+    return v === undefined || v === null || (typeof v === 'string' && v.trim() === '');
+}
+/**
+ * Validate a page for save/publish. `forPublish` turns on the stricter
+ * rules (at least one visible section, required section fields, valid
+ * button URLs, image alt text). SEO gaps are surfaced as warnings.
+ *
+ * Per-section rules are delegated to the shared `validateSectionContent`
+ * in `@prenta/core/page-sections`, so the editor and the
+ * server/MCP enforce identical content rules. Page-level rules
+ * (title/path, "at least one visible section", SEO) stay here because
+ * they operate on the whole `EditorPage`.
+ */
+export function validatePage(page, forPublish = false) {
+    const errors = [];
+    const warnings = [];
+    if (isBlank(page.title))
+        errors.push('Page title is required.');
+    if (isBlank(page.path))
+        errors.push('Page path is required.');
+    // Mirror the server publish gate so an invalid/reserved slug surfaces in the
+    // validation summary rather than only as a toast after the publish attempt.
+    const slugError = validateSlug(page.slug);
+    if (slugError)
+        errors.push(slugError);
+    if (forPublish) {
+        const visible = page.sections.filter((s) => s.visible);
+        if (visible.length === 0) {
+            errors.push('Add at least one visible section before publishing.');
+        }
+        // Unmanaged (externally-managed) sections have no registered field schema,
+        // so they can't be content-validated here and must not block publish.
+        for (const section of visible.filter((s) => !s.unmanaged)) {
+            const def = getSectionType(section.sectionType);
+            const label = section.name || def?.name || 'Section';
+            const result = validateSectionContent(section.sectionType, section.content, section.settings);
+            for (const issue of result.errors) {
+                errors.push(`${label}: ${issue.message}`);
+            }
+        }
+        if (isBlank(page.seoTitle))
+            warnings.push('Add an SEO title to improve search results.');
+        if (isBlank(page.seoDescription)) {
+            warnings.push('Add an SEO description to improve search results.');
+        }
+    }
+    return { errors, warnings };
+}
+// ─── Schema guard ────────────────────────────────────────────────────
+/**
+ * The Page Editor persists `sections` / `path` / `metaTitle` /
+ * `metaDescription` as top-level keys on a `pages` document. The server's
+ * field-access layer only writes keys that are *declared as fields* on the
+ * collection — any undeclared key is silently dropped on save. A `pages`
+ * collection missing the `sections` field would therefore discard all page
+ * content with no error.
+ *
+ * `missingPageFields` returns the required field keys absent from the
+ * `pages` collection so the editor can refuse to operate (and explain why)
+ * rather than corrupt data. When `config` (or its collections) is not
+ * provided — some embedding/test contexts don't pass it — we can't check,
+ * so we return `[]` and trust the consumer.
+ */
+const REQUIRED_PAGE_FIELDS = ['sections', 'path', 'metaTitle', 'metaDescription'];
+export function missingPageFields(config) {
+    return missingCollectionFields(config, PAGES_COLLECTION, REQUIRED_PAGE_FIELDS);
+}
+function isPlainObject(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+function rowToEditorPage(doc) {
+    const data = doc.data ?? {};
+    const slug = doc.slug ?? '';
+    // The API lifts the stored `_layout` onto `doc.layout`, but tolerate either
+    // shape so ownership detection is robust to response variations.
+    const builderOwned = isPlainObject(doc.layout) || isPlainObject(data._layout);
+    return {
+        id: doc.id,
+        title: doc.title ?? '',
+        slug,
+        path: typeof data.path === 'string' && data.path ? data.path : slug ? `/${slug}` : '/',
+        status: doc.status ?? 'DRAFT',
+        parentPageId: typeof data.parentPageId === 'string' && data.parentPageId ? data.parentPageId : null,
+        // Preserve unknown (externally-managed) sections so the editor can show
+        // them read-only and round-trip them on save instead of dropping them.
+        sections: coerceSectionsCore(data.sections, { onUnknown: 'preserve' }),
+        seoTitle: typeof data.metaTitle === 'string' ? data.metaTitle : '',
+        seoDescription: typeof data.metaDescription === 'string' ? data.metaDescription : '',
+        publishedAt: doc.publishedAt ?? null,
+        updatedAt: doc.updatedAt ?? null,
+        scheduledAt: doc.scheduledAt ?? null,
+        scheduledUnpublishAt: doc.scheduledUnpublishAt ?? null,
+        builderOwned,
+    };
+}
+// ─── API calls ───────────────────────────────────────────────────────
+export async function fetchPageForEditor(pageId) {
+    const res = await cmsApi(`/collections/${PAGES_COLLECTION}/${pageId}`);
+    if (res.error || !res.data)
+        throw new Error(res.error ?? 'Failed to load page');
+    return rowToEditorPage(res.data);
+}
+// NOTE: `slug` may be empty for a brand-new draft. The `pages` collection
+// declares `slug` as a `type: 'slug'` field with `from: 'title'`, so the
+// server derives the slug from the title on create when none is supplied;
+// the derived value comes back in the response and populates `EditorPage`.
+// This is why `validatePage` requires a title but not a slug.
+function toWriteBody(page, extra) {
+    const payload = {
+        title: page.title,
+        slug: page.slug,
+        path: page.path,
+        parentPageId: page.parentPageId,
+        // Unmanaged sections are part of `page.sections`, so they round-trip on
+        // every save (no data loss). Strip the derived `unmanaged` marker — it is
+        // recomputed from the registry on read, so persisting it would only stale.
+        sections: page.sections.map(({ unmanaged: _unmanaged, ...rest }) => rest),
+        metaTitle: page.seoTitle,
+        metaDescription: page.seoDescription,
+        ...extra,
+    };
+    return JSON.stringify(payload);
+}
+/** Create a new page document, returning the new id. */
+export async function createPage(page) {
+    const res = await cmsApi(`/collections/${PAGES_COLLECTION}`, {
+        method: 'POST',
+        body: toWriteBody(page),
+    });
+    if (res.error || !res.data)
+        throw new Error(res.error ?? 'Failed to create page');
+    return rowToEditorPage(res.data);
+}
+/** Save the current draft (no status change). */
+export async function savePageDraft(page) {
+    if (!page.id)
+        return createPage(page);
+    const res = await cmsApi(`/collections/${PAGES_COLLECTION}/${page.id}`, {
+        method: 'PUT',
+        body: toWriteBody(page),
+    });
+    if (res.error || !res.data)
+        throw new Error(res.error ?? 'Failed to save draft');
+    return rowToEditorPage(res.data);
+}
+/** Publish: persist the latest content and flip status to PUBLISHED. */
+export async function publishPage(page) {
+    const endpoint = page.id
+        ? `/collections/${PAGES_COLLECTION}/${page.id}`
+        : `/collections/${PAGES_COLLECTION}`;
+    const res = await cmsApi(endpoint, {
+        method: page.id ? 'PUT' : 'POST',
+        body: toWriteBody(page, { status: 'PUBLISHED' }),
+    });
+    if (res.error || !res.data)
+        throw new Error(res.error ?? 'Failed to publish page');
+    return rowToEditorPage(res.data);
+}
+/**
+ * A blank page scaffold for `/pages/new`. `parentPageId` is preset when
+ * the flow was entered via "Add sub-page" in the Pages tree view.
+ */
+export function emptyPage(parentPageId = null) {
+    return {
+        id: null,
+        title: '',
+        slug: '',
+        path: '',
+        status: 'DRAFT',
+        parentPageId,
+        sections: [],
+        seoTitle: '',
+        seoDescription: '',
+        publishedAt: null,
+        updatedAt: null,
+        scheduledAt: null,
+        scheduledUnpublishAt: null,
+        builderOwned: false,
+    };
+}
+//# sourceMappingURL=page-editor-service.js.map

package/dist/lib/page-editor-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-editor-service.js","sourceRoot":"","sources":["../../src/lib/page-editor-service.ts"],"names":[],"mappings":"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"}

package/dist/lib/pages-service.d.ts

@@ -0,0 +1,185 @@
+export type PageStatus = 'DRAFT' | 'PUBLISHED' | 'SCHEDULED' | 'ARCHIVED';
+export declare const PAGES_COLLECTION = "pages";
+export declare const PAGE_TAGS_COLLECTION = "page-tags";
+export interface PageTag {
+    id: string;
+    docId: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    color: string | null;
+    pageCount: number;
+    sortOrder: number;
+    active: boolean;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface PageAuthor {
+    id: string;
+    name: string;
+    initials: string;
+}
+export interface Page {
+    id: string;
+    title: string;
+    path: string;
+    slug: string;
+    parentPageId: string | null;
+    tags: string[];
+    primaryTagId: string | null;
+    authorId: string;
+    authorName: string;
+    authorInitials: string;
+    status: PageStatus;
+    publishDate: string | null;
+    scheduledDate: string | null;
+    lastModified: string;
+    seoScore: number | null;
+    seoTitle: string | null;
+    seoDescription: string | null;
+    templateId: string | null;
+    isHomepage: boolean;
+    isSystemPage: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export type PageGroupBy = 'none' | 'tag' | 'status' | 'author';
+export interface PagesQuery {
+    search?: string;
+    tagIds?: string[];
+    status?: PageStatus | 'all';
+    authorId?: string | 'all';
+    groupBy?: PageGroupBy;
+    sortBy?: 'title' | 'author' | 'status' | 'modified' | 'seo';
+    sortDirection?: 'asc' | 'desc';
+    page?: number;
+    pageSize?: number;
+}
+export interface PagesResult {
+    pages: Page[];
+    /** number of pages matching the active query (post-filter) */
+    total: number;
+    /** total pages in the collection, ignoring the active query/filters */
+    grandTotal: number;
+    page: number;
+    pageSize: number;
+    tags: PageTag[];
+    authors: PageAuthor[];
+}
+/**
+ * The full, unfiltered page set plus its tags and authors. The list view
+ * fetches this once and applies search / sort / group / paging in memory
+ * (see `applyPagesQuery` + `groupPages`), so typing in the search box or
+ * changing the sort never re-downloads the dataset.
+ */
+export interface PagesDataset {
+    pages: Page[];
+    tags: PageTag[];
+    authors: PageAuthor[];
+}
+/**
+ * Fetch all tags. `pageCounts` (slug → count) is optional so the tag
+ * manager / pickers can render before page data is loaded.
+ */
+export declare function fetchPageTags(pageCounts?: Map<string, number>): Promise<PageTag[]>;
+export declare function fetchAuthors(): Promise<PageAuthor[]>;
+/**
+ * Pure filter+sort over an in-memory page set. Exported for unit tests
+ * (keeps filtering logic decoupled from the network).
+ */
+export declare function applyPagesQuery(all: Page[], query: PagesQuery): Page[];
+export interface PageGroup {
+    key: string;
+    label: string;
+    color: string | null;
+    pages: Page[];
+}
+/**
+ * Group an already-filtered/sorted page list. A page appears in exactly
+ * ONE group (no duplicates): for `tag`, its primary tag (or first tag,
+ * or "Untagged"). Returns a single "All pages" group for `none`.
+ */
+export declare function groupPages(pages: Page[], groupBy: PageGroupBy, tags: PageTag[]): PageGroup[];
+/**
+ * Fetch the entire page dataset (unfiltered) plus tags and authors. This
+ * is the single network read backing the list view; callers apply query
+ * shaping in memory. Tag page counts and the author list are derived from
+ * the full set so they reflect the dataset, not any active filter.
+ */
+export declare function fetchPagesDataset(): Promise<PagesDataset>;
+/**
+ * Query a paginated, filtered page list. Retained for non-list callers
+ * (tag detach/merge) and tests; the list view uses `fetchPagesDataset`
+ * directly and shapes the result in memory.
+ */
+export declare function fetchPages(query?: PagesQuery): Promise<PagesResult>;
+export declare function fetchPageById(pageId: string): Promise<Page | null>;
+export interface BulkResult {
+    ok: number;
+    failed: number;
+}
+export declare function bulkUpdatePages(ids: string[], payload: {
+    status?: PageStatus;
+    data?: Record<string, unknown>;
+}): Promise<BulkResult>;
+/** Duplicate a single page. Server resets status to DRAFT and appends "(Copy)". */
+export declare function duplicatePage(id: string): Promise<{
+    id?: string;
+    error?: string;
+}>;
+/**
+ * Reparent a page in the tree. `parentPageId: null` makes it top-level.
+ * Document updates merge `data`, so only the parent link changes.
+ */
+export declare function movePage(id: string, parentPageId: string | null): Promise<{
+    error?: string;
+}>;
+/** Soft-delete a single page. */
+export declare function deletePage(id: string): Promise<{
+    error?: string;
+}>;
+export declare function bulkDeletePages(ids: string[]): Promise<BulkResult>;
+/**
+ * Add or remove tag slugs across many pages. We fetch each page's
+ * current tags, merge/strip, then PUT the new `data.tags`. Done
+ * per-page because tags live in the document JSON (no bulk-tag endpoint
+ * yet). `primaryTag` is cleared if it was removed.
+ */
+export declare function bulkChangePageTags(pages: Pick<Page, 'id' | 'tags' | 'primaryTagId'>[], change: {
+    add?: string[];
+    remove?: string[];
+}): Promise<BulkResult>;
+export interface PageTagInput {
+    name: string;
+    slug?: string;
+    color?: string;
+    description?: string;
+    sortOrder?: number;
+    active?: boolean;
+}
+export declare function createPageTag(input: PageTagInput): Promise<{
+    error?: string;
+}>;
+export declare function updatePageTag(tagDocId: string, input: Partial<PageTagInput>): Promise<{
+    error?: string;
+}>;
+export declare function deletePageTag(tagDocId: string): Promise<{
+    error?: string;
+}>;
+/**
+ * Delete a tag and detach it from every page that uses it (so no
+ * dangling slugs remain in page `data.tags`). Used by the tag manager's
+ * "remove from all pages" deletion path.
+ */
+export declare function deletePageTagWithDetach(tag: PageTag): Promise<{
+    error?: string;
+}>;
+/**
+ * Merge `source` into `target`: every page tagged with the source slug
+ * gets the target slug (primary tag re-pointed too), then the source
+ * tag document is deleted.
+ */
+export declare function mergePageTags(source: PageTag, target: PageTag): Promise<{
+    error?: string;
+}>;
+//# sourceMappingURL=pages-service.d.ts.map