@slicedearth/whoisleuth-cli 1.47.4 → 2.0.0

package/lib/observation.mjs

@@ -1,115 +0,0 @@
-// Compact provenance envelope for network-derived evidence. Type-specific
-// payloads remain beside this object; the envelope only standardizes source
-// health, timing, completeness, truncation, and bounded limitations.
-const OBSERVATION_VERSION = 1;
-const STATUSES = new Set([
-    'success',
-    'partial',
-    'not_found',
-    'skipped',
-    'error',
-    'unsupported',
-    'not_applicable',
-]);
-const SCAN_MODES = new Set(['fast', 'deep']);
-const MAX_OBSERVATION_LIMITATIONS = 10;
-const MAX_OBSERVATION_LIMITATION_LENGTH = 300;
-const MAX_OBSERVATION_DIAGNOSTICS = 20;
-const MAX_DIAGNOSTICS = MAX_OBSERVATION_DIAGNOSTICS;
-const MAX_DIAGNOSTIC_KEY = 40;
-const MAX_DIAGNOSTIC_STRING = 240;
-const MAX_DURATION_MS = 120_000;
-function isObservationStatus(value) {
-    return typeof value === 'string' && STATUSES.has(value);
-}
-function isScanMode(value) {
-    return typeof value === 'string' && SCAN_MODES.has(value);
-}
-function safeString(value, maxLength) {
-    if (typeof value !== 'string')
-        return null;
-    const normalized = value.trim().replace(/[\u0000-\u001f\u007f]/g, ' ');
-    return normalized ? normalized.slice(0, maxLength) : null;
-}
-function isoTimestamp(value) {
-    if (typeof value !== 'string' || value.length > 64 || /[\u0000-\u001f\u007f]/.test(value))
-        return null;
-    const time = Date.parse(value);
-    return Number.isFinite(time) ? new Date(time).toISOString() : null;
-}
-function normalizeDiagnosticValue(value) {
-    if (typeof value === 'boolean')
-        return value;
-    if (typeof value === 'number')
-        return Number.isFinite(value) ? value : null;
-    if (typeof value === 'string')
-        return safeString(value, MAX_DIAGNOSTIC_STRING);
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return null;
-    const record = value;
-    const output = {};
-    for (const field of ['status', 'error', 'detail', 'truncated', 'discarded', 'count']) {
-        if (!Object.prototype.hasOwnProperty.call(record, field))
-            continue;
-        const normalized = normalizeDiagnosticValue(record[field]);
-        if (normalized !== null)
-            output[field] = normalized;
-    }
-    return Object.keys(output).length ? output : null;
-}
-function normalizeDiagnostics(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return {};
-    const record = value;
-    const output = {};
-    for (const key of Object.keys(record).sort().slice(0, MAX_DIAGNOSTICS)) {
-        if (!key || key.length > MAX_DIAGNOSTIC_KEY || !/^[a-z0-9_-]+$/i.test(key))
-            continue;
-        const normalized = normalizeDiagnosticValue(record[key]);
-        if (normalized !== null)
-            output[key] = normalized;
-    }
-    return output;
-}
-function createObservation(input = {}) {
-    const status = isObservationStatus(input.status) ? input.status : 'error';
-    const source = safeString(input.source, 40) || 'unknown';
-    const observedAt = isoTimestamp(input.observedAt) || new Date().toISOString();
-    const duration = Number(input.durationMs);
-    const limitations = [...new Set((Array.isArray(input.limitations) ? input.limitations : [])
-            .map((item) => safeString(item, MAX_OBSERVATION_LIMITATION_LENGTH))
-            .filter((item) => item !== null))]
-        .slice(0, MAX_OBSERVATION_LIMITATIONS);
-    return {
-        version: OBSERVATION_VERSION,
-        status,
-        observedAt,
-        scanMode: isScanMode(input.scanMode) ? input.scanMode : null,
-        source,
-        durationMs: Number.isFinite(duration) ? Math.max(0, Math.min(MAX_DURATION_MS, Math.round(duration))) : null,
-        complete: input.complete === true,
-        truncated: input.truncated === true,
-        limitations,
-        diagnostics: normalizeDiagnostics(input.diagnostics),
-    };
-}
-function readObservationEnvelope(value) {
-    if (value === undefined || value === null)
-        return { state: 'absent', observation: null };
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return { state: 'invalid', observation: null };
-    const record = value;
-    if (typeof record.version === 'number'
-        && Number.isInteger(record.version)
-        && record.version > OBSERVATION_VERSION) {
-        return { state: 'unsupported', observation: null };
-    }
-    if (record.version !== OBSERVATION_VERSION
-        || !isObservationStatus(record.status)
-        || !safeString(record.source, 40)
-        || !isoTimestamp(record.observedAt)) {
-        return { state: 'invalid', observation: null };
-    }
-    return { state: 'supported', observation: createObservation(record) };
-}
-export { MAX_OBSERVATION_DIAGNOSTICS, MAX_OBSERVATION_LIMITATIONS, MAX_OBSERVATION_LIMITATION_LENGTH, OBSERVATION_VERSION, createObservation, readObservationEnvelope, };