lens-content-processor 0.2.1 → 0.2.2

package/dist/validator/field-values.d.ts

@@ -1,4 +1,18 @@
 import type { ContentError } from '../index.js';
+/**
+ * Validate slug format.
+ *
+ * Valid slugs must:
+ * - Contain only lowercase letters, numbers, and hyphens
+ * - Not start or end with a hyphen
+ * - Not contain spaces or special characters
+ *
+ * @param slug - The slug value to validate
+ * @param file - File path for error reporting
+ * @param line - Line number for error reporting
+ * @returns ContentError if invalid, null if valid
+ */
+export declare function validateSlugFormat(slug: string, file: string, line: number): ContentError | null;
 /**
  * Validate field values, checking for appropriate types.
  * Currently validates that boolean fields contain 'true' or 'false'.

package/dist/validator/field-values.js

@@ -1,11 +1,65 @@
+import { ALL_BOOLEAN_FIELDS } from '../content-schema.js';
 /**
- * Fields that should only contain boolean values ('true' or 'false').
+ * Valid slug pattern: lowercase letters, numbers, and hyphens only.
+ * Must not start or end with a hyphen.
  */
-const BOOLEAN_FIELDS = new Set([
-    'optional',
-    'hidePreviousContentFromUser',
-    'hidePreviousContentFromTutor',
-]);
+const VALID_SLUG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/**
+ * Validate slug format.
+ *
+ * Valid slugs must:
+ * - Contain only lowercase letters, numbers, and hyphens
+ * - Not start or end with a hyphen
+ * - Not contain spaces or special characters
+ *
+ * @param slug - The slug value to validate
+ * @param file - File path for error reporting
+ * @param line - Line number for error reporting
+ * @returns ContentError if invalid, null if valid
+ */
+export function validateSlugFormat(slug, file, line) {
+    // Check for uppercase letters first (more specific message)
+    if (/[A-Z]/.test(slug)) {
+        return {
+            file,
+            line,
+            message: `Invalid slug format '${slug}': contains uppercase letters`,
+            suggestion: `Use lowercase only. Try '${slug.toLowerCase()}'`,
+            severity: 'error',
+        };
+    }
+    // Check for leading hyphen
+    if (slug.startsWith('-')) {
+        return {
+            file,
+            line,
+            message: `Invalid slug format '${slug}': cannot start with a hyphen`,
+            suggestion: 'Remove the leading hyphen',
+            severity: 'error',
+        };
+    }
+    // Check for trailing hyphen
+    if (slug.endsWith('-')) {
+        return {
+            file,
+            line,
+            message: `Invalid slug format '${slug}': cannot end with a hyphen`,
+            suggestion: 'Remove the trailing hyphen',
+            severity: 'error',
+        };
+    }
+    // Check general pattern (lowercase, numbers, hyphens only)
+    if (!VALID_SLUG_PATTERN.test(slug)) {
+        return {
+            file,
+            line,
+            message: `Invalid slug format '${slug}': must contain only lowercase letters, numbers, and hyphens`,
+            suggestion: 'Use only a-z, 0-9, and hyphens (-)',
+            severity: 'error',
+        };
+    }
+    return null;
+}
 /**
  * Validate field values, checking for appropriate types.
  * Currently validates that boolean fields contain 'true' or 'false'.
@@ -19,7 +73,7 @@ export function validateFieldValues(fields, file, line) {
     const warnings = [];
     for (const [name, value] of Object.entries(fields)) {
         // Check if this is a boolean field
-        if (BOOLEAN_FIELDS.has(name)) {
+        if (ALL_BOOLEAN_FIELDS.includes(name)) {
             const normalizedValue = value.toLowerCase();
             if (normalizedValue !== 'true' && normalizedValue !== 'false') {
                 warnings.push({

package/dist/validator/field-values.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-values.js","sourceRoot":"","sources":["../../src/validator/field-values.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,UAAU;IACV,6BAA6B;IAC7B,8BAA8B;CAC/B,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA8B,EAC9B,IAAY,EACZ,IAAY;IAEZ,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,mCAAmC;QACnC,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,eAAe,KAAK,MAAM,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;gBAC9D,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI;oBACJ,IAAI;oBACJ,OAAO,EAAE,UAAU,IAAI,4BAA4B,KAAK,GAAG;oBAC3D,UAAU,EAAE,4BAA4B;oBACxC,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"field-values.js","sourceRoot":"","sources":["../../src/validator/field-values.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;GAGG;AACH,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,IAAY,EACZ,IAAY;IAEZ,4DAA4D;IAC5D,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,IAAI;YACJ,IAAI;YACJ,OAAO,EAAE,wBAAwB,IAAI,+BAA+B;YACpE,UAAU,EAAE,4BAA4B,IAAI,CAAC,WAAW,EAAE,GAAG;YAC7D,QAAQ,EAAE,OAAO;SAClB,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,IAAI;YACJ,IAAI;YACJ,OAAO,EAAE,wBAAwB,IAAI,+BAA+B;YACpE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,OAAO;SAClB,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,IAAI;YACJ,IAAI;YACJ,OAAO,EAAE,wBAAwB,IAAI,6BAA6B;YAClE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,OAAO;SAClB,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,IAAI;YACJ,IAAI;YACJ,OAAO,EAAE,wBAAwB,IAAI,8DAA8D;YACnG,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,OAAO;SAClB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA8B,EAC9B,IAAY,EACZ,IAAY;IAEZ,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,mCAAmC;QACnC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,eAAe,KAAK,MAAM,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;gBAC9D,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI;oBACJ,IAAI;oBACJ,OAAO,EAAE,UAAU,IAAI,4BAA4B,KAAK,GAAG;oBAC3D,UAAU,EAAE,4BAA4B;oBACxC,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/validator/output-integrity.d.ts

@@ -0,0 +1,7 @@
+import type { ContentError, FlattenedModule } from '../index.js';
+/**
+ * Broad safety-net validation on the flattened output.
+ * Catches empty sections (no segments) and empty segments (no content)
+ * that specific validators might have missed.
+ */
+export declare function validateOutputIntegrity(modules: FlattenedModule[], slugToPath?: Map<string, string>): ContentError[];

package/dist/validator/output-integrity.js

@@ -0,0 +1,57 @@
+/**
+ * Broad safety-net validation on the flattened output.
+ * Catches empty sections (no segments) and empty segments (no content)
+ * that specific validators might have missed.
+ */
+export function validateOutputIntegrity(modules, slugToPath) {
+    const errors = [];
+    for (const module of modules) {
+        const file = slugToPath?.get(module.slug) ?? module.slug;
+        for (const section of module.sections) {
+            const sectionLabel = section.meta.title ?? section.type;
+            if (section.segments.length === 0) {
+                errors.push({
+                    file,
+                    message: `Section "${sectionLabel}" has no segments`,
+                    severity: 'error',
+                });
+                continue;
+            }
+            for (let i = 0; i < section.segments.length; i++) {
+                const segment = section.segments[i];
+                switch (segment.type) {
+                    case 'text':
+                        if (!segment.content?.trim()) {
+                            errors.push({
+                                file,
+                                message: `Empty text segment in "${sectionLabel}" (segment ${i + 1})`,
+                                severity: 'error',
+                            });
+                        }
+                        break;
+                    case 'article-excerpt':
+                        if (!segment.content?.trim()) {
+                            errors.push({
+                                file,
+                                message: `Empty article-excerpt segment in "${sectionLabel}" (segment ${i + 1})`,
+                                severity: 'error',
+                            });
+                        }
+                        break;
+                    case 'video-excerpt':
+                        if (!segment.transcript?.trim()) {
+                            errors.push({
+                                file,
+                                message: `Empty video-excerpt transcript in "${sectionLabel}" (segment ${i + 1})`,
+                                severity: 'error',
+                            });
+                        }
+                        break;
+                    // chat segments have no required content body
+                }
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=output-integrity.js.map

package/dist/validator/output-integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-integrity.js","sourceRoot":"","sources":["../../src/validator/output-integrity.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA0B,EAC1B,UAAgC;IAEhC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;QAEzD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAExD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,OAAO,EAAE,YAAY,YAAY,mBAAmB;oBACpD,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAEpC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,KAAK,MAAM;wBACT,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;4BAC7B,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,OAAO,EAAE,0BAA0B,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACrE,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,KAAK,iBAAiB;wBACpB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;4BAC7B,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,OAAO,EAAE,qCAAqC,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCAChF,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,KAAK,eAAe;wBAClB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;4BAChC,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,OAAO,EAAE,sCAAsC,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACjF,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,8CAA8C;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/validator/segment-fields.js

@@ -1,18 +1,4 @@
-/**
- * Define which fields are valid for each segment type.
- * This allows us to warn when a field appears in the wrong segment type.
- */
-const VALID_FIELDS_BY_SEGMENT_TYPE = {
-    text: new Set(['content', 'optional']),
-    chat: new Set([
-        'instructions',
-        'optional',
-        'hidePreviousContentFromUser',
-        'hidePreviousContentFromTutor',
-    ]),
-    'article-excerpt': new Set(['from', 'to', 'optional']),
-    'video-excerpt': new Set(['from', 'to', 'optional']),
-};
+import { VALID_FIELDS_BY_SEGMENT_TYPE } from '../content-schema.js';
 /**
  * Fields that are specific to excerpt segments (not valid in text/chat).
  */

package/dist/validator/segment-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"segment-fields.js","sourceRoot":"","sources":["../../src/validator/segment-fields.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,4BAA4B,GAAgC;IAChE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACtC,IAAI,EAAE,IAAI,GAAG,CAAC;QACZ,cAAc;QACd,UAAU;QACV,6BAA6B;QAC7B,8BAA8B;KAC/B,CAAC;IACF,iBAAiB,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACtD,eAAe,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,MAA8B,EAC9B,IAAY,EACZ,IAAY;IAEZ,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,4BAA4B,CAAC,WAAW,CAAC,CAAC;IAE9D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,sDAAsD;QACtD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,oEAAoE;YACpE,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI;oBACJ,IAAI;oBACJ,OAAO,EAAE,UAAU,SAAS,qBAAqB,WAAW,UAAU;oBACtE,UAAU,EAAE,IAAI,SAAS,8DAA8D;oBACvF,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,2DAA2D;YAC3D,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"segment-fields.js","sourceRoot":"","sources":["../../src/validator/segment-fields.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,MAA8B,EAC9B,IAAY,EACZ,IAAY;IAEZ,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,4BAA4B,CAAC,WAAW,CAAC,CAAC;IAE9D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,sDAAsD;QACtD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,oEAAoE;YACpE,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI;oBACJ,IAAI;oBACJ,OAAO,EAAE,UAAU,SAAS,qBAAqB,WAAW,UAAU;oBACtE,UAAU,EAAE,IAAI,SAAS,8DAA8D;oBACvF,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,2DAA2D;YAC3D,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/validator/timestamps.d.ts

@@ -0,0 +1,2 @@
+import type { ContentError } from '../index.js';
+export declare function validateTimestamps(content: string, file: string): ContentError[];

package/dist/validator/timestamps.js

@@ -0,0 +1,91 @@
+import { parseTimestamp } from '../bundler/video.js';
+export function validateTimestamps(content, file) {
+    const errors = [];
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (e) {
+        errors.push({
+            file,
+            line: 1,
+            message: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`,
+            severity: 'error',
+        });
+        return errors;
+    }
+    if (!Array.isArray(parsed)) {
+        errors.push({
+            file,
+            line: 1,
+            message: 'Timestamps file must contain a JSON array',
+            severity: 'error',
+        });
+        return errors;
+    }
+    if (parsed.length === 0) {
+        errors.push({
+            file,
+            line: 1,
+            message: 'Timestamps array is empty',
+            severity: 'warning',
+        });
+        return errors;
+    }
+    let prevSeconds = null;
+    for (let i = 0; i < parsed.length; i++) {
+        const entry = parsed[i];
+        if (typeof entry.text !== 'string' && entry.text !== undefined) {
+            errors.push({
+                file,
+                message: `Entry ${i}: 'text' must be a string`,
+                severity: 'error',
+            });
+        }
+        else if (entry.text === undefined) {
+            errors.push({
+                file,
+                message: `Entry ${i}: missing required field 'text'`,
+                severity: 'error',
+            });
+        }
+        if (entry.start === undefined) {
+            errors.push({
+                file,
+                message: `Entry ${i}: missing required field 'start'`,
+                severity: 'error',
+            });
+        }
+        else if (typeof entry.start === 'string') {
+            const seconds = parseTimestamp(entry.start);
+            if (seconds === null) {
+                errors.push({
+                    file,
+                    message: `Entry ${i}: invalid timestamp format '${entry.start}'`,
+                    suggestion: 'Use format M:SS.ms (e.g., 0:01.32)',
+                    severity: 'error',
+                });
+            }
+            else {
+                if (prevSeconds !== null && seconds < prevSeconds) {
+                    errors.push({
+                        file,
+                        message: `Entry ${i}: non-monotonic timestamp '${entry.start}' (previous was later)`,
+                        severity: 'warning',
+                    });
+                }
+                prevSeconds = seconds;
+            }
+        }
+        else {
+            errors.push({
+                file,
+                message: `Entry ${i}: 'start' must be a string, got ${typeof entry.start}`,
+                suggestion: "Use string format like '0:01.32' instead of a number",
+                severity: 'error',
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=timestamps.js.map

package/dist/validator/timestamps.js.map

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

package/dist/validator/url-reachability.d.ts

@@ -0,0 +1,8 @@
+import type { ContentError } from '../index.js';
+export interface UrlToValidate {
+    url: string;
+    file: string;
+    line: number;
+    label: string;
+}
+export declare function validateUrls(urls: UrlToValidate[]): Promise<ContentError[]>;

package/dist/validator/url-reachability.js

@@ -0,0 +1,60 @@
+const CONCURRENCY = 10;
+const TIMEOUT_MS = 15_000;
+// Status codes that mean "server is alive" even though response.ok is false
+const REACHABLE_STATUSES = new Set([429]);
+async function fetchWithTimeout(url, method, signal) {
+    return fetch(url, { method, signal });
+}
+async function checkUrl(entry) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        let response = await fetchWithTimeout(entry.url, 'HEAD', controller.signal);
+        // Some servers reject HEAD — retry with GET
+        if (response.status === 405) {
+            response = await fetchWithTimeout(entry.url, 'GET', controller.signal);
+        }
+        clearTimeout(timeout);
+        if (!response.ok && !REACHABLE_STATUSES.has(response.status)) {
+            return {
+                file: entry.file,
+                line: entry.line,
+                message: `${entry.label} returned HTTP ${response.status}: ${entry.url}`,
+                severity: 'warning',
+            };
+        }
+        return null;
+    }
+    catch (error) {
+        if (error instanceof DOMException && error.name === 'AbortError') {
+            return {
+                file: entry.file,
+                line: entry.line,
+                message: `${entry.label} timed out: ${entry.url}`,
+                severity: 'warning',
+            };
+        }
+        return {
+            file: entry.file,
+            line: entry.line,
+            message: `${entry.label} unreachable: ${entry.url}`,
+            severity: 'warning',
+        };
+    }
+}
+export async function validateUrls(urls) {
+    if (urls.length === 0)
+        return [];
+    const warnings = [];
+    // Process in batches to avoid overwhelming servers/network
+    for (let i = 0; i < urls.length; i += CONCURRENCY) {
+        const batch = urls.slice(i, i + CONCURRENCY);
+        const results = await Promise.all(batch.map(checkUrl));
+        for (const result of results) {
+            if (result)
+                warnings.push(result);
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=url-reachability.js.map

package/dist/validator/url-reachability.js.map

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

package/dist/validator/validate-frontmatter.d.ts

@@ -0,0 +1,9 @@
+import type { ContentError } from '../index.js';
+/**
+ * Generic frontmatter validation against the schema for a content type.
+ * Checks required fields (present + non-empty) and detects typos.
+ *
+ * Note: This does NOT handle type-specific validation like slug format
+ * or id-must-be-string. Parsers still handle those themselves.
+ */
+export declare function validateFrontmatter(frontmatter: Record<string, unknown>, contentType: string, file: string): ContentError[];

package/dist/validator/validate-frontmatter.js

@@ -0,0 +1,53 @@
+import { CONTENT_SCHEMAS } from '../content-schema.js';
+import { detectFrontmatterTypos, levenshtein } from './field-typos.js';
+/**
+ * Generic frontmatter validation against the schema for a content type.
+ * Checks required fields (present + non-empty) and detects typos.
+ *
+ * Note: This does NOT handle type-specific validation like slug format
+ * or id-must-be-string. Parsers still handle those themselves.
+ */
+export function validateFrontmatter(frontmatter, contentType, file) {
+    const schema = CONTENT_SCHEMAS[contentType];
+    if (!schema)
+        return [];
+    const errors = [];
+    // Detect typos in field names
+    errors.push(...detectFrontmatterTypos(frontmatter, schema.allFields, file));
+    // Check required fields
+    for (const field of schema.requiredFields) {
+        const value = frontmatter[field];
+        if (value === undefined || value === null) {
+            // Check if a similar field exists (likely typo or wrong name)
+            let suggestion = `Add '${field}' to frontmatter`;
+            const presentFields = Object.keys(frontmatter);
+            for (const present of presentFields) {
+                if (schema.requiredFields.includes(present))
+                    continue; // skip other required fields
+                const dist = levenshtein(field.toLowerCase(), present.toLowerCase());
+                if (dist <= 3 || field.toLowerCase().includes(present.toLowerCase()) || present.toLowerCase().includes(field.toLowerCase())) {
+                    suggestion = `Did you mean '${field}' instead of '${present}'?`;
+                    break;
+                }
+            }
+            errors.push({
+                file,
+                line: 2,
+                message: `Missing required field: ${field}`,
+                suggestion,
+                severity: 'error',
+            });
+        }
+        else if (typeof value === 'string' && value.trim() === '') {
+            errors.push({
+                file,
+                line: 2,
+                message: `Field '${field}' must not be empty`,
+                suggestion: `Provide a value for '${field}'`,
+                severity: 'error',
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-frontmatter.js.map

package/dist/validator/validate-frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-frontmatter.js","sourceRoot":"","sources":["../../src/validator/validate-frontmatter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAoC,EACpC,WAAmB,EACnB,IAAY;IAEZ,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,8BAA8B;IAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAE5E,wBAAwB;IACxB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,8DAA8D;YAC9D,IAAI,UAAU,GAAG,QAAQ,KAAK,kBAAkB,CAAC;YACjD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/C,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;gBACpC,IAAI,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,SAAS,CAAC,6BAA6B;gBACpF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;gBACrE,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC5H,UAAU,GAAG,iBAAiB,KAAK,iBAAiB,OAAO,IAAI,CAAC;oBAChE,MAAM;gBACR,CAAC;YACH,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,2BAA2B,KAAK,EAAE;gBAC3C,UAAU;gBACV,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,UAAU,KAAK,qBAAqB;gBAC7C,UAAU,EAAE,wBAAwB,KAAK,GAAG;gBAC5C,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lens-content-processor",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Parser and validator for Lens educational content (Markdown modules, lenses, learning outcomes)",
   "type": "module",
   "main": "dist/index.js",