@prenta/core 0.118.0

package/dist/media/seo.js

@@ -0,0 +1,263 @@
+/**
+ * Media SEO scoring.
+ *
+ * Pure, dependency-free functions that derive an SEO score and a list of
+ * actionable issues from a media asset's metadata. The score is intentionally
+ * *derived* (never persisted) so it can never drift out of sync with the
+ * underlying metadata — every read recomputes it from the current fields.
+ *
+ * The weights below are the contract the admin SEO drawer, the SEO Audit
+ * table, and the `validateMediaSEO` MCP tool all share. Changing a weight is a
+ * behavioural change to every surface that shows a media score, so keep the
+ * unit tests in `__tests__/seo.test.ts` as the source of truth.
+ */
+const DEFAULT_MAX_IMAGE_BYTES = 2 * 1024 * 1024;
+/** SEO weights. Must sum to 100. */
+export const MEDIA_SEO_WEIGHTS = {
+    altText: 30,
+    title: 20,
+    description: 20,
+    caption: 10,
+    descriptiveFileName: 10,
+    focusKeyword: 10,
+};
+/**
+ * Filenames that carry no semantic value. These come straight off cameras,
+ * screenshot tools, and "save as" defaults, so they neither help users nor
+ * search engines. Matched case-insensitively against the name without its
+ * extension.
+ */
+const GENERIC_FILENAME_PATTERNS = [
+    /^img[-_ ]?\d+$/i, // IMG_4892
+    /^dsc[-_ ]?\d+$/i, // DSC_0001
+    /^dscf\d+$/i, // DSCF1234 (Fujifilm)
+    /^p\d{6,}$/i, // P1010101
+    /^image[-_ ]?\d*$/i, // image, image1
+    /^photo[-_ ]?\d*$/i, // photo, photo-2
+    /^pic[-_ ]?\d*$/i,
+    /^untitled[-_ ]?\d*$/i,
+    /^screen[-_ ]?shot.*$/i, // Screen Shot 2024-...
+    /^screenshot.*$/i,
+    /^download[-_ ]?\d*$/i,
+    /^file[-_ ]?\d*$/i,
+    /^new[-_ ]?\d+$/i,
+    /^\d+$/i, // 12345
+    /^[a-f0-9]{8,}$/i, // hex blobs / hashes
+];
+/** True when `value` is a non-empty string after trimming. */
+function present(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/** Strip a single trailing extension from a filename. */
+function stripExtension(name) {
+    const dot = name.lastIndexOf('.');
+    return dot > 0 ? name.slice(0, dot) : name;
+}
+/** Normalize separators so "B2B SEO" matches "B2B-SEO.webp". */
+function normalizeLabel(value) {
+    return value.toLowerCase().replace(/[-_]+/g, ' ').replace(/\s+/g, ' ').trim();
+}
+/** Map a MIME type to a coarse {@link MediaKind}. */
+export function mediaKind(mimeType) {
+    const mime = (mimeType ?? '').toLowerCase();
+    if (mime === 'image/svg+xml')
+        return 'svg';
+    if (mime.startsWith('image/'))
+        return 'image';
+    if (mime.startsWith('video/'))
+        return 'video';
+    if (mime.startsWith('audio/'))
+        return 'audio';
+    if (mime === 'application/pdf')
+        return 'pdf';
+    return 'other';
+}
+/**
+ * Whether a filename is generic/non-descriptive (e.g. `IMG_4892.jpg`). A
+ * descriptive name needs at least one alphabetic run of 3+ chars and must not
+ * match a known camera/screenshot/default pattern.
+ */
+export function isGenericFilename(fileName) {
+    if (!present(fileName))
+        return true;
+    const base = stripExtension(String(fileName).trim());
+    if (base.length === 0)
+        return true;
+    if (GENERIC_FILENAME_PATTERNS.some((re) => re.test(base)))
+        return true;
+    // Require some real word content: at least three consecutive letters.
+    if (!/[a-z]{3,}/i.test(base))
+        return true;
+    return false;
+}
+/**
+ * True when alt looks like a migrated topic label rather than an image
+ * description: equals the filename stem, or exactly matches a document title
+ * that uses the asset. Does not change the score (#715).
+ */
+export function isLowQualityAlt(altText, fileName, usedOnTitles) {
+    if (!present(altText))
+        return false;
+    const altNorm = normalizeLabel(String(altText));
+    if (!altNorm)
+        return false;
+    if (present(fileName)) {
+        const stemNorm = normalizeLabel(stripExtension(String(fileName).trim()));
+        if (stemNorm && stemNorm === altNorm)
+            return true;
+    }
+    if (Array.isArray(usedOnTitles)) {
+        for (const title of usedOnTitles) {
+            if (!present(title))
+                continue;
+            if (normalizeLabel(String(title)) === altNorm)
+                return true;
+        }
+    }
+    return false;
+}
+/** Map a numeric score to a grade bucket. */
+export function gradeForScore(score) {
+    if (score >= 80)
+        return 'good';
+    if (score >= 60)
+        return 'needs-work';
+    if (score >= 1)
+        return 'poor';
+    return 'critical';
+}
+/**
+ * Compute the SEO score (0–100) and issue list for a media asset.
+ *
+ * Scoring (weights in {@link MEDIA_SEO_WEIGHTS}, sum 100):
+ *   alt text +30, title +20, description +20, caption +10,
+ *   descriptive filename +10, focus keyword +10.
+ *
+ * Decorative assets (`isDecorative`) earn the alt weight with empty alt and
+ * skip description pressure — there is no meaningful description for a
+ * background flourish (#714).
+ *
+ * Issues are additive context and do not subtract from the score directly —
+ * e.g. an oversized image still scores on metadata, but surfaces an
+ * `oversized-image` issue operators can act on. `low-quality-alt` is advisory
+ * only and never changes the numeric score (#715).
+ */
+export function calculateMediaSeoScore(input, options = {}) {
+    const kind = mediaKind(input.mimeType);
+    const maxImageBytes = options.maxImageBytes ?? DEFAULT_MAX_IMAGE_BYTES;
+    const isDecorative = input.isDecorative === true;
+    const hasAlt = present(input.altText) || isDecorative;
+    const hasTitle = present(input.title);
+    const hasDescription = present(input.description) || isDecorative;
+    const hasCaption = present(input.caption);
+    const hasFocusKeyword = present(input.focusKeyword);
+    const genericName = isGenericFilename(input.fileName);
+    let score = 0;
+    if (hasAlt)
+        score += MEDIA_SEO_WEIGHTS.altText;
+    if (hasTitle)
+        score += MEDIA_SEO_WEIGHTS.title;
+    if (hasDescription)
+        score += MEDIA_SEO_WEIGHTS.description;
+    if (hasCaption)
+        score += MEDIA_SEO_WEIGHTS.caption;
+    if (!genericName)
+        score += MEDIA_SEO_WEIGHTS.descriptiveFileName;
+    if (hasFocusKeyword)
+        score += MEDIA_SEO_WEIGHTS.focusKeyword;
+    score = Math.max(0, Math.min(100, Math.round(score)));
+    const issues = [];
+    // Alt text matters most for images/SVGs (screen readers + image search).
+    if (!hasAlt && (kind === 'image' || kind === 'svg')) {
+        issues.push({
+            type: 'missing-alt',
+            severity: 'high',
+            message: 'Add alt text describing this image for accessibility and image search.',
+            field: 'altText',
+            fixableWithAI: true,
+        });
+    }
+    if (!isDecorative &&
+        present(input.altText) &&
+        (kind === 'image' || kind === 'svg') &&
+        isLowQualityAlt(input.altText, input.fileName, input.usedOnTitles)) {
+        issues.push({
+            type: 'low-quality-alt',
+            severity: 'low',
+            message: 'Alt text looks like a topic label or filename rather than a description of the image. Review for screen-reader fitness (logos/wordmarks are often fine as short names).',
+            field: 'altText',
+            fixableWithAI: true,
+        });
+    }
+    if (!hasTitle) {
+        issues.push({
+            type: 'missing-title',
+            severity: 'medium',
+            message: 'Add a title to give this asset a clear, human-readable label.',
+            field: 'title',
+            fixableWithAI: true,
+        });
+    }
+    if (!hasDescription) {
+        issues.push({
+            type: 'missing-description',
+            severity: 'medium',
+            message: 'Add a description to provide richer context for search and reuse.',
+            field: 'description',
+            fixableWithAI: true,
+        });
+    }
+    if (genericName) {
+        issues.push({
+            type: 'generic-filename',
+            severity: 'low',
+            message: 'Rename to a descriptive filename — generic names like IMG_4892 hurt SEO.',
+            field: 'fileName',
+            fixableWithAI: true,
+        });
+    }
+    if (kind === 'image' && typeof input.sizeBytes === 'number' && input.sizeBytes > maxImageBytes) {
+        issues.push({
+            type: 'oversized-image',
+            severity: 'medium',
+            message: 'Image is large — optimise it to improve page load performance.',
+            field: 'sizeBytes',
+            fixableWithAI: false,
+        });
+    }
+    // Video accessibility: captions/transcript. We track this as caption today.
+    if (kind === 'video' && !hasCaption) {
+        issues.push({
+            type: 'missing-video-caption',
+            severity: 'medium',
+            message: 'Add a caption or transcript reference for this video.',
+            field: 'caption',
+            fixableWithAI: false,
+        });
+    }
+    if (kind === 'pdf' && !hasTitle) {
+        // Already emitted missing-title above; no duplicate. Kept for clarity that
+        // PDFs are intentionally covered by the generic title check.
+    }
+    // Surface the overall verdict as an issue when the score is weak, so the
+    // audit table can show a single "poor score" row chip.
+    const grade = gradeForScore(score);
+    if (grade === 'critical') {
+        issues.push({
+            type: 'critical-score',
+            severity: 'critical',
+            message: 'No SEO metadata set. This asset is invisible to search and assistive tech.',
+            fixableWithAI: true,
+        });
+    }
+    else if (grade === 'poor') {
+        issues.push({
+            type: 'poor-score',
+            severity: 'high',
+            message: 'Low SEO score — fill in the missing metadata fields below.',
+            fixableWithAI: true,
+        });
+    }
+    return { score, grade, issues };
+}
+//# sourceMappingURL=seo.js.map

package/dist/media/seo.js.map

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

package/dist/media/usage-sync.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Keep `prenta_media_usages` in sync with document JSON.
+ *
+ * On every document write we scan stored `data` for media field IDs and image
+ * URLs embedded in rich-text HTML, then replace the join rows for that
+ * document. Without this the media library's "Used on" drawer drifts stale.
+ */
+import type { PrentaDB } from '../db/client-types.js';
+/** Remove every MediaUsage row for a document (e.g. on delete). Tolerates a missing delegate. */
+export declare function clearMediaUsageForDocument(db: PrentaDB, documentId: string): Promise<void>;
+export interface MediaReference {
+    fieldPath: string;
+    mediaId?: string;
+    url?: string;
+}
+export interface ResolvedMediaUsage {
+    mediaId: string;
+    fieldPath: string;
+}
+/** Extract candidate media IDs and URLs from document JSON with field paths. */
+export declare function extractMediaReferences(data: Record<string, unknown>, pathPrefix?: string): MediaReference[];
+/** Resolve extracted refs to existing media IDs (drops unknown IDs/URLs). */
+export declare function resolveMediaReferences(db: PrentaDB, refs: MediaReference[]): Promise<ResolvedMediaUsage[]>;
+/** Replace all MediaUsage rows for a document with the refs found in `data`. */
+export declare function syncMediaUsageForDocument(db: PrentaDB, documentId: string, data: Record<string, unknown> | null | undefined): Promise<void>;
+export interface BackfillMediaUsageOptions {
+    dryRun?: boolean;
+    batchSize?: number;
+}
+export interface BackfillMediaUsageResult {
+    scanned: number;
+    synced: number;
+    skipped: number;
+}
+/** Re-scan all non-deleted documents and rebuild MediaUsage join rows. */
+export declare function backfillMediaUsage(db: PrentaDB, options?: BackfillMediaUsageOptions): Promise<BackfillMediaUsageResult>;
+//# sourceMappingURL=usage-sync.d.ts.map

package/dist/media/usage-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-sync.d.ts","sourceRoot":"","sources":["../../src/media/usage-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAyBrD,iGAAiG;AACjG,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAmCD,gFAAgF;AAChF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,SAAK,GACd,cAAc,EAAE,CASlB;AAqFD,6EAA6E;AAC7E,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,cAAc,EAAE,GACrB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA4C/B;AAED,gFAAgF;AAChF,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,QAAQ,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/C,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,0EAA0E;AAC1E,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,QAAQ,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAmCnC"}

package/dist/media/usage-sync.js

@@ -0,0 +1,234 @@
+import { createLogger } from '../diagnostics/logger.js';
+const logger = createLogger('media-usage');
+let warnedMissingBinding = false;
+/**
+ * The MediaUsage join table is a denormalized index (which media each document
+ * references). It is maintained inside the document-write/delete transaction,
+ * but must never abort the primary write: if the Prisma `mediaUsage` delegate is
+ * missing from the client (e.g. a consumer bumped cms-core without regenerating
+ * their client, or an older generated client), skip and let `backfillMediaUsage`
+ * reconcile later. Real DB errors still propagate and roll the write back.
+ */
+function hasMediaUsageDelegate(db) {
+    if (typeof db.mediaUsage?.deleteMany === 'function')
+        return true;
+    if (!warnedMissingBinding) {
+        warnedMissingBinding = true;
+        logger.warn('mediaUsage delegate unavailable on the DB client — skipping media-usage sync (run `prisma generate`)');
+    }
+    return false;
+}
+/** Remove every MediaUsage row for a document (e.g. on delete). Tolerates a missing delegate. */
+export async function clearMediaUsageForDocument(db, documentId) {
+    if (!hasMediaUsageDelegate(db))
+        return;
+    await db.mediaUsage.deleteMany({ where: { documentId } });
+}
+const CUID_RE = /^c[a-z0-9]{20,}$/i;
+const OBJECT_ID_RE = /^[a-f0-9]{24}$/i;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const HTML_LIKE = /<\/?[a-z][\s\S]*>/i;
+const IMG_SRC_RE = /<img\b[^>]*\ssrc=["']([^"']+)["']/gi;
+const DATA_MEDIA_ID_RE = /data-media-id=["']([^"']+)["']/gi;
+function isMediaId(value) {
+    return CUID_RE.test(value) || OBJECT_ID_RE.test(value) || UUID_RE.test(value);
+}
+function isResolvableUrl(value) {
+    if (!value || value.startsWith('data:') || value.startsWith('mailto:') || value.startsWith('#')) {
+        return false;
+    }
+    return (value.startsWith('http://') ||
+        value.startsWith('https://') ||
+        (value.startsWith('/') && !value.startsWith('//')));
+}
+function pushRef(out, fieldPath, partial) {
+    if (partial.mediaId || partial.url) {
+        out.push({ fieldPath, ...partial });
+    }
+}
+/** Extract candidate media IDs and URLs from document JSON with field paths. */
+export function extractMediaReferences(data, pathPrefix = '') {
+    const out = [];
+    for (const [key, value] of Object.entries(data)) {
+        const fieldPath = pathPrefix ? `${pathPrefix}.${key}` : key;
+        collectMediaReferences(value, fieldPath, out);
+    }
+    return out;
+}
+function collectMediaReferences(value, fieldPath, out) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed)
+            return;
+        if (isMediaId(trimmed)) {
+            pushRef(out, fieldPath, { mediaId: trimmed });
+            return;
+        }
+        if (HTML_LIKE.test(trimmed)) {
+            for (const mediaId of extractMediaIdsFromHtml(trimmed)) {
+                pushRef(out, fieldPath, { mediaId });
+            }
+            for (const url of extractUrlsFromHtml(trimmed)) {
+                pushRef(out, fieldPath, { url });
+            }
+            return;
+        }
+        if (isResolvableUrl(trimmed)) {
+            pushRef(out, fieldPath, { url: trimmed });
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (let i = 0; i < value.length; i++) {
+            collectMediaReferences(value[i], `${fieldPath}.${i}`, out);
+        }
+        return;
+    }
+    if (value && typeof value === 'object') {
+        const obj = value;
+        const id = obj.id;
+        if (typeof id === 'string' && isMediaId(id)) {
+            pushRef(out, fieldPath, { mediaId: id });
+        }
+        const url = obj.url ?? obj.publicUrl ?? obj.src ?? obj.imageUrl;
+        if (typeof url === 'string' && isResolvableUrl(url)) {
+            pushRef(out, fieldPath, { url });
+        }
+        for (const [key, nested] of Object.entries(obj)) {
+            if (key === 'id' ||
+                key === 'url' ||
+                key === 'publicUrl' ||
+                key === 'src' ||
+                key === 'imageUrl') {
+                continue;
+            }
+            collectMediaReferences(nested, `${fieldPath}.${key}`, out);
+        }
+    }
+}
+function extractMediaIdsFromHtml(html) {
+    const ids = new Set();
+    for (const re of [DATA_MEDIA_ID_RE]) {
+        re.lastIndex = 0;
+        let match;
+        while ((match = re.exec(html)) !== null) {
+            const id = match[1]?.trim();
+            if (id && isMediaId(id))
+                ids.add(id);
+        }
+    }
+    return [...ids];
+}
+function extractUrlsFromHtml(html) {
+    const urls = new Set();
+    IMG_SRC_RE.lastIndex = 0;
+    let match;
+    while ((match = IMG_SRC_RE.exec(html)) !== null) {
+        const url = match[1]?.trim();
+        if (url && isResolvableUrl(url))
+            urls.add(url);
+    }
+    return [...urls];
+}
+function usageKey(mediaId, fieldPath) {
+    return `${mediaId}\0${fieldPath}`;
+}
+/** Resolve extracted refs to existing media IDs (drops unknown IDs/URLs). */
+export async function resolveMediaReferences(db, refs) {
+    const byKey = new Map();
+    for (const ref of refs) {
+        if (ref.mediaId) {
+            byKey.set(usageKey(ref.mediaId, ref.fieldPath), {
+                mediaId: ref.mediaId,
+                fieldPath: ref.fieldPath,
+            });
+        }
+    }
+    const urls = [...new Set(refs.map((r) => r.url).filter((u) => Boolean(u)))];
+    if (urls.length > 0) {
+        const rows = await db.media.findMany({
+            where: {
+                deletedAt: null,
+                OR: [{ publicUrl: { in: urls } }, { storageKey: { in: urls } }],
+            },
+            select: { id: true, publicUrl: true, storageKey: true },
+        });
+        const urlToId = new Map();
+        for (const row of rows) {
+            if (row.publicUrl)
+                urlToId.set(row.publicUrl, row.id);
+            if (row.storageKey)
+                urlToId.set(row.storageKey, row.id);
+        }
+        for (const ref of refs) {
+            if (!ref.url)
+                continue;
+            const mediaId = urlToId.get(ref.url);
+            if (mediaId) {
+                byKey.set(usageKey(mediaId, ref.fieldPath), { mediaId, fieldPath: ref.fieldPath });
+            }
+        }
+    }
+    const candidateIds = [...byKey.values()].map((u) => u.mediaId);
+    if (candidateIds.length === 0)
+        return [];
+    const existing = await db.media.findMany({
+        where: { id: { in: candidateIds }, deletedAt: null },
+        select: { id: true },
+    });
+    const allowed = new Set(existing.map((r) => r.id));
+    return [...byKey.values()].filter((u) => allowed.has(u.mediaId));
+}
+/** Replace all MediaUsage rows for a document with the refs found in `data`. */
+export async function syncMediaUsageForDocument(db, documentId, data) {
+    if (!hasMediaUsageDelegate(db))
+        return;
+    const refs = extractMediaReferences(data && typeof data === 'object' ? data : {});
+    const resolved = await resolveMediaReferences(db, refs);
+    await db.mediaUsage.deleteMany({ where: { documentId } });
+    if (resolved.length === 0)
+        return;
+    await db.mediaUsage.createMany({
+        data: resolved.map((row) => ({
+            mediaId: row.mediaId,
+            documentId,
+            fieldPath: row.fieldPath,
+        })),
+        skipDuplicates: true,
+    });
+}
+/** Re-scan all non-deleted documents and rebuild MediaUsage join rows. */
+export async function backfillMediaUsage(db, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const batchSize = options.batchSize && options.batchSize > 0 ? options.batchSize : 100;
+    const result = { scanned: 0, synced: 0, skipped: 0 };
+    let cursor;
+    for (;;) {
+        const batch = await db.document.findMany({
+            where: { deletedAt: null },
+            orderBy: { id: 'asc' },
+            take: batchSize,
+            ...(cursor ? { skip: 1, cursor: { id: cursor } } : {}),
+            select: { id: true, data: true },
+        });
+        if (batch.length === 0)
+            break;
+        cursor = batch[batch.length - 1].id;
+        for (const doc of batch) {
+            result.scanned++;
+            const data = doc.data && typeof doc.data === 'object' ? doc.data : null;
+            if (!data) {
+                result.skipped++;
+                continue;
+            }
+            if (!dryRun) {
+                await syncMediaUsageForDocument(db, doc.id, data);
+            }
+            result.synced++;
+        }
+        if (batch.length < batchSize)
+            break;
+    }
+    return result;
+}
+//# sourceMappingURL=usage-sync.js.map

package/dist/media/usage-sync.js.map

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

package/dist/middleware.d.ts

@@ -0,0 +1,17 @@
+import type { PrentaCMSConfig } from './config/types.js';
+export interface PrentaMiddlewareConfig {
+    adminPath?: string;
+    ipAllowlist?: string[];
+}
+interface CMSMiddlewareConfigLike {
+    admin?: {
+        path?: string;
+        loginPath?: string;
+        ipAllowlist?: string[];
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export declare function createCMSMiddleware(cmsConfig: PrentaCMSConfig | CMSMiddlewareConfigLike): (request: Request) => Promise<Response | null>;
+export {};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAKxD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,UAAU,uBAAuB;IAC/B,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IAC3F,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB;AAKD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,eAAe,GAAG,uBAAuB,IAQlD,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgFhF"}