import {z} from 'zod' export type IdentifierString = string; export type TimestampFilter = number | string; export type EscalationTypeEnum = 'blocked' | 'google_safe'; export type BooleanOptInFlag = boolean; export type BasicString = string; export type GetApiV1IrisDetectDomainsWatchedArgs = {app_name?: IdentifierString | undefined, app_partner?: IdentifierString | undefined, app_version?: IdentifierString | undefined, changed_since?: TimestampFilter | undefined, discovered_before?: TimestampFilter | undefined, discovered_since?: TimestampFilter | undefined, escalated_since?: TimestampFilter | undefined, 'escalation_types[]'?: EscalationTypeEnum | undefined, include_domain_data?: BooleanOptInFlag | undefined, search?: BasicString | undefined, limit?: number | undefined, monitor_id?: string | undefined, mx_exists?: boolean | undefined, offset?: number | undefined, order?: ('asc' | 'desc') | undefined, preview?: BooleanOptInFlag | undefined, 'risk_score_ranges[]'?: (Array<'0-0' | '1-39' | '40-69' | '70-99' | '100-100'>) | undefined, 'sort[]'?: (Array<'discovered_date' | 'changed_date' | 'risk_score'>) | undefined, 'tlds[]'?: Array | undefined}; export type GetApiV1IrisDetectDomainsWatchedOptions = {baseUrl?: string | undefined, headerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const detectThreatProfile = z.object({phishing: z.number().int().optional(), malware: z.number().int().optional(), spam: z.number().int().optional()}); export const detectRiskComponents = z.object({proximity: z.number().int().optional(), threat_profile: z.union([detectThreatProfile, z.array(z.unknown())]).optional()}); export const escalationTypeEnum = z.enum(["blocked", "google_safe"]); export const detectEscalation = z.object({escalation_type: escalationTypeEnum.optional(), id: z.string().optional(), created: z.string().optional(), created_by: z.string().optional()}); export const detectDomain = z.object({state: z.string().optional(), domain: z.string().optional(), status: z.enum(["active", "inactive"]).optional(), discovered_date: z.string().optional(), changed_date: z.string().optional(), risk_score: z.number().int().nullable().optional(), risk_score_status: z.string().nullable().optional(), risk_score_components: detectRiskComponents.optional(), mx_exists: z.boolean().optional(), tld: z.string().optional(), id: z.string().optional(), escalations: z.array(detectEscalation).optional(), monitor_ids: z.array(z.string()).optional(), name_server: z.array(z.object({host: z.string().optional()})).optional(), registrant_contact_email: z.array(z.string()).optional(), registrar: z.string().optional(), create_date: z.number().int().optional(), ip: z.array(z.object({country_code: z.string().optional(), ip: z.string().optional(), isp: z.string().optional()})).optional(), mx: z.array(z.object({host: z.string().optional()})).optional()}); export const detectDomainList = z.object({watchlist_domains: z.array(detectDomain).optional(), total_count: z.number().int().optional(), count: z.number().int().optional(), offset: z.number().int().optional(), limit: z.number().int().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Provide recently changed or escalated domains for active monitors in an account. * * GET /v1/iris-detect/domains/watched/ * * Also accepts auth: open_key_auth, hmac_auth */ export const getApiV1IrisDetectDomainsWatched = async (args: GetApiV1IrisDetectDomainsWatchedArgs, options?: GetApiV1IrisDetectDomainsWatchedOptions) => { const {baseUrl = "https://api.domaintools.com", fetch: fetchFn = fetch, headerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.app_name != null) query.append("app_name", String(args.app_name)) if (args.app_partner != null) query.append("app_partner", String(args.app_partner)) if (args.app_version != null) query.append("app_version", String(args.app_version)) if (args.changed_since != null) query.append("changed_since", String(args.changed_since)) if (args.discovered_before != null) query.append("discovered_before", String(args.discovered_before)) if (args.discovered_since != null) query.append("discovered_since", String(args.discovered_since)) if (args.escalated_since != null) query.append("escalated_since", String(args.escalated_since)) if (args['escalation_types[]'] != null) query.append("escalation_types[]", String(args['escalation_types[]'])) if (args.include_domain_data != null) query.append("include_domain_data", String(args.include_domain_data)) if (args.search != null) query.append("search", String(args.search)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.monitor_id != null) query.append("monitor_id", String(args.monitor_id)) if (args.mx_exists != null) query.append("mx_exists", String(args.mx_exists)) if (args.offset != null) query.append("offset", String(args.offset)) if (args.order != null) query.append("order", String(args.order)) if (args.preview != null) query.append("preview", String(args.preview)) for (const item of args['risk_score_ranges[]'] ?? []) query.append("risk_score_ranges[]", String(item)) for (const item of args['sort[]'] ?? []) query.append("sort[]", String(item)) for (const item of args['tlds[]'] ?? []) query.append("tlds[]", String(item)) if (headerAuth !== undefined) headers.set("X-Api-Key", headerAuth) const url = `${baseUrl.replace(/\/+$/, '')}/v1/iris-detect/domains/watched/${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(detectDomainList, await res.json()) };