lens-content-processor 0.2.1 → 0.3.0

package/dist/validator/tier.d.ts

@@ -0,0 +1,18 @@
+import type { ContentError } from '../index.js';
+export type ContentTier = 'production' | 'wip' | 'ignored';
+/**
+ * Determine content tier from frontmatter tags.
+ * - tags containing 'validator-ignore' → 'ignored'
+ * - tags containing 'wip' → 'wip'
+ * - otherwise → 'production'
+ */
+export declare function getTierFromFrontmatter(frontmatter: Record<string, unknown>): ContentTier;
+/**
+ * Build a tier map for all .md files by parsing their frontmatter tags.
+ */
+export declare function buildTierMap(files: Map<string, string>): Map<string, ContentTier>;
+/**
+ * Check for tier violations when a parent references a child.
+ * Returns a ContentError if the reference violates tier rules, null otherwise.
+ */
+export declare function checkTierViolation(parentPath: string, parentTier: ContentTier, childPath: string, childTier: ContentTier, childLabel: string, line?: number): ContentError | null;

package/dist/validator/tier.js

@@ -0,0 +1,74 @@
+import { parseFrontmatter } from '../parser/frontmatter.js';
+/**
+ * Determine content tier from frontmatter tags.
+ * - tags containing 'validator-ignore' → 'ignored'
+ * - tags containing 'wip' → 'wip'
+ * - otherwise → 'production'
+ */
+export function getTierFromFrontmatter(frontmatter) {
+    const tags = frontmatter.tags;
+    if (!Array.isArray(tags))
+        return 'production';
+    const normalized = tags.map((t) => String(t).toLowerCase());
+    if (normalized.includes('validator-ignore'))
+        return 'ignored';
+    if (normalized.includes('wip') || normalized.includes('work-in-progress'))
+        return 'wip';
+    return 'production';
+}
+/**
+ * Build a tier map for all .md files by parsing their frontmatter tags.
+ */
+export function buildTierMap(files) {
+    const tierMap = new Map();
+    for (const [path, content] of files.entries()) {
+        if (!path.endsWith('.md'))
+            continue;
+        const { frontmatter } = parseFrontmatter(content, path);
+        tierMap.set(path, getTierFromFrontmatter(frontmatter));
+    }
+    return tierMap;
+}
+/**
+ * Check for tier violations when a parent references a child.
+ * Returns a ContentError if the reference violates tier rules, null otherwise.
+ */
+export function checkTierViolation(parentPath, parentTier, childPath, childTier, childLabel, line) {
+    // Ignored parents are never processed (filtered upstream)
+    if (parentTier === 'ignored')
+        return null;
+    // Production parent → child must be production
+    if (parentTier === 'production' && childTier === 'wip') {
+        return {
+            file: parentPath,
+            line,
+            message: `References WIP ${childLabel}: ${childPath}`,
+            suggestion: `Remove the WIP tag from ${childPath}, or add tags: [wip] to this file`,
+            severity: 'error',
+            category: 'production',
+        };
+    }
+    if (parentTier === 'production' && childTier === 'ignored') {
+        return {
+            file: parentPath,
+            line,
+            message: `References ignored ${childLabel}: ${childPath}`,
+            suggestion: `Remove the validator-ignore tag from ${childPath}, or add tags: [wip] to this file`,
+            severity: 'error',
+            category: 'production',
+        };
+    }
+    // WIP parent → child must not be ignored
+    if (parentTier === 'wip' && childTier === 'ignored') {
+        return {
+            file: parentPath,
+            line,
+            message: `References ignored ${childLabel}: ${childPath}`,
+            suggestion: `Remove the validator-ignore tag from ${childPath}`,
+            severity: 'error',
+            category: 'wip',
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=tier.js.map

package/dist/validator/tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.js","sourceRoot":"","sources":["../../src/validator/tier.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAoC;IACzE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,KAAK,CAAC;IACxF,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,UAAuB,EACvB,SAAiB,EACjB,SAAsB,EACtB,UAAkB,EAClB,IAAa;IAEb,0DAA0D;IAC1D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE1C,+CAA+C;IAC/C,IAAI,UAAU,KAAK,YAAY,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACvD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,OAAO,EAAE,kBAAkB,UAAU,KAAK,SAAS,EAAE;YACrD,UAAU,EAAE,2BAA2B,SAAS,mCAAmC;YACnF,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,YAAY;SACvB,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,KAAK,YAAY,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC3D,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,OAAO,EAAE,sBAAsB,UAAU,KAAK,SAAS,EAAE;YACzD,UAAU,EAAE,wCAAwC,SAAS,mCAAmC;YAChG,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,YAAY;SACvB,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,IAAI,UAAU,KAAK,KAAK,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACpD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,OAAO,EAAE,sBAAsB,UAAU,KAAK,SAAS,EAAE;YACzD,UAAU,EAAE,wCAAwC,SAAS,EAAE;YAC/D,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,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.3.0",
   "description": "Parser and validator for Lens educational content (Markdown modules, lenses, learning outcomes)",
   "type": "module",
   "main": "dist/index.js",
@@ -34,12 +34,12 @@
     "directory": "content_processor"
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0",
+    "@types/node": "^22.0.0",
     "tsx": "^4.0.0",
-    "@types/node": "^22.0.0"
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
   },
   "dependencies": {
-    "yaml": "^2.5.0"
+    "yaml": "^2.8.2"
   }
 }