@se-studio/contentful-cms 0.0.0-next16-20260822103555

package/dist/audit/asset-usage.d.ts

@@ -0,0 +1,29 @@
+import type { SafeEnvironment } from '../contentful/client.js';
+export interface AssetUsage {
+    id: string;
+    contentType: string;
+    label: string;
+    slug: string | null;
+}
+/**
+ * Walks UP the entry graph via `links_to_entry` until it reaches a slug-bearing
+ * content type (page, article, articleType, pageVariant, tag, person).
+ */
+export declare function resolveSlugBearingAncestors(env: SafeEnvironment, entryId: string, contentType: string, locale: string, visited: Set<string>, depth?: number): Promise<AssetUsage[]>;
+/** Resolves slug-bearing pages/articles/etc. that use an asset (walk-up from backlinks). */
+export declare function resolveAssetUsages(env: SafeEnvironment, assetId: string, locale: string): Promise<AssetUsage[]>;
+export interface AssetUsageTarget {
+    id: string;
+    usages?: AssetUsage[];
+}
+export interface AttachAssetUsagesResult {
+    limit: number;
+    resolvedCount: number;
+    truncated: boolean;
+}
+/**
+ * Resolves slug-bearing usages for up to `limit` assets (`0` = all).
+ * Mutates each resolved row's `usages` field in place.
+ */
+export declare function attachAssetUsages(env: SafeEnvironment, assets: AssetUsageTarget[], locale: string, limit: number): Promise<AttachAssetUsagesResult>;
+//# sourceMappingURL=asset-usage.d.ts.map

package/dist/audit/asset-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-usage.d.ts","sourceRoot":"","sources":["../../src/audit/asset-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAmB/D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAcD;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,KAAK,SAAI,GACR,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CvB;AAED,4FAA4F;AAC5F,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CAuBvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,gBAAgB,EAAE,EAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,CAAC,CAelC"}

package/dist/audit/asset-usage.js

@@ -0,0 +1,99 @@
+/**
+ * Content types that have a public slug and represent meaningful usage context.
+ * Intermediate types (media, visual, component, collection, navigationItem…)
+ * are traversed silently until one of these is found.
+ */
+const SLUG_BEARING_TYPES = new Set([
+    'page',
+    'article',
+    'articleType',
+    'pageVariant',
+    'tag',
+    'person',
+]);
+const MAX_WALK_DEPTH = 5;
+const WALK_PARENT_LIMIT = 20;
+function getEntryLabel(fields, locale) {
+    const lf = (key) => {
+        const f = fields[key];
+        if (!f)
+            return undefined;
+        const v = f[locale] ?? f['en-US'];
+        return v ? String(v) : undefined;
+    };
+    return (lf('cmsLabel') ?? lf('heading') ?? lf('title') ?? lf('adminLabel') ?? lf('slug') ?? '(no label)');
+}
+/**
+ * Walks UP the entry graph via `links_to_entry` until it reaches a slug-bearing
+ * content type (page, article, articleType, pageVariant, tag, person).
+ */
+export async function resolveSlugBearingAncestors(env, entryId, contentType, locale, visited, depth = 0) {
+    if (visited.has(entryId))
+        return [];
+    visited.add(entryId);
+    if (SLUG_BEARING_TYPES.has(contentType)) {
+        try {
+            const raw = await env.getEntry(entryId);
+            const fields = raw.fields;
+            const label = getEntryLabel(fields, locale);
+            const slugField = fields['slug'];
+            const rawSlug = slugField ? String(slugField[locale] ?? slugField['en-US'] ?? '') : '';
+            const slug = rawSlug ? (rawSlug.startsWith('/') ? rawSlug : `/${rawSlug}`) : null;
+            return [{ id: entryId, contentType, label, slug }];
+        }
+        catch {
+            return [];
+        }
+    }
+    if (depth >= MAX_WALK_DEPTH)
+        return [];
+    const parents = await env.getEntries({ links_to_entry: entryId, limit: WALK_PARENT_LIMIT });
+    const results = [];
+    const seen = new Set();
+    for (const parent of parents.items) {
+        const ancestors = await resolveSlugBearingAncestors(env, parent.sys.id, parent.sys.contentType.sys.id, locale, visited, depth + 1);
+        for (const a of ancestors) {
+            if (!seen.has(a.id)) {
+                seen.add(a.id);
+                results.push(a);
+            }
+        }
+    }
+    return results;
+}
+/** Resolves slug-bearing pages/articles/etc. that use an asset (walk-up from backlinks). */
+export async function resolveAssetUsages(env, assetId, locale) {
+    const backlinks = await env.getEntries({ links_to_asset: assetId, limit: 50 });
+    const seen = new Set();
+    const usages = [];
+    const visited = new Set();
+    for (const entry of backlinks.items) {
+        const ancestors = await resolveSlugBearingAncestors(env, entry.sys.id, entry.sys.contentType.sys.id, locale, visited);
+        for (const a of ancestors) {
+            if (!seen.has(a.id)) {
+                seen.add(a.id);
+                usages.push(a);
+            }
+        }
+    }
+    return usages;
+}
+/**
+ * Resolves slug-bearing usages for up to `limit` assets (`0` = all).
+ * Mutates each resolved row's `usages` field in place.
+ */
+export async function attachAssetUsages(env, assets, locale, limit) {
+    const unlimited = limit === 0;
+    const cap = unlimited ? assets.length : Math.max(0, limit);
+    const toResolve = unlimited ? assets : assets.slice(0, cap);
+    const truncated = !unlimited && assets.length > cap;
+    for (const asset of toResolve) {
+        asset.usages = await resolveAssetUsages(env, asset.id, locale);
+    }
+    return {
+        limit: unlimited ? 0 : cap,
+        resolvedCount: toResolve.length,
+        truncated,
+    };
+}
+//# sourceMappingURL=asset-usage.js.map

package/dist/audit/asset-usage.js.map

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

package/dist/audit/media-review-rules.d.ts

@@ -0,0 +1,33 @@
+export type MediaReviewIssueCode = 'bad_filename' | 'missing_alt' | 'weak_alt' | 'oversized_width' | 'oversized_file' | 'animated_gif' | 'no_media_wrapper';
+export type MediaReviewSeverity = 'fail' | 'warn';
+export interface MediaReviewIssue {
+    code: MediaReviewIssueCode;
+    severity: MediaReviewSeverity;
+    message: string;
+}
+export interface MediaReviewThresholds {
+    maxWidth: number;
+    maxImageBytes: number;
+    maxSvgBytes: number;
+    maxVideoBytes: number;
+    maxLottieBytes: number;
+    warnImageBytes: number;
+    warnVideoBytes: number;
+    warnLottieBytes: number;
+}
+export declare const DEFAULT_MEDIA_REVIEW_THRESHOLDS: MediaReviewThresholds;
+export interface MediaReviewAssetInput {
+    id: string;
+    fileName: string;
+    title: string;
+    description: string | null;
+    contentType: string;
+    width: number | null;
+    height: number | null;
+    size: number | null;
+    mediaEntryCount: number;
+}
+export declare function isVisualAssetContentType(contentType: string): boolean;
+export declare function reviewMediaAsset(asset: MediaReviewAssetInput, thresholds?: MediaReviewThresholds): MediaReviewIssue[];
+export declare function hasFailingIssues(issues: MediaReviewIssue[]): boolean;
+//# sourceMappingURL=media-review-rules.d.ts.map

package/dist/audit/media-review-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-review-rules.d.ts","sourceRoot":"","sources":["../../src/audit/media-review-rules.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,GACd,kBAAkB,CAAC;AAEvB,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,+BAA+B,EAAE,qBAS7C,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAeD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,EAC5B,UAAU,GAAE,qBAAuD,GAClE,gBAAgB,EAAE,CAgGpB;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAEpE"}

package/dist/audit/media-review-rules.js

@@ -0,0 +1,120 @@
+export const DEFAULT_MEDIA_REVIEW_THRESHOLDS = {
+    maxWidth: 2000,
+    maxImageBytes: 800 * 1024,
+    maxSvgBytes: 150 * 1024,
+    maxVideoBytes: 8 * 1024 * 1024,
+    maxLottieBytes: 400 * 1024,
+    warnImageBytes: Math.round(800 * 1024 * 0.6),
+    warnVideoBytes: Math.round(8 * 1024 * 1024 * 0.6),
+    warnLottieBytes: Math.round(400 * 1024 * 0.6),
+};
+const UUID_FILENAME = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}\./i;
+const LONG_HEX_FILENAME = /^[a-f0-9]{24,}\./i;
+const STOCK_PREFIX = /^(istock|getty|shutterstock|pexels|unsplash|adobe|depositphotos|dreamstime)/i;
+const CAMERA_PREFIX = /^(IMG_|DSC_|Screen[\s_-]?Shot|Screenshot)/i;
+const GENERIC_BASENAME = /^(image|photo|picture|untitled|asset|banner|hero|logo|icon)\d*$/i;
+const GENERIC_ALT = /^(image|photo|picture|logo|icon|banner|asset|untitled)$/i;
+function fileBaseName(fileName) {
+    const lastDot = fileName.lastIndexOf('.');
+    return lastDot > 0 ? fileName.slice(0, lastDot) : fileName;
+}
+export function isVisualAssetContentType(contentType) {
+    return (contentType.startsWith('image/') ||
+        contentType.startsWith('video/') ||
+        contentType === 'application/json');
+}
+export function reviewMediaAsset(asset, thresholds = DEFAULT_MEDIA_REVIEW_THRESHOLDS) {
+    const issues = [];
+    const base = fileBaseName(asset.fileName);
+    if (UUID_FILENAME.test(asset.fileName) ||
+        LONG_HEX_FILENAME.test(asset.fileName) ||
+        STOCK_PREFIX.test(base) ||
+        CAMERA_PREFIX.test(base) ||
+        GENERIC_BASENAME.test(base) ||
+        asset.fileName.includes(' ') ||
+        (base.length > 0 && base.length < 6)) {
+        issues.push({
+            code: 'bad_filename',
+            severity: 'fail',
+            message: 'Filename looks auto-generated, stock-sourced, or not descriptive',
+        });
+    }
+    const alt = asset.description?.trim() ?? '';
+    if (!alt) {
+        issues.push({
+            code: 'missing_alt',
+            severity: 'fail',
+            message: 'Missing asset description (alt text)',
+        });
+    }
+    else if (alt.length < 12 || GENERIC_ALT.test(alt) || alt.toLowerCase() === base.toLowerCase()) {
+        issues.push({
+            code: 'weak_alt',
+            severity: 'fail',
+            message: 'Alt text is too short, generic, or copied from the filename',
+        });
+    }
+    if (asset.contentType === 'image/gif') {
+        issues.push({
+            code: 'animated_gif',
+            severity: 'fail',
+            message: 'Animated GIF assets are discouraged — prefer video or static image',
+        });
+    }
+    const isLottieAsset = asset.contentType === 'application/json' ||
+        (asset.fileName ?? '').toLowerCase().endsWith('.lottie') ||
+        (asset.fileName ?? '').toLowerCase().endsWith('.json');
+    const skipWidthCheck = asset.contentType === 'image/svg+xml' || isLottieAsset;
+    if (!skipWidthCheck && asset.width != null && asset.width > thresholds.maxWidth) {
+        issues.push({
+            code: 'oversized_width',
+            severity: 'fail',
+            message: `Width ${String(asset.width)}px exceeds max ${String(thresholds.maxWidth)}px`,
+        });
+    }
+    if (asset.size != null) {
+        let maxBytes = thresholds.maxImageBytes;
+        let warnBytes = thresholds.warnImageBytes;
+        if (asset.contentType === 'image/svg+xml') {
+            maxBytes = thresholds.maxSvgBytes;
+            warnBytes = thresholds.maxSvgBytes;
+        }
+        else if (asset.contentType.startsWith('video/')) {
+            maxBytes = thresholds.maxVideoBytes;
+            warnBytes = thresholds.warnVideoBytes;
+        }
+        else if (isLottieAsset) {
+            maxBytes = thresholds.maxLottieBytes;
+            warnBytes = thresholds.warnLottieBytes;
+        }
+        if (asset.size > maxBytes) {
+            issues.push({
+                code: 'oversized_file',
+                severity: 'fail',
+                message: `File size ${formatKb(asset.size)} exceeds limit ${formatKb(maxBytes)}`,
+            });
+        }
+        else if (asset.size > warnBytes) {
+            issues.push({
+                code: 'oversized_file',
+                severity: 'warn',
+                message: `File size ${formatKb(asset.size)} is large — consider compressing`,
+            });
+        }
+    }
+    if (asset.mediaEntryCount === 0) {
+        issues.push({
+            code: 'no_media_wrapper',
+            severity: 'warn',
+            message: 'No media wrapper entry references this asset in the index (may be unused or RTF-only)',
+        });
+    }
+    return issues;
+}
+function formatKb(bytes) {
+    return `${String(Math.round(bytes / 1024))} KB`;
+}
+export function hasFailingIssues(issues) {
+    return issues.some((issue) => issue.severity === 'fail');
+}
+//# sourceMappingURL=media-review-rules.js.map

package/dist/audit/media-review-rules.js.map

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

package/dist/audit/media-review.d.ts

@@ -0,0 +1,45 @@
+import type { SpaceConfig } from '../config/types.js';
+import type { AssetUsage } from './asset-usage.js';
+import { type MediaReviewIssue, type MediaReviewThresholds } from './media-review-rules.js';
+export interface MediaReviewAssetRow {
+    id: string;
+    title: string;
+    fileName: string;
+    description: string | null;
+    contentType: string;
+    url: string;
+    width: number | null;
+    height: number | null;
+    size: number | null;
+    sizeKb: number | null;
+    updatedAt: string;
+    mediaEntryCount: number;
+    contentfulUrl: string;
+    issues: MediaReviewIssue[];
+    usages?: AssetUsage[];
+}
+export interface MediaReviewReport {
+    space: string;
+    spaceId: string;
+    environment: string;
+    generated: string;
+    preview: boolean;
+    thresholds: MediaReviewThresholds;
+    total: number;
+    failingCount: number;
+    warningCount: number;
+    issueCounts: Record<string, number>;
+    assets: MediaReviewAssetRow[];
+    /** Set when `--include-usage` runs. `0` means unlimited. */
+    usageLimit?: number;
+    usageResolvedCount?: number;
+    usageTruncated?: boolean;
+}
+export interface RunMediaReviewOptions {
+    preview?: boolean;
+    failuresOnly?: boolean;
+    thresholds?: Partial<MediaReviewThresholds>;
+}
+export declare function buildContentfulAssetUrl(space: SpaceConfig, assetId: string): string;
+export declare function runMediaReview(spaceKey: string, space: SpaceConfig, options?: RunMediaReviewOptions): MediaReviewReport;
+//# sourceMappingURL=media-review.d.ts.map

package/dist/audit/media-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-review.d.ts","sourceRoot":"","sources":["../../src/audit/media-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAE3B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,qBAAqB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC7C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,qBAA0B,GAClC,iBAAiB,CAyEnB"}

package/dist/audit/media-review.js

@@ -0,0 +1,69 @@
+import { resolveIndexPreview } from '../index/mode.js';
+import { countMediaByAssetIds, listVisualAssetsForReview } from '../index/query.js';
+import { DEFAULT_MEDIA_REVIEW_THRESHOLDS, hasFailingIssues, reviewMediaAsset, } from './media-review-rules.js';
+export function buildContentfulAssetUrl(space, assetId) {
+    return `https://app.contentful.com/spaces/${space.spaceId}/environments/${space.environment}/assets/${assetId}`;
+}
+export function runMediaReview(spaceKey, space, options = {}) {
+    const preview = resolveIndexPreview(options.preview);
+    const thresholds = {
+        ...DEFAULT_MEDIA_REVIEW_THRESHOLDS,
+        ...options.thresholds,
+    };
+    const rawAssets = listVisualAssetsForReview(space, { preview });
+    const mediaCounts = countMediaByAssetIds(space, rawAssets.map((asset) => asset.id), preview);
+    const assets = [];
+    const issueCounts = {};
+    let warningCount = 0;
+    for (const asset of rawAssets) {
+        const issues = reviewMediaAsset({
+            id: asset.id,
+            fileName: asset.fileName,
+            title: asset.title,
+            description: asset.description,
+            contentType: asset.contentType,
+            width: asset.width,
+            height: asset.height,
+            size: asset.size,
+            mediaEntryCount: mediaCounts.get(asset.id) ?? 0,
+        }, thresholds);
+        for (const issue of issues) {
+            issueCounts[issue.code] = (issueCounts[issue.code] ?? 0) + 1;
+            if (issue.severity === 'warn')
+                warningCount += 1;
+        }
+        const hasFail = hasFailingIssues(issues);
+        if (options.failuresOnly && !hasFail)
+            continue;
+        assets.push({
+            id: asset.id,
+            title: asset.title,
+            fileName: asset.fileName,
+            description: asset.description,
+            contentType: asset.contentType,
+            url: asset.url,
+            width: asset.width,
+            height: asset.height,
+            size: asset.size,
+            sizeKb: asset.size != null ? Math.round(asset.size / 1024) : null,
+            updatedAt: asset.updatedAt,
+            mediaEntryCount: mediaCounts.get(asset.id) ?? 0,
+            contentfulUrl: buildContentfulAssetUrl(space, asset.id),
+            issues,
+        });
+    }
+    return {
+        space: spaceKey,
+        spaceId: space.spaceId,
+        environment: space.environment,
+        generated: new Date().toISOString(),
+        preview,
+        thresholds,
+        total: rawAssets.length,
+        failingCount: assets.filter((asset) => hasFailingIssues(asset.issues)).length,
+        warningCount,
+        issueCounts,
+        assets,
+    };
+}
+//# sourceMappingURL=media-review.js.map

package/dist/audit/media-review.js.map

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

package/dist/bin/cms-edit.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+export {};
+//# sourceMappingURL=cms-edit.d.ts.map

package/dist/bin/cms-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-edit.d.ts","sourceRoot":"","sources":["../../src/bin/cms-edit.ts"],"names":[],"mappings":";AACA,uFAAuF"}

package/dist/bin/cms-edit.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createCmsEditProgram } from '../cli/program.js';
+import { CMS_EDIT_VERSION } from '../version.js';
+const program = createCmsEditProgram();
+const _origExit = process.exit.bind(process);
+process.exit = ((code) => {
+    const numCode = typeof code === 'string' ? Number.parseInt(code, 10) : (code ?? 0);
+    _origExit(Number.isNaN(numCode) ? 1 : numCode);
+});
+if (process.argv.includes('--docs')) {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    const packageRoot = path.resolve(dir, '..', '..');
+    const readmePath = path.join(packageRoot, 'README.md');
+    console.log(path.resolve(readmePath));
+    process.exit(0);
+}
+if (process.argv.includes('--version') || process.argv.includes('-V')) {
+    console.log(CMS_EDIT_VERSION);
+    process.exit(0);
+}
+const argv = process.argv.slice(2);
+let idx = 0;
+let firstPositional;
+while (idx < argv.length) {
+    const a = argv[idx];
+    if (a === undefined || !a.startsWith('-')) {
+        firstPositional = a;
+        break;
+    }
+    if (a === '--config' || a === '--space' || a === '--session')
+        idx += 2;
+    else
+        idx += 1;
+}
+if (firstPositional === undefined || firstPositional === 'help') {
+    program.outputHelp();
+    process.exit(0);
+}
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    _origExit(1);
+});
+//# sourceMappingURL=cms-edit.js.map

package/dist/bin/cms-edit.js.map

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

package/dist/cli/program.d.ts

@@ -0,0 +1,9 @@
+/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
+import { Command } from 'commander';
+export interface CmsEditProgramHooks {
+    onPreAction?: (command: string, subcommand?: string) => void;
+    onPostAction?: () => void;
+    onError?: (err: unknown) => void;
+}
+export declare function createCmsEditProgram(hooks?: CmsEditProgramHooks): Command;
+//# sourceMappingURL=program.d.ts.map

package/dist/cli/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6DpC,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,mBAAwB,GAAG,OAAO,CAoG7E"}