import {z} from 'zod' export type GetApiV1NewsSearchArgs = {query?: string | undefined, n_articles?: number | undefined, start_timestamp?: (number | null) | undefined, end_timestamp?: (number | null) | undefined, time_filter?: ('crawl_date' | 'pub_date') | undefined, return_type?: ('string' | 'dicts' | 'both') | undefined, historical?: boolean | undefined, method?: ('nl' | 'kw' | 'both') | undefined, similarity_score_threshold?: number | undefined, offset?: (number | string) | undefined, categories?: (Array<'All' | 'Business' | 'Economy' | 'Crime' | 'Politics' | 'Science' | 'Sports' | 'Technology' | 'Military' | 'Health' | 'Entertainment' | 'Finance' | 'Culture' | 'Climate' | 'Environment' | 'World'>) | undefined, doc_start_delimiter?: string | undefined, doc_end_delimiter?: string | undefined, provocative?: ('unknown' | 'low' | 'medium' | 'high' | 'all') | undefined, reporting_voice?: (Array<'Objective' | 'Subjective' | 'Investigative' | 'Narrative' | 'Analytical' | 'Advocacy' | 'Conversational' | 'Satirical' | 'Emotive' | 'Explanatory' | 'Persuasive' | 'Sensational' | 'Unknown' | 'all'> | 'Objective' | 'Subjective' | 'Investigative' | 'Narrative' | 'Analytical' | 'Advocacy' | 'Conversational' | 'Satirical' | 'Emotive' | 'Explanatory' | 'Persuasive' | 'Sensational' | 'Unknown' | 'all') | undefined, domain_url?: (Array | string | null) | undefined, bad_domain_url?: (Array | string | null) | undefined, podcasts?: ('include' | 'only' | 'none') | undefined, page_rank?: (number | null) | undefined, diversify_sources?: boolean | undefined, strategy?: ('latest news' | 'news knowledge' | 'default') | undefined, hours_back?: number | undefined, string_guarantee?: (Array | null) | undefined, string_guarantee_op?: ('AND' | 'OR') | undefined, reverse_string_guarantee?: (Array | null) | undefined, entity_guarantee?: (Array | null) | undefined, reverse_entity_guarantee?: (Array | null) | undefined, entity_guarantee_op?: ('AND' | 'OR') | undefined, return_graphs?: boolean | undefined, return_geo?: boolean | undefined, languages?: (Array<'sq' | 'ar' | 'az' | 'ca' | 'zh' | 'hr' | 'cs' | 'da' | 'nl' | 'en' | 'eo' | 'fi' | 'fr' | 'gl' | 'de' | 'el' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ia' | 'it' | 'ja' | 'kk' | 'km' | 'ko' | 'ky' | 'ms' | 'mt' | 'mhr' | 'mn' | 'no' | 'or' | 'pl' | 'pt' | 'pa' | 'ro' | 'ru' | 'sr' | 'sk' | 'sl' | 'es' | 'sv' | 'ta' | 'te' | 'th' | 'tr' | 'uk' | 'vi' | 'unknown'> | null) | undefined, countries?: (Array | null) | undefined, countries_blacklist?: (Array | null) | undefined, continents?: (Array<'Africa' | 'Asia' | 'Oceania' | 'Europe' | 'Middle East' | 'North America' | 'South America'> | null) | undefined, sentiment?: ('negative' | 'neutral' | 'positive' | null) | undefined, premium?: boolean | undefined, authors?: (Array | null) | undefined, try_cache?: ('1h' | '6h' | '12h' | '24h' | '3d' | '7d' | null) | undefined, geo_lat?: (number | null) | undefined, geo_lon?: (number | null) | undefined, geo_radius?: (number | null) | undefined, geo_polygon?: (string | null) | undefined}; export type GetApiV1NewsSearchOptions = {baseUrl?: string | undefined, APIKey?: string | undefined, fetch?: typeof fetch | undefined}; export const entities = z.object({Person: z.array(z.string()).optional(), Organization: z.array(z.string()).optional(), Location: z.array(z.string()).optional(), Nationality: z.array(z.string()).optional(), Date: z.array(z.string()).optional(), Event: z.array(z.string()).optional(), Money: z.array(z.string()).optional(), Law: z.array(z.string()).optional(), Quantity: z.array(z.string()).optional(), Time: z.array(z.string()).optional(), Sports: z.array(z.string()).optional(), Politics: z.array(z.string()).optional(), Title: z.array(z.string()).optional(), Number: z.array(z.string()).optional(), Arms: z.array(z.string()).optional(), Product: z.array(z.string()).optional(), Media: z.array(z.string()).optional(), Transportation: z.array(z.string()).optional(), Religion: z.array(z.string()).optional(), Technology: z.array(z.string()).optional(), Space: z.array(z.string()).optional(), Medicine: z.array(z.string()).optional(), Language: z.array(z.string()).optional(), Science: z.array(z.string()).optional()}); export const asknewsApiSchemaV1CommonGraphRelationships = z.object({nodes: z.array(z.record(z.string(), z.string())).optional(), edges: z.array(z.record(z.string(), z.string())).optional()}); export const geoCoordinate = z.object({latitude: z.number(), longitude: z.number(), metadata: z.record(z.string(), z.unknown())}); export const assets = z.object({images: z.array(z.string()).nullable().optional(), videos: z.array(z.string()).nullable().optional()}); export const author = z.object({email: z.string().nullable().optional(), name: z.string().nullable().optional(), url: z.string().nullable().optional()}); export const wikidataEntity = z.object({title: z.string(), qid: z.string(), relevance: z.number(), description: z.string().nullable().optional(), source_mention: z.string().nullable().optional(), source_mentions: z.array(z.string()).nullable().optional()}); export const searchResponseDictItem = z.object({article_url: z.string().min(1).max(2083), article_id: z.string(), classification: z.union([z.array(z.string()), z.string()]), country: z.string(), source_id: z.string(), page_rank: z.number().int(), domain_url: z.string(), eng_title: z.string(), entities: entities, image_url: z.string().nullable().optional(), keywords: z.array(z.string()), language: z.string(), pub_date: z.string(), summary: z.string(), key_points: z.array(z.string()).nullable().optional(), title: z.string(), sentiment: z.number().int(), centroid_distance: z.number().nullable().optional(), cluster_probability: z.number().nullable().optional(), markdown_citation: z.string().optional(), provocative: z.enum(["unknown", "low", "medium", "high"]).optional(), reporting_voice: z.union([z.enum(["Objective", "Subjective", "Investigative", "Narrative", "Analytical", "Advocacy", "Conversational", "Satirical", "Emotive", "Explanatory", "UnknownPersuasive", "Sensational"]), z.string()]).optional(), entity_relation_graph: asknewsApiSchemaV1CommonGraphRelationships.nullable().optional(), geo_coordinates: z.record(z.string(), geoCoordinate).nullable().optional(), continent: z.enum(["Africa", "Asia", "Europe", "Middle East", "North America", "South America", "Oceania"]).nullable().optional(), assets: assets.nullable().optional(), social_embeds: z.array(z.string()).nullable().optional(), bias: z.enum(["Political", "Gender", "Cultural", "Age", "Religious", "Statement", "Illogical Claims", "Slant", "Source Selection", "Omission of Source Attribution", "Spin", "Sensationalism", "Negativity", "Subjective Adjectives", "Ad Hominem", "Mind Reading", "Opinion-as-Fact", "None", "Unknown"]).nullable().optional(), authors: z.array(author).nullable().optional(), wikidata_entities: z.record(z.string(), z.array(wikidataEntity)).nullable().optional(), full_text: z.string().nullable().optional(), original_language_summary: z.string().nullable().optional(), image_description: z.string().nullable().optional(), crawl_date: z.string().nullable().optional(), content_type: z.enum(["news", "opinion", "analysis", "review", "listicle", "guide", "interview", "profile", "forum", "liveblog", "fact-check", "press_release", "obituary", "data_journalism"]).nullable().optional(), as_string_key: z.string()}); export const usage = z.object({credits: z.number().int()}); export const searchResponse = z.object({as_dicts: z.array(searchResponseDictItem).nullable().optional(), as_string: z.string().nullable().optional(), offset: z.union([z.number().int(), z.string()]).nullable().optional(), usage: usage.nullable().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 }; /** * Search for enriched real-time news context * * GET /v1/news/search */ export const getApiV1NewsSearch = async (args: GetApiV1NewsSearchArgs, options?: GetApiV1NewsSearchOptions) => { const {baseUrl = "https://api.asknews.app", fetch: fetchFn = fetch, APIKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.query != null) query.append("query", String(args.query)) if (args.n_articles != null) query.append("n_articles", String(args.n_articles)) if (args.start_timestamp != null) query.append("start_timestamp", String(args.start_timestamp)) if (args.end_timestamp != null) query.append("end_timestamp", String(args.end_timestamp)) if (args.time_filter != null) query.append("time_filter", String(args.time_filter)) if (args.return_type != null) query.append("return_type", String(args.return_type)) if (args.historical != null) query.append("historical", String(args.historical)) if (args.method != null) query.append("method", String(args.method)) if (args.similarity_score_threshold != null) query.append("similarity_score_threshold", String(args.similarity_score_threshold)) if (args.offset != null) query.append("offset", String(args.offset)) for (const item of args.categories ?? []) query.append("categories", String(item)) if (args.doc_start_delimiter != null) query.append("doc_start_delimiter", String(args.doc_start_delimiter)) if (args.doc_end_delimiter != null) query.append("doc_end_delimiter", String(args.doc_end_delimiter)) if (args.provocative != null) query.append("provocative", String(args.provocative)) if (args.reporting_voice != null) query.append("reporting_voice", String(args.reporting_voice)) if (args.domain_url != null) query.append("domain_url", String(args.domain_url)) if (args.bad_domain_url != null) query.append("bad_domain_url", String(args.bad_domain_url)) if (args.podcasts != null) query.append("podcasts", String(args.podcasts)) if (args.page_rank != null) query.append("page_rank", String(args.page_rank)) if (args.diversify_sources != null) query.append("diversify_sources", String(args.diversify_sources)) if (args.strategy != null) query.append("strategy", String(args.strategy)) if (args.hours_back != null) query.append("hours_back", String(args.hours_back)) for (const item of args.string_guarantee ?? []) query.append("string_guarantee", String(item)) if (args.string_guarantee_op != null) query.append("string_guarantee_op", String(args.string_guarantee_op)) for (const item of args.reverse_string_guarantee ?? []) query.append("reverse_string_guarantee", String(item)) for (const item of args.entity_guarantee ?? []) query.append("entity_guarantee", String(item)) for (const item of args.reverse_entity_guarantee ?? []) query.append("reverse_entity_guarantee", String(item)) if (args.entity_guarantee_op != null) query.append("entity_guarantee_op", String(args.entity_guarantee_op)) if (args.return_graphs != null) query.append("return_graphs", String(args.return_graphs)) if (args.return_geo != null) query.append("return_geo", String(args.return_geo)) for (const item of args.languages ?? []) query.append("languages", String(item)) for (const item of args.countries ?? []) query.append("countries", String(item)) for (const item of args.countries_blacklist ?? []) query.append("countries_blacklist", String(item)) for (const item of args.continents ?? []) query.append("continents", String(item)) if (args.sentiment != null) query.append("sentiment", String(args.sentiment)) if (args.premium != null) query.append("premium", String(args.premium)) for (const item of args.authors ?? []) query.append("authors", String(item)) if (args.try_cache != null) query.append("try_cache", String(args.try_cache)) if (args.geo_lat != null) query.append("geo_lat", String(args.geo_lat)) if (args.geo_lon != null) query.append("geo_lon", String(args.geo_lon)) if (args.geo_radius != null) query.append("geo_radius", String(args.geo_radius)) if (args.geo_polygon != null) query.append("geo_polygon", String(args.geo_polygon)) if (APIKey !== undefined) headers.set("Authorization", APIKey) const url = `${baseUrl.replace(/\/+$/, '')}/v1/news/search${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(searchResponse, await res.json()) };