@prenta/admin 2.6.1 → 2.8.0

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

@@ -0,0 +1,69 @@
+/**
+ * Site chrome API (DATA_CONTRACTS §2) for Appearance → Header & Footer.
+ * Region values and the announcement come with an `ETag`; a save sends it as
+ * `If-Match`, so a stale form gets 412 instead of overwriting a newer save.
+ */
+import type { Announcement, ChromeOverridesList, ChromeRegionName, ChromeSettings, ChromeSyncStatus, RegionSchema, RegionValues } from '@prenta/core';
+export interface ChromeSchemaView {
+    regions: RegionSchema[];
+    sync: ChromeSyncStatus;
+}
+/** A result the screen can show: the value, or why there isn't one. */
+export type ChromeResult<T> = {
+    ok: true;
+    value: T;
+    etag: string | null;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+};
+export declare function fetchChromeSchema(): Promise<ChromeResult<ChromeSchemaView>>;
+/** 404 until the site has pushed the region's schema. */
+export declare function fetchRegion(region: ChromeRegionName): Promise<ChromeResult<RegionValues>>;
+/** What `PUT /chrome/:region` takes. `fields` replaces every saved value. */
+export interface RegionSaveBody {
+    variant: string;
+    fields: Record<string, unknown>;
+}
+export declare function saveRegion(region: ChromeRegionName, body: RegionSaveBody, etag: string | null): Promise<ChromeResult<RegionValues>>;
+/** "Remove now" on the orphan row. */
+export declare function removeOrphan(region: ChromeRegionName, key: string): Promise<ChromeResult<RegionValues>>;
+export declare function fetchAnnouncement(): Promise<ChromeResult<Announcement>>;
+/** What `PUT /chrome/announcement` takes. The server mints `id`. */
+export type AnnouncementSaveBody = Omit<Announcement, 'id'>;
+export declare function saveAnnouncement(body: AnnouncementSaveBody, etag: string | null): Promise<ChromeResult<Announcement>>;
+export declare function fetchChromeSettings(): Promise<ChromeResult<ChromeSettings>>;
+/**
+ * Saves the keys sent; one left out stays as it is. `secret` comes back once,
+ * when the save creates the revalidate webhook.
+ */
+export declare function saveChromeSettings(body: Partial<ChromeSettings>): Promise<ChromeResult<ChromeSettings & {
+    secret?: string;
+}>>;
+/** The pages whose `_layout` overrides a region. A core before 8.11 answers 404. */
+export declare function fetchChromeOverrides(): Promise<ChromeResult<ChromeOverridesList>>;
+/** A menu item as the form and the preview mock read it. */
+export interface ChromeMenuItem {
+    id: string;
+    label: string;
+    url: string;
+    target?: '_blank' | '_self';
+    /** Shown as a button (the kit's "Show as button"). */
+    button: boolean;
+    children: ChromeMenuItem[];
+}
+/** A menu a menu field can pick, by its slug. */
+export interface ChromeMenuOption {
+    slug: string;
+    name: string;
+    items: ChromeMenuItem[];
+}
+/**
+ * Menus from the navigation plugin's `navigations` collection. Without the
+ * plugin there are none, and menu fields offer only what's saved.
+ */
+export declare function fetchChromeMenus(): Promise<ChromeMenuOption[]>;
+/** The site title, for brand fields and the preview's logo. */
+export declare function fetchSiteTitle(): Promise<string | null>;
+//# sourceMappingURL=chrome-service.d.ts.map

package/dist/lib/chrome-service.d.ts.map

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

package/dist/lib/chrome-service.js

@@ -0,0 +1,108 @@
+import { cmsApi } from './api.js';
+function result(res) {
+    if (res.error !== undefined || res.data === undefined) {
+        return { ok: false, status: res.status, error: res.error ?? 'Request failed' };
+    }
+    return { ok: true, value: res.data, etag: res.etag ?? null };
+}
+function ifMatch(etag) {
+    return etag ? { 'If-Match': etag } : {};
+}
+export async function fetchChromeSchema() {
+    return result(await cmsApi('/chrome/schema'));
+}
+/** 404 until the site has pushed the region's schema. */
+export async function fetchRegion(region) {
+    return result(await cmsApi(`/chrome/${region}`));
+}
+export async function saveRegion(region, body, etag) {
+    return result(await cmsApi(`/chrome/${region}`, {
+        method: 'PUT',
+        headers: ifMatch(etag),
+        body: JSON.stringify(body),
+    }));
+}
+/** "Remove now" on the orphan row. */
+export async function removeOrphan(region, key) {
+    return result(await cmsApi(`/chrome/${region}/orphans/${encodeURIComponent(key)}`, {
+        method: 'DELETE',
+    }));
+}
+export async function fetchAnnouncement() {
+    return result(await cmsApi('/chrome/announcement'));
+}
+export async function saveAnnouncement(body, etag) {
+    return result(await cmsApi('/chrome/announcement', {
+        method: 'PUT',
+        headers: ifMatch(etag),
+        body: JSON.stringify(body),
+    }));
+}
+export async function fetchChromeSettings() {
+    return result(await cmsApi('/chrome/settings'));
+}
+/**
+ * Saves the keys sent; one left out stays as it is. `secret` comes back once,
+ * when the save creates the revalidate webhook.
+ */
+export async function saveChromeSettings(body) {
+    return result(await cmsApi('/chrome/settings', {
+        method: 'PUT',
+        body: JSON.stringify(body),
+    }));
+}
+/** The pages whose `_layout` overrides a region. A core before 8.11 answers 404. */
+export async function fetchChromeOverrides() {
+    return result(await cmsApi('/chrome/overrides'));
+}
+function asText(value) {
+    return typeof value === 'string' ? value : '';
+}
+function menuItems(value, depth = 0) {
+    if (!Array.isArray(value) || depth > 6)
+        return [];
+    const out = [];
+    value.forEach((raw, index) => {
+        if (!raw || typeof raw !== 'object')
+            return;
+        const item = raw;
+        const label = asText(item.label).trim();
+        if (!label)
+            return;
+        out.push({
+            id: asText(item.id) || `${depth}-${index}`,
+            label,
+            url: asText(item.url),
+            ...(item.target === '_blank' || item.target === '_self' ? { target: item.target } : {}),
+            button: item.button === true,
+            children: menuItems(item.children, depth + 1),
+        });
+    });
+    return out;
+}
+/**
+ * Menus from the navigation plugin's `navigations` collection. Without the
+ * plugin there are none, and menu fields offer only what's saved.
+ */
+export async function fetchChromeMenus() {
+    const res = await cmsApi('/collections/navigations?pageSize=100&sort=title&order=asc&pick=name,slug,items');
+    const menus = [];
+    for (const doc of res.data?.docs ?? []) {
+        const data = (doc.data && typeof doc.data === 'object' ? doc.data : {});
+        const slug = asText(data.slug) || asText(doc.slug);
+        if (!slug || menus.some((menu) => menu.slug === slug))
+            continue;
+        menus.push({
+            slug,
+            name: asText(data.name) || asText(doc.title) || slug,
+            items: menuItems(data.items),
+        });
+    }
+    return menus;
+}
+/** The site title, for brand fields and the preview's logo. */
+export async function fetchSiteTitle() {
+    const res = await cmsApi('/appearance');
+    return typeof res.data?.siteTitle === 'string' && res.data.siteTitle ? res.data.siteTitle : null;
+}
+//# sourceMappingURL=chrome-service.js.map

package/dist/lib/chrome-service.js.map

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

package/dist/lib/job-drawer.d.ts

@@ -0,0 +1,128 @@
+import type { Job, JobEvent, JobReviewItem } from '@prenta/core';
+import { type JobRow } from './job-view.js';
+import type { ApproveAllOutcome, OnApprove } from './jobs-service.js';
+export type DrawerTab = 'overview' | 'review' | 'results' | 'activity' | 'details';
+/**
+ * jobs-drawer.jsx `tabs`: Review for batch AI, Results for scans. Review is
+ * left out for someone who can't read the suggested changes (a 403), and a
+ * job type the kit doesn't know has neither.
+ */
+export declare function drawerTabs(type: string, canReview: boolean): Array<{
+    id: DrawerTab;
+    label: string;
+}>;
+export interface CapWait {
+    message: string;
+    until: number;
+}
+/**
+ * A job waiting out an AI usage cap (CONFLICTS.md §4, "Cap refusals"). It
+ * yielded with the cap's message in `progress.message` and `runAt` at the
+ * reset, and with no error, because the slice didn't fail.
+ */
+export declare function capWait(job: Job, row: JobRow, now: number): CapWait | null;
+/**
+ * jobs-drawer.jsx `OVERVIEW`: the plain-language status sentence. Edits:
+ * attempts read the job's `maxAttempts`; the slice copy keeps its own
+ * capitals ("the SEO digest"); "Finished in … across n slices" counts slices
+ * from the type's slice size; and a job waiting out a usage cap, or a cancel
+ * whose worker stopped, says so.
+ */
+export declare function overviewSentence(row: JobRow, job: Job, now: number): string;
+/**
+ * The facts grid's "Attempts". The API counts failures, so a healthy job has
+ * 0; the kit shows the attempt a job is on or finished with ("1 of 3"), and
+ * for one waiting to retry, or failed, the attempts used.
+ */
+export declare function shownAttempts(row: JobRow): number;
+/** The operation's label ("Rewrite meta descriptions"), or null when the kit doesn't know it. */
+export declare function operationLabel(operation: unknown): string | null;
+/** "now", "6s ago", "19m ago", then the list's "Yesterday 16:41". */
+export declare function formatEventTime(iso: string, now: number): string;
+export type TimelineTone = 'ok' | 'err' | 'warn' | 'run' | 'none';
+export interface TimelineEntry {
+    key: string;
+    /** ISO time; null on the two rows made up for a job with no events. */
+    at: string | null;
+    title: string;
+    detail: string;
+    tone: TimelineTone;
+}
+/** A fold has no key of its own: `foldIds` gives it one that lasts. */
+export type TimelineRow = {
+    kind: 'entry';
+    entry: TimelineEntry;
+} | {
+    kind: 'group';
+    entries: TimelineEntry[];
+};
+/**
+ * The Activity tab (jobs-drawer.jsx `act`), newest first, from the job's
+ * events. Each slice writes "Slice started" and then how it ended; the start
+ * is shown only while it runs, when it names a later attempt, and for the
+ * oldest one, so the list reads like the kit's. Past the newest two finished
+ * slices, runs of finished slices collapse into one "{n} earlier slices" row.
+ * A job with no events (from before the log existed) gets the kit's two rows.
+ */
+export declare function timeline(events: JobEvent[], job: Job, row: JobRow): TimelineRow[];
+/** What `foldIds` remembers from one refresh to the next. */
+export interface FoldMemory {
+    /** Entry key → the id of the fold it was in. */
+    entries: Map<string, string>;
+    next: number;
+}
+/**
+ * An id for each fold in `rows`, in order, that lasts while any of its
+ * slices is still in it. A fold's edges all move: newer slices join it, the
+ * newest-50 window drops its oldest, and older folds shrink away, so no
+ * position or edge entry names it for long. `memory` maps each folded entry
+ * to its fold's id and is updated. When folds merge, an id in `prefer` (the
+ * open ones) wins, so an open fold stays open, and a fold made of entries
+ * never folded before gets a new id, so it never takes an open fold's state.
+ */
+export declare function foldIds(rows: TimelineRow[], memory: FoldMemory, prefer?: ReadonlySet<string>): string[];
+/**
+ * The Details tab's raw row. Like the kit, the frozen document ids read as
+ * "[42 ids]" rather than up to 1,000 of them.
+ */
+export declare function detailsJson(job: Job): string;
+export interface LinkParts {
+    before: string;
+    anchor: string;
+    href: string;
+    after: string;
+}
+/**
+ * A link suggestion's line split around its link, so the drawer shows the
+ * words as text and never renders the markup. Null when `after` holds no link
+ * in the form the server writes.
+ */
+export declare function linkParts(after: string): LinkParts | null;
+/** The suggested text's limit, past which its count turns red (JOBS.md: meta descriptions). */
+export declare function charLimit(field: string): number | null;
+/**
+ * A fresh read of the loaded changes, in the order suggested. A change decided
+ * here after that read started keeps the copy the decision returned, so a slow
+ * refresh can't put it back to pending.
+ */
+export declare function mergeReviewItems(fresh: JobReviewItem[], loaded: JobReviewItem[], keep: ReadonlySet<string>): JobReviewItem[];
+/** A page appended to the loaded changes, without repeating any. */
+export declare function appendReviewItems(loaded: JobReviewItem[], page: JobReviewItem[]): JobReviewItem[];
+/**
+ * "Approve all" toast (jobs-drawer.jsx `approveAll`), plus what stayed in
+ * review: approve-all skips changes to published documents when they'd be
+ * saved as drafts, changes the reviewer can't write, and saves that fail.
+ */
+export declare function approveAllMessage(outcome: Pick<ApproveAllOutcome, 'approved' | 'remaining'>, onApprove: OnApprove): {
+    title: string;
+    description?: string;
+};
+/**
+ * "Approve all" stopped because an edit couldn't be approved: nothing else
+ * was approved, so the AI's text can't replace that edit.
+ */
+export declare function approveAllStoppedMessage(approvedEdits: number, refusedEdits: number): {
+    title: string;
+    description: string;
+};
+//# sourceMappingURL=job-drawer.d.ts.map

package/dist/lib/job-drawer.d.ts.map

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