@prenta/core 0.118.0

package/dist/sections/types.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Shared types for the flat, section-based Page Editor model.
+ *
+ * A page is an ordered list of `PageSection`s stored in a page document's
+ * `data.sections` JSON field. A section's `sectionType` keys into the
+ * {@link SECTION_TYPES} registry, which is the single source of truth for:
+ *   - the Add Section gallery (label / icon / description / category)
+ *   - default content + settings when a section is created
+ *   - the inspector field schema (which content controls to render)
+ *   - the renderer component (dispatches on the same `sectionType` key)
+ *   - server + MCP validation of AI-authored section content
+ *
+ * This module lives in `cms-core` (not `cms-admin`) so the admin editor,
+ * the REST API, and the MCP server all validate against ONE definition.
+ *
+ * NOTE: this is deliberately distinct from the page-builder *tree* model
+ * (`SectionNode` etc. in `../page-builder`). That model is a recursive
+ * node tree; this one is a flat list of named, schema-driven sections.
+ */
+/**
+ * Stable ids for the built-in section types.
+ *
+ * The first group is shared (usable on both pages and posts); the second
+ * group is post-oriented (article body, pull quote, author bio, related
+ * posts, image gallery). Which types appear in a given editor is governed
+ * by {@link SectionTypeDef.scope}.
+ */
+export type SectionTypeId = 'hero' | 'text' | 'feature' | 'stats' | 'cta' | 'form' | 'article-body' | 'quote' | 'author-bio' | 'related-posts' | 'gallery' | 'embed' | 'widget-embed';
+/** Where a section type may be used. Drives the Add Section gallery filter. */
+export type SectionScope = 'page' | 'post';
+/** Field kinds the inspector + validator understand. */
+export type SectionFieldType = 'text' | 'textarea' | 'richText' | 'url' | 'media' | 'select' | 'boolean' | 'color' | 'relationship' | 'repeater' | 'stats' | 'gallery';
+export interface SectionFieldDef {
+    /** key into `PageSection.content` */
+    key: string;
+    label: string;
+    type: SectionFieldType;
+    placeholder?: string;
+    /** options for `type: 'select'` */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** collection slug a `relationship` field points at (defaults to the host post type) */
+    relationTo?: string;
+    /** marks the field required for publish-time validation */
+    required?: boolean;
+    help?: string;
+    /**
+     * Sub-field schema for `type: 'repeater'`. Each row of the stored array is an
+     * object keyed by these sub-fields. Sub-fields use the same {@link SectionFieldDef}
+     * shape (so a row can contain text, media, select, boolean, etc.).
+     */
+    fields?: SectionFieldDef[];
+    /** Singular noun for a repeater row in the editor (e.g. "Plan", "Tier"). Defaults to "Item". */
+    rowLabel?: string;
+    /** Minimum rows a repeater should have (advisory, surfaced as a warning). */
+    minRows?: number;
+    /** Maximum rows a repeater allows (the editor disables "Add" at the cap). */
+    maxRows?: number;
+}
+export interface SectionSettings {
+    backgroundType?: 'none' | 'solid' | 'gradient';
+    backgroundColor?: string;
+    paddingY?: 'sm' | 'md' | 'lg' | 'xl';
+    anchorId?: string;
+    cssClass?: string;
+}
+export interface SectionTypeDef {
+    id: SectionTypeId;
+    /** Display name used in the Sections panel + Add gallery */
+    name: string;
+    /** lucide-react icon name (resolved by the admin panel/gallery) */
+    icon: string;
+    description: string;
+    category: 'layout' | 'content' | 'media' | 'conversion';
+    /** accent color key (maps to the shared badge palette) */
+    accent: 'purple' | 'green' | 'orange' | 'blue' | 'pink';
+    /** which editors expose this type. Defaults (when omitted) to page-only. */
+    scope: SectionScope[];
+    defaultContent: Record<string, unknown>;
+    defaultSettings: SectionSettings;
+    /** content fields shown in the inspector, in order */
+    fields: SectionFieldDef[];
+}
+/**
+ * A single section on a page. Persisted in `data.sections[]`.
+ *
+ * `sectionType` is a free string (not the built-in {@link SectionTypeId}
+ * union) because a page may carry config-declared custom types
+ * (see {@link CustomSectionTypeInput}) or sections authored entirely outside
+ * the editor (seed/code-owned). The latter are flagged {@link unmanaged} so
+ * the editor preserves them on save and shows them read-only.
+ */
+export interface PageSection {
+    id: string;
+    sectionType: string;
+    /** Editor-facing display name (defaults to the type name). */
+    name: string;
+    /** Optional internal-only label for the team. */
+    internalLabel?: string;
+    visible: boolean;
+    content: Record<string, unknown>;
+    settings: SectionSettings;
+    /**
+     * True when this section's `sectionType` has no registered definition
+     * (neither a built-in nor a config-declared custom type). Such sections are
+     * preserved verbatim through read/save and rendered read-only in the editor
+     * so externally-managed content is never silently dropped.
+     */
+    unmanaged?: boolean;
+}
+/**
+ * Serializable shape a consumer declares in `prenta.config.ts` under
+ * `sections.types` to teach the CMS about a custom section type.
+ *
+ * It is the JSON-safe subset of {@link SectionTypeDef} (no React renderer —
+ * the public site registers that separately via `registerSectionRenderer`
+ * from `@prenta/sections-react`). `registerSectionTypes` fills in any
+ * omitted presentation fields with sensible defaults so the Add Section
+ * gallery and the field-driven inspector work without extra config.
+ */
+export interface CustomSectionTypeInput {
+    id: string;
+    name: string;
+    scope: SectionScope[];
+    fields: SectionFieldDef[];
+    icon?: string;
+    description?: string;
+    category?: SectionTypeDef['category'];
+    accent?: SectionTypeDef['accent'];
+    defaultContent?: Record<string, unknown>;
+    defaultSettings?: SectionSettings;
+}
+/** Site-wide section configuration declared on `PrentaCMSConfig.sections`. */
+export interface SectionsConfig {
+    /**
+     * Custom section types recognized + made editable in the admin editor.
+     * Canonical key — declared in `prenta.config.ts` under `sections.types`.
+     * The public site registers the matching renderer separately via
+     * `registerSectionRenderer` from `@prenta/sections-react`.
+     */
+    types?: CustomSectionTypeInput[];
+    /**
+     * @deprecated Back-compat alias for {@link types}. Prefer `sections.types`.
+     * When `types` is present it wins and this is ignored; otherwise this is
+     * used so configs written before the rename keep working.
+     */
+    customTypes?: CustomSectionTypeInput[];
+}
+/** A structured validation finding for a single section. */
+export interface SectionValidationIssue {
+    /** the section type the issue belongs to */
+    sectionType: string;
+    /** content field key when the issue is field-scoped */
+    field?: string;
+    message: string;
+}
+export interface SectionValidationResult {
+    valid: boolean;
+    errors: SectionValidationIssue[];
+    warnings: SectionValidationIssue[];
+}
+/**
+ * Design-driven header layout for a post type. These are presentation
+ * toggles only — the actual values (title, image, author, date) come from
+ * each post document's own fields, never from the template.
+ */
+export interface PostHeaderConfig {
+    /** Overall header composition. */
+    layout: 'centered' | 'left' | 'overlay';
+    showFeaturedImage: boolean;
+    showExcerpt: boolean;
+    showAuthor: boolean;
+    showDate: boolean;
+    showCategory: boolean;
+    showReadingTime: boolean;
+}
+/**
+ * A post type's editable template: the header layout plus the ordered list
+ * of sections new posts of that type inherit. Stored as a single document
+ * per post type in the hidden `post-templates` collection
+ * (`data: { postType, header, sections }`).
+ */
+export interface PostTemplate {
+    /** slug of the post-type collection this template belongs to */
+    postType: string;
+    header: PostHeaderConfig;
+    /** default body/trailing sections new posts inherit */
+    sections: PageSection[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sections/types.d.ts.map

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

package/dist/sections/types.js

@@ -0,0 +1,21 @@
+/**
+ * Shared types for the flat, section-based Page Editor model.
+ *
+ * A page is an ordered list of `PageSection`s stored in a page document's
+ * `data.sections` JSON field. A section's `sectionType` keys into the
+ * {@link SECTION_TYPES} registry, which is the single source of truth for:
+ *   - the Add Section gallery (label / icon / description / category)
+ *   - default content + settings when a section is created
+ *   - the inspector field schema (which content controls to render)
+ *   - the renderer component (dispatches on the same `sectionType` key)
+ *   - server + MCP validation of AI-authored section content
+ *
+ * This module lives in `cms-core` (not `cms-admin`) so the admin editor,
+ * the REST API, and the MCP server all validate against ONE definition.
+ *
+ * NOTE: this is deliberately distinct from the page-builder *tree* model
+ * (`SectionNode` etc. in `../page-builder`). That model is a recursive
+ * node tree; this one is a flat list of named, schema-driven sections.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sections/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sections/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/sections/validate.d.ts

@@ -0,0 +1,12 @@
+import type { SectionSettings, SectionValidationResult } from './types.js';
+/** Heuristic: URLs that look like static /public assets rather than library uploads. */
+export declare function isLikelyOutsideMediaLibrary(url: string): boolean;
+/**
+ * Validate one section's content + settings against its type schema.
+ *
+ * An unknown `sectionType` is a hard error (the agent asked for a type with
+ * no renderer). Required fields, button URL validity, and image alt text
+ * are enforced; everything else is advisory.
+ */
+export declare function validateSectionContent(sectionType: string, content: Record<string, unknown>, _settings?: SectionSettings): SectionValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/sections/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/sections/validate.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAQ1E,wFAAwF;AACxF,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAShE;AASD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,eAAe,GAC1B,uBAAuB,CAkGzB"}

package/dist/sections/validate.js

@@ -0,0 +1,186 @@
+/**
+ * Section content validation — shared by the admin editor's `validatePage`,
+ * the REST `/page-sections/validate` endpoint, and the MCP
+ * `validate_section_content` tool.
+ *
+ * Deterministic (no LLM, no I/O). Validates a SINGLE section's content
+ * against its registry field schema. Page-level rules (title/path, "at
+ * least one visible section", SEO warnings) live in the admin's
+ * `validatePage` because they operate on the whole `EditorPage`.
+ *
+ * Messages are intentionally label-prefix-free (e.g. `"Heading" is
+ * required.`) so callers can prepend their own context (`${sectionName}:
+ * ...`) without double-labelling.
+ */
+import { getSectionType } from './registry.js';
+import { resolveRepeaterField } from './fields.js';
+import { parseEmbed } from './embed.js';
+import { parseWidgetEmbed } from './widget-embed.js';
+const URL_OK = /^(https?:\/\/|\/|#|mailto:|tel:)/i;
+function isBlank(v) {
+    return v === undefined || v === null || (typeof v === 'string' && v.trim() === '');
+}
+/** Heuristic: URLs that look like static /public assets rather than library uploads. */
+export function isLikelyOutsideMediaLibrary(url) {
+    const u = url.trim();
+    if (!u)
+        return false;
+    if (u.startsWith('./') || u.startsWith('../'))
+        return true;
+    if (u.includes('/public/') || u.includes('/_next/static/'))
+        return true;
+    if (/^\/(?:images?|img|assets|static|media|uploads)\//i.test(u))
+        return true;
+    // Root-relative paths (e.g. `/hero.jpg`) skip CMS blob/CDN delivery.
+    if (u.startsWith('/') && !u.startsWith('/api/'))
+        return true;
+    return false;
+}
+/** Label/URL field pairs: the URL must be valid when its label is filled in. */
+const BUTTON_PAIRS = [
+    ['primaryButtonLabel', 'primaryButtonUrl'],
+    ['secondaryButtonLabel', 'secondaryButtonUrl'],
+    ['buttonLabel', 'buttonUrl'],
+];
+/**
+ * Validate one section's content + settings against its type schema.
+ *
+ * An unknown `sectionType` is a hard error (the agent asked for a type with
+ * no renderer). Required fields, button URL validity, and image alt text
+ * are enforced; everything else is advisory.
+ */
+export function validateSectionContent(sectionType, content, _settings) {
+    const errors = [];
+    const warnings = [];
+    const def = getSectionType(sectionType);
+    if (!def) {
+        errors.push({
+            sectionType,
+            message: `Unknown section type "${sectionType}". It has no registered renderer.`,
+        });
+        return { valid: false, errors, warnings };
+    }
+    const data = content ?? {};
+    for (const field of def.fields) {
+        const repeater = resolveRepeaterField(field);
+        if (repeater) {
+            validateRepeater(sectionType, field.key, repeater, data[field.key], errors, warnings);
+            continue;
+        }
+        if (field.required && isBlank(data[field.key])) {
+            errors.push({ sectionType, field: field.key, message: `"${field.label}" is required.` });
+        }
+    }
+    for (const [labelKey, urlKey] of BUTTON_PAIRS) {
+        const hasLabel = !isBlank(data[labelKey]);
+        const url = data[urlKey];
+        if (hasLabel && !isBlank(url) && typeof url === 'string' && !URL_OK.test(url.trim())) {
+            errors.push({ sectionType, field: urlKey, message: `"${url}" is not a valid URL.` });
+        }
+        // A configured URL with no label is a soft issue — the button won't render.
+        if (!hasLabel && !isBlank(data[urlKey])) {
+            warnings.push({
+                sectionType,
+                field: labelKey,
+                message: `A URL is set for "${urlKey}" but its button label is empty, so the button will not render.`,
+            });
+        }
+    }
+    // Image alt text required when an image is set (accessibility).
+    if (!isBlank(data.imageUrl) && isBlank(data.imageAlt)) {
+        errors.push({
+            sectionType,
+            field: 'imageAlt',
+            message: 'image needs alt text for accessibility.',
+        });
+    }
+    if (!isBlank(data.imageUrl) && isLikelyOutsideMediaLibrary(String(data.imageUrl))) {
+        warnings.push({
+            sectionType,
+            field: 'imageUrl',
+            message: 'Image URL does not appear to be from the media library. Upload the asset via Media or upload_media, then reference its URL so alt text, optimization, and usage tracking apply.',
+        });
+    }
+    // Embed/video: the URL must resolve to an allowed provider so an arbitrary
+    // URL can never be rendered inside an <iframe>.
+    if (sectionType === 'embed' && !isBlank(data.url) && !parseEmbed(data.url)) {
+        errors.push({
+            sectionType,
+            field: 'url',
+            message: 'must be a YouTube, Vimeo, or Loom video URL.',
+        });
+    }
+    if (sectionType === 'widget-embed' && !parseWidgetEmbed(data)) {
+        errors.push({
+            sectionType,
+            field: 'widgetId',
+            message: 'must include a valid provider configuration (Elfsight widget id, Trustpilot template + business unit ids, or a Calendly https URL).',
+        });
+    }
+    if (sectionType === 'widget-embed') {
+        const hasRating = data.schemaRatingValue !== undefined &&
+            data.schemaRatingValue !== null &&
+            String(data.schemaRatingValue).trim() !== '';
+        const hasCount = data.schemaReviewCount !== undefined &&
+            data.schemaReviewCount !== null &&
+            String(data.schemaReviewCount).trim() !== '';
+        if (hasRating !== hasCount) {
+            warnings.push({
+                sectionType,
+                field: hasRating ? 'schemaReviewCount' : 'schemaRatingValue',
+                message: 'Schema rating and review count must both be set for JSON-LD aggregate ratings.',
+            });
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validate one repeater field's rows against its sub-field schema. Covers the
+ * generic `repeater` type and the `stats` / `gallery` shorthands (resolved to
+ * the same row model). Required sub-fields are hard errors; an image row
+ * missing alt text is an advisory warning (accessibility). `minRows` is
+ * advisory; exceeding `maxRows` is an error (the editor enforces the cap, so
+ * over-cap data only arrives via the API/agent).
+ */
+function validateRepeater(sectionType, key, repeater, value, errors, warnings) {
+    const rows = Array.isArray(value) ? value : [];
+    const mediaField = repeater.fields.find((f) => f.type === 'media');
+    const altField = repeater.fields.find((f) => f.key === 'alt');
+    rows.forEach((raw, i) => {
+        if (!raw || typeof raw !== 'object')
+            return;
+        const row = raw;
+        for (const sub of repeater.fields) {
+            if (sub.required && isBlank(row[sub.key])) {
+                errors.push({
+                    sectionType,
+                    field: `${key}[${i}].${sub.key}`,
+                    message: `"${sub.label}" is required in ${repeater.rowLabel} ${i + 1}.`,
+                });
+            }
+        }
+        // An image row with a set image but no alt text is an accessibility gap.
+        if (mediaField && altField && !isBlank(row[mediaField.key]) && isBlank(row[altField.key])) {
+            warnings.push({
+                sectionType,
+                field: `${key}[${i}].${altField.key}`,
+                message: `${repeater.rowLabel} ${i + 1} is missing alt text for accessibility.`,
+            });
+        }
+    });
+    if (typeof repeater.minRows === 'number' && rows.length < repeater.minRows) {
+        warnings.push({
+            sectionType,
+            field: key,
+            message: `Add at least ${repeater.minRows} ${repeater.rowLabel.toLowerCase()}(s).`,
+        });
+    }
+    if (typeof repeater.maxRows === 'number' && rows.length > repeater.maxRows) {
+        errors.push({
+            sectionType,
+            field: key,
+            message: `No more than ${repeater.maxRows} ${repeater.rowLabel.toLowerCase()}(s) are allowed.`,
+        });
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/sections/validate.js.map

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

package/dist/sections/widget-embed.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Third-party widget allowlist + parsing for the `widget-embed` section.
+ *
+ * Supports lazy-loaded review/chat/scheduling widgets (Elfsight, Trustpilot,
+ * Calendly) with validated ids/URLs so arbitrary script URLs cannot reach the
+ * public renderer.
+ */
+export type WidgetProvider = 'elfsight' | 'trustpilot' | 'calendly';
+/** Providers whose widgets typically display on-page star ratings. */
+export declare const REVIEWS_WIDGET_PROVIDERS: Set<WidgetProvider>;
+export interface SchemaAggregateRating {
+    '@type': 'AggregateRating';
+    ratingValue: number;
+    reviewCount: number;
+    bestRating: number;
+}
+export interface ParsedWidgetEmbed {
+    provider: WidgetProvider;
+    /** Provider-specific primary id (Elfsight app id, Trustpilot template id). */
+    widgetId: string;
+    /** Secondary value — Trustpilot business unit id or Calendly scheduling URL. */
+    embedUrl: string | null;
+    minHeightPx: number;
+}
+export declare const WIDGET_PROVIDER_LABEL: Record<WidgetProvider, string>;
+export declare const WIDGET_MIN_HEIGHT_OPTIONS: readonly ["120", "200", "280", "360", "480"];
+/** Safe widget token — alphanumeric, dash, underscore only. */
+export declare function safeWidgetToken(raw: unknown): string | null;
+export declare function parseMinHeightPx(raw: unknown): number;
+/**
+ * Resolve widget section content to a parsed embed, or `null` when invalid.
+ */
+export declare function parseWidgetEmbed(content: Record<string, unknown>): ParsedWidgetEmbed | null;
+/**
+ * Parse optional JSON-LD rating fields from widget section content.
+ * Returns null unless the widget is a valid reviews embed AND both rating
+ * fields are present — never fabricate aggregate ratings.
+ */
+export declare function parseWidgetAggregateRating(content: Record<string, unknown>): SchemaAggregateRating | null;
+/**
+ * Scan page `data.sections` for the first reviews widget with complete schema
+ * rating fields. Used by the JSON-LD composer for conditional AggregateRating.
+ */
+export declare function extractAggregateRatingFromSections(data: Record<string, unknown>): SchemaAggregateRating | null;
+//# sourceMappingURL=widget-embed.d.ts.map

package/dist/sections/widget-embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-embed.d.ts","sourceRoot":"","sources":["../../src/sections/widget-embed.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAA;AAEnE,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,qBAAsD,CAAA;AAE3F,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIhE,CAAA;AAED,eAAO,MAAM,yBAAyB,8CAA+C,CAAA;AAIrF,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK3D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMrD;AAYD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAwB3F;AAcD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,qBAAqB,GAAG,IAAI,CAc9B;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,qBAAqB,GAAG,IAAI,CAe9B"}

package/dist/sections/widget-embed.js

@@ -0,0 +1,129 @@
+/**
+ * Third-party widget allowlist + parsing for the `widget-embed` section.
+ *
+ * Supports lazy-loaded review/chat/scheduling widgets (Elfsight, Trustpilot,
+ * Calendly) with validated ids/URLs so arbitrary script URLs cannot reach the
+ * public renderer.
+ */
+/** Providers whose widgets typically display on-page star ratings. */
+export const REVIEWS_WIDGET_PROVIDERS = new Set(['elfsight', 'trustpilot']);
+export const WIDGET_PROVIDER_LABEL = {
+    elfsight: 'Elfsight',
+    trustpilot: 'Trustpilot',
+    calendly: 'Calendly',
+};
+export const WIDGET_MIN_HEIGHT_OPTIONS = ['120', '200', '280', '360', '480'];
+const DEFAULT_MIN_HEIGHT_PX = 280;
+/** Safe widget token — alphanumeric, dash, underscore only. */
+export function safeWidgetToken(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    const token = raw.trim();
+    if (!token || !/^[\w-]+$/.test(token))
+        return null;
+    return token;
+}
+export function parseMinHeightPx(raw) {
+    const n = typeof raw === 'string' ? Number.parseInt(raw, 10) : Number(raw);
+    if (!Number.isFinite(n))
+        return DEFAULT_MIN_HEIGHT_PX;
+    if (n < 80)
+        return 80;
+    if (n > 800)
+        return 800;
+    return n;
+}
+function isCalendlyUrl(raw) {
+    if (typeof raw !== 'string' || raw.trim() === '')
+        return false;
+    try {
+        const u = new URL(raw.trim());
+        return u.protocol === 'https:' && u.hostname.replace(/^www\./, '') === 'calendly.com';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve widget section content to a parsed embed, or `null` when invalid.
+ */
+export function parseWidgetEmbed(content) {
+    const provider = content.provider;
+    const minHeightPx = parseMinHeightPx(content.minHeight);
+    if (provider === 'elfsight') {
+        const widgetId = safeWidgetToken(content.widgetId);
+        if (!widgetId)
+            return null;
+        return { provider, widgetId, embedUrl: null, minHeightPx };
+    }
+    if (provider === 'trustpilot') {
+        const widgetId = safeWidgetToken(content.widgetId);
+        const embedUrl = safeWidgetToken(content.embedUrl);
+        if (!widgetId || !embedUrl)
+            return null;
+        return { provider, widgetId, embedUrl, minHeightPx };
+    }
+    if (provider === 'calendly') {
+        const embedUrl = isCalendlyUrl(content.embedUrl) ? content.embedUrl.trim() : null;
+        if (!embedUrl)
+            return null;
+        return { provider, widgetId: '', embedUrl, minHeightPx };
+    }
+    return null;
+}
+function parseSchemaRatingValue(raw) {
+    const n = typeof raw === 'string' ? Number.parseFloat(raw) : Number(raw);
+    if (!Number.isFinite(n) || n < 1 || n > 5)
+        return null;
+    return Math.round(n * 10) / 10;
+}
+function parseSchemaReviewCount(raw) {
+    const n = typeof raw === 'string' ? Number.parseInt(raw, 10) : Number(raw);
+    if (!Number.isFinite(n) || n < 1 || !Number.isInteger(n))
+        return null;
+    return n;
+}
+/**
+ * Parse optional JSON-LD rating fields from widget section content.
+ * Returns null unless the widget is a valid reviews embed AND both rating
+ * fields are present — never fabricate aggregate ratings.
+ */
+export function parseWidgetAggregateRating(content) {
+    const parsed = parseWidgetEmbed(content);
+    if (!parsed || !REVIEWS_WIDGET_PROVIDERS.has(parsed.provider))
+        return null;
+    const ratingValue = parseSchemaRatingValue(content.schemaRatingValue);
+    const reviewCount = parseSchemaReviewCount(content.schemaReviewCount);
+    if (ratingValue === null || reviewCount === null)
+        return null;
+    return {
+        '@type': 'AggregateRating',
+        ratingValue,
+        reviewCount,
+        bestRating: 5,
+    };
+}
+/**
+ * Scan page `data.sections` for the first reviews widget with complete schema
+ * rating fields. Used by the JSON-LD composer for conditional AggregateRating.
+ */
+export function extractAggregateRatingFromSections(data) {
+    const sections = data.sections;
+    if (!Array.isArray(sections))
+        return null;
+    for (const entry of sections) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const section = entry;
+        if (section.sectionType !== 'widget-embed')
+            continue;
+        const content = section.content;
+        if (!content || typeof content !== 'object')
+            continue;
+        const rating = parseWidgetAggregateRating(content);
+        if (rating)
+            return rating;
+    }
+    return null;
+}
+//# sourceMappingURL=widget-embed.js.map

package/dist/sections/widget-embed.js.map

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