import {z} from 'zod' export type GetApiV1StoriesStoryIdArgs = {story_id: string, expand_updates?: boolean | undefined, max_updates?: number | undefined, max_articles?: number | undefined, reddit?: number | undefined, citation_method?: ('brackets' | 'urls' | 'none') | undefined, condense_auxillary_updates?: boolean | undefined}; export type GetApiV1StoriesStoryIdOptions = {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 article = 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()}); export const redditPerspective = z.object({sentiment: z.union([z.number().int(), z.number()]), relevant: z.boolean(), summary: z.string()}); export const redditComment = z.object({author: z.string(), body: z.string(), date: z.string(), upvotes: z.number().int()}); export const redditEntities = z.object({DATE: z.array(z.string()).optional(), EVENT: z.array(z.string()).optional(), GPE: z.array(z.string()).optional(), ORG: z.array(z.string()).optional(), PERSON: z.array(z.string()).optional(), NORP: z.array(z.string()).optional(), CARDINAL: z.array(z.string()).optional()}); export const redditThread = z.object({author: z.string(), author_comment_karma: z.number().int(), author_link_karma: z.number().int(), body: z.string(), classification: z.union([z.array(z.string()), z.string()]), comments: z.array(redditComment), comments_count: z.number().int(), date: z.string(), entities: redditEntities, id: z.string(), key_takeaways: z.array(z.string()).optional(), keywords: z.array(z.string()), sentiment: z.union([z.number().int(), z.number()]), subreddit_name: z.string(), subreddit_url: z.string(), summary: z.string(), title: z.string(), topic: z.string(), upvotes: z.number().int(), url: z.string(), main_speculation: z.string().optional()}); export const intraClusterStatistics = z.object({cluster_articles_pct: z.number().optional(), cluster_countries_pct: z.number().optional(), cluster_domains_pct: z.number().optional(), cluster_languages_pct: z.number().optional(), cluster_probabilities: z.record(z.string(), z.union([z.number().int(), z.number()])).optional()}); export const asknewsApiSchemaV1StoriesGraphRelationships = z.object({nodes: z.array(z.record(z.string(), z.string())), edges: z.array(z.record(z.string(), z.string()))}); export const displayImageUrl = z.object({source_id: z.string(), image_url: z.string().min(1).max(2083)}); export const storyUpdate = z.object({uuid: z.string(), cluster_articles: z.array(article), prompt_articles: z.array(article), n_articles: z.number().int(), entities: entities, headline: z.string(), story: z.string(), story_update_ts: z.number().int(), sources_urls: z.record(z.string(), z.number().int()), languages_pct: z.record(z.string(), z.number()), countries_pct: z.record(z.string(), z.number()), key_takeaways: z.array(z.string()), contradictions: z.array(z.string()), continent: z.string(), people: z.array(z.string()), locations: z.array(z.string()), new_information: z.string(), image_url: z.string().min(1).max(2083), url_safe_title: z.string(), story_uuid: z.string(), categories: z.array(z.string()), image_prompt: z.string(), reddit_perspective: redditPerspective, reddit_threads: z.array(redditThread), languages: z.record(z.string(), z.number().int()), keywords: z.array(z.string()), intra_cluster_statistics: intraClusterStatistics, silhouette_score: z.record(z.string(), z.unknown()), article_ids: z.array(z.string()), countries: z.record(z.string(), z.number().int()), markdown_citations: z.array(z.string()), confidence: z.number().optional(), provocative: z.enum(["unknown", "low", "medium", "high"]).optional(), reporting_voice: z.string().optional(), relationships: asknewsApiSchemaV1StoriesGraphRelationships, mermaid: z.string(), cc_image_url: z.string(), display_image_urls: z.array(z.union([displayImageUrl, z.string()])), alignment: z.number().int().optional()}); export const storyResponse = z.object({uuid: z.string(), categories: z.array(z.string()), countries: z.record(z.string(), z.number().int()), countries_pct: z.record(z.string(), z.number()), current_update_uuid: z.string(), requested_update_uuid: z.string(), generate_image: z.boolean(), keywords: z.array(z.string()), languages: z.record(z.string(), z.number().int()), languages_pct: z.record(z.string(), z.number()), locations: z.array(z.string()), meta_type: z.string(), n_articles: z.array(z.number().int()), n_updates: z.number().int(), people: z.array(z.string()), reddit_sentiment: z.array(z.union([z.number().int(), z.number()])), reddit_sentiment_timestamps: z.array(z.number().int()), rolling_sentiment: z.array(z.number()), sentiment: z.array(z.number().int()), sentiment_timestamps: z.array(z.number().int()), sources: z.record(z.string(), z.number().int()), sources_urls: z.record(z.string(), z.number().int()), topic: z.string(), topics: z.array(z.string()), updates: z.array(storyUpdate), updated_ts: z.number().int(), update_uuids: z.array(z.string())}); 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 }; /** * Get a story containing updates * * GET /v1/stories/{story_id} */ export const getApiV1StoriesStoryId = async (args: GetApiV1StoriesStoryIdArgs, options?: GetApiV1StoriesStoryIdOptions) => { 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.expand_updates != null) query.append("expand_updates", String(args.expand_updates)) if (args.max_updates != null) query.append("max_updates", String(args.max_updates)) if (args.max_articles != null) query.append("max_articles", String(args.max_articles)) if (args.reddit != null) query.append("reddit", String(args.reddit)) if (args.citation_method != null) query.append("citation_method", String(args.citation_method)) if (args.condense_auxillary_updates != null) query.append("condense_auxillary_updates", String(args.condense_auxillary_updates)) if (APIKey !== undefined) headers.set("Authorization", APIKey) const url = `${baseUrl.replace(/\/+$/, '')}/v1/stories/${encodeURIComponent(String(args.story_id))}${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(storyResponse, await res.json()) };