import {z} from 'zod' export type GetApiFulltextSearchArgs = {q: string, allwordsrequired: boolean, spellchecking?: string | undefined, lat?: number | undefined, lng?: number | undefined, radius?: number | undefined, suggest?: boolean | undefined, style?: ('SHORT' | 'MEDIUM' | 'LONG' | 'FULL') | undefined, country?: string | undefined, lang?: string | undefined, format?: ('XML' | 'JSON' | 'PHP' | 'RUBY' | 'PYTHON' | 'YAML' | 'ATOM' | 'GEORSS') | undefined, from?: number | undefined, to?: number | undefined, callback?: string | undefined, indent?: boolean | undefined}; export type GetApiFulltextSearchOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const houseNumberDto = z.object({location: z.string().optional(), number: z.string().optional()}); export const solrResponseDto = z.object({name: z.string().optional(), score: z.number().optional(), name_alternates: z.array(z.string()).optional(), feature_id: z.number().int().optional(), feature_class: z.string().optional(), feature_code: z.string().optional(), name_ascii: z.string().optional(), elevation: z.number().int().optional(), gtopo30: z.number().int().optional(), timezone: z.string().optional(), fully_qualified_name: z.string().optional(), placetype: z.string().optional(), population: z.number().int().optional(), lat: z.number().optional(), lng: z.number().optional(), adm1_code: z.string().optional(), adm2_code: z.string().optional(), adm3_code: z.string().optional(), adm4_code: z.string().optional(), continent: z.string().optional(), currency_code: z.string().optional(), currency_name: z.string().optional(), fips_code: z.string().optional(), isoalpha2_country_code: z.string().optional(), isoalpha3_country_code: z.string().optional(), postal_code_mask: z.string().optional(), postal_code_regex: z.string().optional(), phone_prefix: z.string().optional(), spoken_languages: z.array(z.string()).optional(), tld: z.string().optional(), capital_name: z.string().optional(), area: z.number().optional(), level: z.number().int().optional(), adm1_name: z.string().optional(), adm1_names_alternate: z.array(z.string()).optional(), adm2_name: z.string().optional(), adm2_names_alternate: z.array(z.string()).optional(), adm3_name: z.string().optional(), adm4_name: z.string().optional(), zipcodes: z.array(z.string()).optional(), country_code: z.string().optional(), country_name: z.string().optional(), country_names_alternate: z.array(z.string()).optional(), country_flag_url: z.string().optional(), google_map_url: z.string().optional(), yahoo_map_url: z.string().optional(), openstreetmap_map_url: z.string().optional(), one_way: z.boolean().optional(), length: z.number().optional(), street_type: z.string().optional(), openstreetmap_id: z.number().int().optional(), is_in: z.string().optional(), is_in_place: z.string().optional(), is_in_adm: z.string().optional(), is_in_zip: z.array(z.string()).optional(), fully_qualified_address: z.string().optional(), house_numbers: z.array(houseNumberDto).optional(), municipality: z.boolean().optional(), amenity: z.string().optional()}); export const fulltextResultsDto = z.object({message: z.string().optional(), numFound: z.number().int().optional(), QTime: z.number().int().optional(), resultsSize: z.number().int().optional(), maxScore: z.number().optional(), result: z.array(solrResponseDto).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 places by text around a GPS point * * GET /fulltext/search */ export const getApiFulltextSearch = async (args: GetApiFulltextSearchArgs, options?: GetApiFulltextSearchOptions) => { const {baseUrl = "http://free.gisgraphy.com", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.q != null) query.append("q", String(args.q)) if (args.allwordsrequired != null) query.append("allwordsrequired", String(args.allwordsrequired)) if (args.spellchecking != null) query.append("spellchecking", String(args.spellchecking)) if (args.lat != null) query.append("lat", String(args.lat)) if (args.lng != null) query.append("lng", String(args.lng)) if (args.radius != null) query.append("radius", String(args.radius)) if (args.suggest != null) query.append("suggest", String(args.suggest)) if (args.style != null) query.append("style", String(args.style)) if (args.country != null) query.append("country", String(args.country)) if (args.lang != null) query.append("lang", String(args.lang)) if (args.format != null) query.append("format", String(args.format)) if (args.from != null) query.append("from", String(args.from)) if (args.to != null) query.append("to", String(args.to)) if (args.callback != null) query.append("callback", String(args.callback)) if (args.indent != null) query.append("indent", String(args.indent)) if (apiKey !== undefined) query.set("api_key", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/fulltext/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(fulltextResultsDto, await res.json()) };