rdapify 0.3.0 → 0.3.2

package/dist/esm/application/services/QueryOrchestrator.js

@@ -0,0 +1,615 @@
+import { generateCacheKey } from '../../shared/utils/helpers';
+import { validateDomain, validateIP, validateASN, validateNameserver, validateEntityHandle, normalizeDomain, normalizeIP, normalizeASN, normalizeNameserver, normalizeEntityHandle, } from '../../shared/utils/validators';
+import { QueryAbortedError } from '../../shared/errors';
+export class QueryOrchestrator {
+    constructor(config) {
+        this.config = config;
+    }
+    async queryDomain(domain) {
+        const startTime = Date.now();
+        this.config.logger?.logRequest('domain', domain);
+        if (this.config.rateLimiter) {
+            await this.config.rateLimiter.checkLimit();
+        }
+        validateDomain(domain);
+        const normalized = normalizeDomain(domain);
+        const cacheKey = generateCacheKey('domain', normalized);
+        const baseCtx = {
+            queryType: 'domain',
+            query: domain,
+            normalized,
+            startTime,
+        };
+        if (await this.config.middleware?.runBeforeQuery(baseCtx)) {
+            throw new QueryAbortedError(baseCtx.query);
+        }
+        try {
+            const cached = await this.config.cache.get(cacheKey);
+            if (cached && cached.objectClass === 'domain') {
+                this.config.logger?.logCache('hit', cacheKey);
+                if (this.config.debugEnabled && this.config.debugLogger) {
+                    this.config.debugLogger.debug('Cache hit', {
+                        queryType: 'domain',
+                        query: normalized,
+                        cacheKey,
+                    });
+                }
+                const duration = Date.now() - startTime;
+                this.config.metricsCollector?.record({
+                    type: 'domain',
+                    query: normalized,
+                    success: true,
+                    duration,
+                    cached: true,
+                    timestamp: Date.now(),
+                });
+                await this.config.middleware?.runOnCacheHit({ ...baseCtx, cached: true });
+                this.config.logger?.logResponse('domain', normalized, true, duration);
+                const result = this.config.piiRedactor.redact(cached);
+                await this.config.middleware?.runAfterQuery({
+                    ...baseCtx,
+                    duration,
+                    result,
+                    fromCache: true,
+                });
+                return result;
+            }
+            this.config.logger?.logCache('miss', cacheKey);
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.debug('Cache miss', {
+                    queryType: 'domain',
+                    query: normalized,
+                    cacheKey,
+                });
+            }
+            await this.config.middleware?.runOnCacheMiss({ ...baseCtx, cached: false });
+            const fetchAndNormalize = async () => {
+                const serverUrl = await this.config.bootstrap.discoverDomain(normalized);
+                this.config.logger?.debug(`Discovered server: ${serverUrl}`);
+                if (this.config.debugEnabled && this.config.debugLogger) {
+                    this.config.debugLogger.debug('RDAP server discovered', {
+                        queryType: 'domain',
+                        query: normalized,
+                        serverUrl,
+                    });
+                }
+                const queryUrl = `${serverUrl}/domain/${normalized}`;
+                const raw = await this.config.fetchWithRetry(queryUrl);
+                const response = this.config.normalizer.normalize(raw, normalized, serverUrl, false, this.config.includeRaw);
+                await this.config.cache.set(cacheKey, response);
+                this.config.logger?.logCache('set', cacheKey);
+                return response;
+            };
+            const response = this.config.deduplicator
+                ? await this.config.deduplicator.deduplicate(cacheKey, fetchAndNormalize)
+                : await fetchAndNormalize();
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'domain',
+                query: normalized,
+                success: true,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+            });
+            this.config.logger?.logResponse('domain', normalized, true, duration);
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.debug('Request completed', {
+                    queryType: 'domain',
+                    query: normalized,
+                    durationMs: duration,
+                });
+            }
+            const result = this.config.piiRedactor.redact(response);
+            await this.config.middleware?.runAfterQuery({
+                ...baseCtx,
+                duration,
+                result,
+                fromCache: false,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'domain',
+                query: domain,
+                success: false,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+                error: error instanceof Error ? error.name : 'Unknown',
+            });
+            this.config.logger?.logResponse('domain', domain, false, duration, {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.error('Request failed', {
+                    queryType: 'domain',
+                    query: domain,
+                    durationMs: duration,
+                    errorMessage: error instanceof Error ? error.message : 'Unknown error',
+                    errorName: error instanceof Error ? error.name : 'Unknown',
+                });
+            }
+            await this.config.middleware?.runOnError({
+                ...baseCtx,
+                duration,
+                error: error instanceof Error ? error : new Error(String(error)),
+                fromCache: false,
+            });
+            throw error;
+        }
+    }
+    async queryIP(ip) {
+        const startTime = Date.now();
+        this.config.logger?.logRequest('ip', ip);
+        if (this.config.rateLimiter) {
+            await this.config.rateLimiter.checkLimit();
+        }
+        const version = validateIP(ip);
+        const normalized = normalizeIP(ip);
+        const cacheKey = generateCacheKey('ip', normalized);
+        const baseCtx = {
+            queryType: 'ip',
+            query: ip,
+            normalized,
+            startTime,
+        };
+        if (await this.config.middleware?.runBeforeQuery(baseCtx)) {
+            throw new QueryAbortedError(baseCtx.query);
+        }
+        try {
+            const cached = await this.config.cache.get(cacheKey);
+            if (cached && cached.objectClass === 'ip network') {
+                this.config.logger?.logCache('hit', cacheKey);
+                if (this.config.debugEnabled && this.config.debugLogger) {
+                    this.config.debugLogger.debug('Cache hit', {
+                        queryType: 'ip',
+                        query: normalized,
+                        cacheKey,
+                    });
+                }
+                const duration = Date.now() - startTime;
+                this.config.metricsCollector?.record({
+                    type: 'ip',
+                    query: normalized,
+                    success: true,
+                    duration,
+                    cached: true,
+                    timestamp: Date.now(),
+                });
+                await this.config.middleware?.runOnCacheHit({ ...baseCtx, cached: true });
+                this.config.logger?.logResponse('ip', normalized, true, duration);
+                const result = this.config.piiRedactor.redact(cached);
+                await this.config.middleware?.runAfterQuery({
+                    ...baseCtx,
+                    duration,
+                    result,
+                    fromCache: true,
+                });
+                return result;
+            }
+            this.config.logger?.logCache('miss', cacheKey);
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.debug('Cache miss', {
+                    queryType: 'ip',
+                    query: normalized,
+                    cacheKey,
+                });
+            }
+            await this.config.middleware?.runOnCacheMiss({ ...baseCtx, cached: false });
+            const fetchAndNormalize = async () => {
+                const serverUrl = version === 'v4'
+                    ? await this.config.bootstrap.discoverIPv4(normalized)
+                    : await this.config.bootstrap.discoverIPv6(normalized);
+                this.config.logger?.debug(`Discovered server: ${serverUrl}`);
+                if (this.config.debugEnabled && this.config.debugLogger) {
+                    this.config.debugLogger.debug('RDAP server discovered', {
+                        queryType: 'ip',
+                        query: normalized,
+                        serverUrl,
+                    });
+                }
+                const queryUrl = `${serverUrl}/ip/${normalized}`;
+                const raw = await this.config.fetchWithRetry(queryUrl);
+                const response = this.config.normalizer.normalize(raw, normalized, serverUrl, false, this.config.includeRaw);
+                await this.config.cache.set(cacheKey, response);
+                this.config.logger?.logCache('set', cacheKey);
+                return response;
+            };
+            const response = this.config.deduplicator
+                ? await this.config.deduplicator.deduplicate(cacheKey, fetchAndNormalize)
+                : await fetchAndNormalize();
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'ip',
+                query: normalized,
+                success: true,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+            });
+            this.config.logger?.logResponse('ip', normalized, true, duration);
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.debug('Request completed', {
+                    queryType: 'ip',
+                    query: normalized,
+                    durationMs: duration,
+                });
+            }
+            const result = this.config.piiRedactor.redact(response);
+            await this.config.middleware?.runAfterQuery({
+                ...baseCtx,
+                duration,
+                result,
+                fromCache: false,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'ip',
+                query: ip,
+                success: false,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+                error: error instanceof Error ? error.name : 'Unknown',
+            });
+            this.config.logger?.logResponse('ip', ip, false, duration, {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.error('Request failed', {
+                    queryType: 'ip',
+                    query: ip,
+                    durationMs: duration,
+                    errorMessage: error instanceof Error ? error.message : 'Unknown error',
+                    errorName: error instanceof Error ? error.name : 'Unknown',
+                });
+            }
+            await this.config.middleware?.runOnError({
+                ...baseCtx,
+                duration,
+                error: error instanceof Error ? error : new Error(String(error)),
+                fromCache: false,
+            });
+            throw error;
+        }
+    }
+    async queryASN(asn) {
+        const startTime = Date.now();
+        const asnStr = typeof asn === 'number' ? `AS${asn}` : asn;
+        this.config.logger?.logRequest('asn', asnStr);
+        if (this.config.rateLimiter) {
+            await this.config.rateLimiter.checkLimit();
+        }
+        const asnNumber = validateASN(asn);
+        const normalized = normalizeASN(asnNumber);
+        const cacheKey = generateCacheKey('asn', normalized);
+        const baseCtx = {
+            queryType: 'asn',
+            query: asnStr,
+            normalized,
+            startTime,
+        };
+        if (await this.config.middleware?.runBeforeQuery(baseCtx)) {
+            throw new QueryAbortedError(baseCtx.query);
+        }
+        try {
+            const cached = await this.config.cache.get(cacheKey);
+            if (cached && cached.objectClass === 'autnum') {
+                this.config.logger?.logCache('hit', cacheKey);
+                if (this.config.debugEnabled && this.config.debugLogger) {
+                    this.config.debugLogger.debug('Cache hit', {
+                        queryType: 'asn',
+                        query: normalized,
+                        cacheKey,
+                    });
+                }
+                const duration = Date.now() - startTime;
+                this.config.metricsCollector?.record({
+                    type: 'asn',
+                    query: normalized,
+                    success: true,
+                    duration,
+                    cached: true,
+                    timestamp: Date.now(),
+                });
+                await this.config.middleware?.runOnCacheHit({ ...baseCtx, cached: true });
+                this.config.logger?.logResponse('asn', normalized, true, duration);
+                const result = this.config.piiRedactor.redact(cached);
+                await this.config.middleware?.runAfterQuery({
+                    ...baseCtx,
+                    duration,
+                    result,
+                    fromCache: true,
+                });
+                return result;
+            }
+            this.config.logger?.logCache('miss', cacheKey);
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.debug('Cache miss', {
+                    queryType: 'asn',
+                    query: normalized,
+                    cacheKey,
+                });
+            }
+            await this.config.middleware?.runOnCacheMiss({ ...baseCtx, cached: false });
+            const fetchAndNormalize = async () => {
+                const serverUrl = await this.config.bootstrap.discoverASN(asnNumber);
+                this.config.logger?.debug(`Discovered server: ${serverUrl}`);
+                if (this.config.debugEnabled && this.config.debugLogger) {
+                    this.config.debugLogger.debug('RDAP server discovered', {
+                        queryType: 'asn',
+                        query: normalized,
+                        serverUrl,
+                    });
+                }
+                const queryUrl = `${serverUrl}/autnum/${asnNumber}`;
+                const raw = await this.config.fetchWithRetry(queryUrl);
+                const response = this.config.normalizer.normalize(raw, normalized, serverUrl, false, this.config.includeRaw);
+                await this.config.cache.set(cacheKey, response);
+                this.config.logger?.logCache('set', cacheKey);
+                return response;
+            };
+            const response = this.config.deduplicator
+                ? await this.config.deduplicator.deduplicate(cacheKey, fetchAndNormalize)
+                : await fetchAndNormalize();
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'asn',
+                query: normalized,
+                success: true,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+            });
+            this.config.logger?.logResponse('asn', normalized, true, duration);
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.debug('Request completed', {
+                    queryType: 'asn',
+                    query: normalized,
+                    durationMs: duration,
+                });
+            }
+            const result = this.config.piiRedactor.redact(response);
+            await this.config.middleware?.runAfterQuery({
+                ...baseCtx,
+                duration,
+                result,
+                fromCache: false,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'asn',
+                query: asnStr,
+                success: false,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+                error: error instanceof Error ? error.name : 'Unknown',
+            });
+            this.config.logger?.logResponse('asn', asnStr, false, duration, {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            if (this.config.debugEnabled && this.config.debugLogger) {
+                this.config.debugLogger.error('Request failed', {
+                    queryType: 'asn',
+                    query: asnStr,
+                    durationMs: duration,
+                    errorMessage: error instanceof Error ? error.message : 'Unknown error',
+                    errorName: error instanceof Error ? error.name : 'Unknown',
+                });
+            }
+            await this.config.middleware?.runOnError({
+                ...baseCtx,
+                duration,
+                error: error instanceof Error ? error : new Error(String(error)),
+                fromCache: false,
+            });
+            throw error;
+        }
+    }
+    async queryNameserver(nameserver) {
+        const startTime = Date.now();
+        this.config.logger?.logRequest('nameserver', nameserver);
+        if (this.config.rateLimiter) {
+            await this.config.rateLimiter.checkLimit();
+        }
+        validateNameserver(nameserver);
+        const normalized = normalizeNameserver(nameserver);
+        const cacheKey = generateCacheKey('nameserver', normalized);
+        const baseCtx = {
+            queryType: 'nameserver',
+            query: nameserver,
+            normalized,
+            startTime,
+        };
+        if (await this.config.middleware?.runBeforeQuery(baseCtx)) {
+            throw new QueryAbortedError(baseCtx.query);
+        }
+        try {
+            const cached = await this.config.cache.get(cacheKey);
+            if (cached && cached.objectClass === 'nameserver') {
+                this.config.logger?.logCache('hit', cacheKey);
+                const duration = Date.now() - startTime;
+                this.config.metricsCollector?.record({
+                    type: 'nameserver',
+                    query: normalized,
+                    success: true,
+                    duration,
+                    cached: true,
+                    timestamp: Date.now(),
+                });
+                await this.config.middleware?.runOnCacheHit({ ...baseCtx, cached: true });
+                this.config.logger?.logResponse('nameserver', normalized, true, duration);
+                const result = this.config.piiRedactor.redact(cached);
+                await this.config.middleware?.runAfterQuery({
+                    ...baseCtx,
+                    duration,
+                    result,
+                    fromCache: true,
+                });
+                return result;
+            }
+            this.config.logger?.logCache('miss', cacheKey);
+            await this.config.middleware?.runOnCacheMiss({ ...baseCtx, cached: false });
+            const fetchAndNormalize = async () => {
+                const serverUrl = await this.config.bootstrap.discoverNameserver(normalized);
+                this.config.logger?.debug(`Discovered server: ${serverUrl}`);
+                const queryUrl = `${serverUrl}/nameserver/${normalized}`;
+                const raw = await this.config.fetchWithRetry(queryUrl);
+                const response = this.config.normalizer.normalize(raw, normalized, serverUrl, false, this.config.includeRaw);
+                await this.config.cache.set(cacheKey, response);
+                this.config.logger?.logCache('set', cacheKey);
+                return response;
+            };
+            const response = this.config.deduplicator
+                ? await this.config.deduplicator.deduplicate(cacheKey, fetchAndNormalize)
+                : await fetchAndNormalize();
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'nameserver',
+                query: normalized,
+                success: true,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+            });
+            this.config.logger?.logResponse('nameserver', normalized, true, duration);
+            const result = this.config.piiRedactor.redact(response);
+            await this.config.middleware?.runAfterQuery({
+                ...baseCtx,
+                duration,
+                result,
+                fromCache: false,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'nameserver',
+                query: nameserver,
+                success: false,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+                error: error instanceof Error ? error.name : 'Unknown',
+            });
+            this.config.logger?.logResponse('nameserver', nameserver, false, duration, {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            await this.config.middleware?.runOnError({
+                ...baseCtx,
+                duration,
+                error: error instanceof Error ? error : new Error(String(error)),
+                fromCache: false,
+            });
+            throw error;
+        }
+    }
+    async queryEntity(handle, serverUrl) {
+        const startTime = Date.now();
+        this.config.logger?.logRequest('entity', handle);
+        if (this.config.rateLimiter) {
+            await this.config.rateLimiter.checkLimit();
+        }
+        validateEntityHandle(handle);
+        const normalized = normalizeEntityHandle(handle);
+        const cacheKey = generateCacheKey('entity', `${serverUrl}:${normalized}`);
+        const baseCtx = {
+            queryType: 'entity',
+            query: handle,
+            normalized,
+            startTime,
+        };
+        if (await this.config.middleware?.runBeforeQuery(baseCtx)) {
+            throw new QueryAbortedError(baseCtx.query);
+        }
+        try {
+            const cached = await this.config.cache.get(cacheKey);
+            if (cached && cached.objectClass === 'entity') {
+                this.config.logger?.logCache('hit', cacheKey);
+                const duration = Date.now() - startTime;
+                this.config.metricsCollector?.record({
+                    type: 'entity',
+                    query: normalized,
+                    success: true,
+                    duration,
+                    cached: true,
+                    timestamp: Date.now(),
+                });
+                await this.config.middleware?.runOnCacheHit({ ...baseCtx, cached: true });
+                this.config.logger?.logResponse('entity', normalized, true, duration);
+                const result = this.config.piiRedactor.redact(cached);
+                await this.config.middleware?.runAfterQuery({
+                    ...baseCtx,
+                    duration,
+                    result,
+                    fromCache: true,
+                });
+                return result;
+            }
+            this.config.logger?.logCache('miss', cacheKey);
+            await this.config.middleware?.runOnCacheMiss({ ...baseCtx, cached: false });
+            const fetchAndNormalize = async () => {
+                const queryUrl = `${serverUrl}/entity/${normalized}`;
+                const raw = await this.config.fetchWithRetry(queryUrl);
+                const response = this.config.normalizer.normalize(raw, normalized, serverUrl, false, this.config.includeRaw);
+                await this.config.cache.set(cacheKey, response);
+                this.config.logger?.logCache('set', cacheKey);
+                return response;
+            };
+            const response = this.config.deduplicator
+                ? await this.config.deduplicator.deduplicate(cacheKey, fetchAndNormalize)
+                : await fetchAndNormalize();
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'entity',
+                query: normalized,
+                success: true,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+            });
+            this.config.logger?.logResponse('entity', normalized, true, duration);
+            const result = this.config.piiRedactor.redact(response);
+            await this.config.middleware?.runAfterQuery({
+                ...baseCtx,
+                duration,
+                result,
+                fromCache: false,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.config.metricsCollector?.record({
+                type: 'entity',
+                query: handle,
+                success: false,
+                duration,
+                cached: false,
+                timestamp: Date.now(),
+                error: error instanceof Error ? error.name : 'Unknown',
+            });
+            this.config.logger?.logResponse('entity', handle, false, duration, {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            await this.config.middleware?.runOnError({
+                ...baseCtx,
+                duration,
+                error: error instanceof Error ? error : new Error(String(error)),
+                fromCache: false,
+            });
+            throw error;
+        }
+    }
+}