@slicedearth/whoisleuth-cli 2.0.1 → 2.1.0

package/cli/formatters/terminal-metadata.mjs

@@ -0,0 +1,58 @@
+import { validHttpDeliveryMetadata, validPagePublicationMetadata, } from "../../lib/homepage-metadata-contract.mjs";
+import { safeTerminalValue, terminalDisplayCount, terminalRecord, titleCase, } from "./terminal-shared.mjs";
+function appendPublicationMetadataLines(lines, value, detail) {
+    if (detail === 'summary' || !validPagePublicationMetadata(value))
+        return;
+    const metadata = terminalRecord(value);
+    const robots = terminalRecord(metadata.robots);
+    const twitter = terminalRecord(metadata.twitterCard);
+    const headings = terminalRecord(metadata.headings);
+    const images = terminalRecord(metadata.images);
+    const blocking = terminalRecord(metadata.renderBlockingCandidates);
+    lines.push(`Publication    ${metadata.complete === true ? 'Complete' : 'Partial'} · robots ${titleCase(robots.status)} · card ${titleCase(twitter.status)}`);
+    const directives = Array.isArray(robots.directives) ? robots.directives.map((item) => safeTerminalValue(item)) : [];
+    if (directives.length)
+        lines.push(`Robots         ${safeTerminalValue(directives.join(', '))}${robots.conflicting === true ? ' · conflicting' : ''}`);
+    else if (robots.status === 'not_observed')
+        lines.push('Robots         No declaration observed in captured static HTML');
+    if (twitter.cardType)
+        lines.push(`Card type      ${safeTerminalValue(twitter.cardType)}`);
+    lines.push(`Static page    headings ${terminalDisplayCount(headings.total)} · images ${terminalDisplayCount(images.total)} · blocking candidates ${terminalDisplayCount(blocking.total)}`);
+    if (detail === 'verbose') {
+        lines.push(`Image alt      missing ${terminalDisplayCount(images.altMissing)} · empty ${terminalDisplayCount(images.altEmpty)} · non-empty ${terminalDisplayCount(images.altNonEmpty)} · unclassified ${terminalDisplayCount(images.altUnclassified)}`);
+        lines.push(`Blocking       scripts ${terminalDisplayCount(blocking.script)} · stylesheets ${terminalDisplayCount(blocking.stylesheet)} · static candidates only`);
+    }
+}
+function appendDeliveryMetadataLines(lines, value, verbose = false) {
+    if (!validHttpDeliveryMetadata(value))
+        return;
+    const metadata = terminalRecord(value);
+    const encoding = terminalRecord(metadata.contentEncoding);
+    const cache = terminalRecord(metadata.cachePolicy);
+    const codings = Array.isArray(encoding.codings) ? encoding.codings.map((item) => safeTerminalValue(item)) : [];
+    lines.push(`Delivery       ${metadata.complete === true ? 'Complete' : 'Partial'} · encoding ${titleCase(encoding.status)} · cache ${titleCase(cache.status)}`);
+    if (codings.length)
+        lines.push(`Content coding ${safeTerminalValue(codings.join(', '))}`);
+    const cacheDirectives = [
+        ['no-store', cache.noStore], ['no-cache', cache.noCache], ['must-revalidate', cache.mustRevalidate],
+        ['public', cache.public], ['private', cache.private], ['immutable', cache.immutable],
+    ].filter(([, present]) => present === true).map(([label]) => label);
+    if (cacheDirectives.length)
+        lines.push(`Cache policy   ${safeTerminalValue(cacheDirectives.join(', '))}`);
+    if (verbose) {
+        const seconds = [
+            cache.maxAgeSeconds === null ? null : `max-age ${terminalDisplayCount(cache.maxAgeSeconds)}s`,
+            cache.sMaxAgeSeconds === null ? null : `s-maxage ${terminalDisplayCount(cache.sMaxAgeSeconds)}s`,
+            cache.ageSeconds === null ? null : `Age ${terminalDisplayCount(cache.ageSeconds)}s`,
+        ].filter(Boolean);
+        if (seconds.length)
+            lines.push(`Cache timing   ${safeTerminalValue(seconds.join(' · '))}`);
+        const declared = [
+            terminalRecord(cache.etag).present === true ? 'ETag' : null,
+            terminalRecord(cache.lastModified).present === true ? 'Last-Modified' : null,
+            terminalRecord(cache.expires).present === true ? 'Expires' : null,
+        ].filter(Boolean);
+        lines.push(`Validators     ${declared.length ? safeTerminalValue(declared.join(', ')) : 'No validator declaration observed'}`);
+    }
+}
+export { appendDeliveryMetadataLines, appendPublicationMetadataLines };

package/cli/formatters/terminal-shared.mjs

@@ -0,0 +1,83 @@
+const MAX_TERMINAL_VALUE_LENGTH = 240;
+const MAX_TLS_TERMINAL_ALT_NAMES = 10;
+const MAX_TLS_TERMINAL_PURPOSES = 8;
+// Archive values are attacker-controlled evidence. Remove the complete Unicode
+// default-ignorable class so visually identical identifiers cannot differ only
+// through soft hyphens, combining grapheme joiners, variation selectors, tag
+// characters, bidi controls, or other zero-width formatting code points.
+const TERMINAL_DEFAULT_IGNORABLE_RE = /\p{Default_Ignorable_Code_Point}/gu;
+function safeTerminalValue(value, fallback = '—') {
+    if (value === null || value === undefined || value === '')
+        return fallback;
+    const normalized = String(value)
+        .replace(/[\x00-\x1f\x7f-\x9f]+/g, ' ')
+        .replace(TERMINAL_DEFAULT_IGNORABLE_RE, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!normalized)
+        return fallback;
+    return normalized.length > MAX_TERMINAL_VALUE_LENGTH
+        ? `${normalized.slice(0, MAX_TERMINAL_VALUE_LENGTH - 1)}…`
+        : normalized;
+}
+function boundedTerminalList(values, omitted) {
+    const suffix = omitted > 0 ? ` · +${omitted} more` : '';
+    const maximumBodyLength = Math.max(1, MAX_TERMINAL_VALUE_LENGTH - suffix.length);
+    const joined = values.join(', ');
+    const body = joined.length > maximumBodyLength
+        ? `${joined.slice(0, Math.max(0, maximumBodyLength - 1))}…`
+        : joined;
+    return `${body}${suffix}`;
+}
+function boundedTerminalComponent(value, maximum) {
+    const normalized = safeTerminalValue(value);
+    return normalized.length > maximum ? `${normalized.slice(0, Math.max(0, maximum - 1))}…` : normalized;
+}
+function boundedTerminalWithSuffix(value, suffix) {
+    if (!suffix)
+        return safeTerminalValue(value);
+    const retainedSuffix = suffix.length >= MAX_TERMINAL_VALUE_LENGTH
+        ? `${suffix.slice(0, MAX_TERMINAL_VALUE_LENGTH - 1)}…`
+        : suffix;
+    const maximumValueLength = Math.max(1, MAX_TERMINAL_VALUE_LENGTH - retainedSuffix.length);
+    const retainedValue = value.length > maximumValueLength
+        ? `${value.slice(0, Math.max(0, maximumValueLength - 1))}…`
+        : value;
+    return `${retainedValue}${retainedSuffix}`;
+}
+function titleCase(value) {
+    const text = safeTerminalValue(value, 'unknown').replaceAll('_', ' ');
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+function terminalRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function terminalCount(value) {
+    const count = Number(value);
+    return Number.isSafeInteger(count) && count >= 0 ? Math.min(count, 999) : 0;
+}
+function terminalDisplayCount(value) {
+    const count = Number(value);
+    return Number.isSafeInteger(count) && count >= 0 ? String(count) : '0';
+}
+function terminalCountSummary(value, labels) {
+    const source = terminalRecord(value);
+    return labels
+        .map(([key, label]) => {
+        const count = Number(source[key]);
+        return [label, Number.isSafeInteger(count) && count >= 0 ? count : 0];
+    })
+        .filter(([, count]) => count > 0)
+        .map(([label, count]) => `${label} ${terminalDisplayCount(count)}`)
+        .join(', ');
+}
+function appendSection(lines, label, values) {
+    if (!values.length)
+        return;
+    if (lines.length)
+        lines.push('');
+    lines.push(`${label}:`, ...values);
+}
+export { MAX_TERMINAL_VALUE_LENGTH, MAX_TLS_TERMINAL_ALT_NAMES, MAX_TLS_TERMINAL_PURPOSES, appendSection, boundedTerminalComponent, boundedTerminalList, boundedTerminalWithSuffix, safeTerminalValue, terminalCount, terminalCountSummary, terminalDisplayCount, terminalRecord, titleCase, };