import {z} from 'zod' export type ISO3 = string; export type Language = 'en' | 'fr' | 'es' | 'pt' | 'de' | 'it' | 'ja' | 'ko' | 'zh' | 'ru' | 'ar' | 'hi' | 'th' | 'vi' | 'tl'; export type GetApiApiV1VisaArgs = {passport: ISO3, destination: ISO3, lang?: Language | undefined, Accept?: ('application/json' | 'text/markdown') | undefined}; export type GetApiApiV1VisaOptions = {baseUrl?: string | undefined, apiKeyHeader?: string | undefined, fetch?: typeof fetch | undefined}; export const iSO3 = z.string().min(3).max(3); export const visaRequirement = z.enum(["visa_free", "visa_required", "e_visa", "visa_on_arrival", "eta", "no_admission"]); export const countryInfo = z.object({currency: z.string().optional(), language: z.string().optional(), timezone: z.string().optional(), capital: z.string().optional()}); export const transitHub = z.object({airport: z.string().optional(), city: z.string().optional(), transit_visa_required: z.boolean().optional(), transit_free_hours: z.number().int().optional(), conditions: z.string().optional()}); export const transitVisa = z.object({hubs: z.array(transitHub).optional()}); export const moneyAmount = z.object({amount: z.number().optional(), currency: z.string().optional()}); export const visaFee = z.object({single_entry: moneyAmount.optional(), multiple_entry: moneyAmount.optional()}); export const processingDays = z.object({standard: z.number().int().nullable().optional(), express: z.number().int().nullable().optional(), rush: z.number().int().nullable().optional()}); export const photoSpecs = z.object({width_mm: z.number().optional(), height_mm: z.number().optional(), background: z.string().optional(), glasses_allowed: z.boolean().optional(), head_covering_allowed: z.string().optional()}); export const insuranceRequired = z.object({required: z.boolean().optional(), min_coverage: z.number().optional(), currency: z.string().optional()}); export const minorRules = z.object({solo_travel_min_age: z.number().int().optional(), single_parent_letter_required: z.boolean().optional(), notarized_consent_required: z.boolean().optional()}); export const overstayPenalty = z.object({fine_per_day: z.string().optional(), ban_days: z.number().int().optional(), criminal: z.boolean().optional(), details: z.string().optional()}); export const entryByMode = z.object({air: z.number().int().optional(), land: z.number().int().optional(), sea: z.number().int().optional()}); export const remoteWorkVisa = z.object({available: z.boolean().optional(), duration_months: z.number().int().optional(), fee: moneyAmount.optional(), requirements: z.array(z.string()).optional()}); export const extensionRules = z.object({possible: z.boolean().optional(), max_days: z.number().int().optional(), fee: z.string().optional(), where: z.string().optional(), notes: z.string().optional()}); export const reciprocityChange = z.object({date: z.string().optional(), from: z.string().optional(), to: z.string().optional(), note: z.string().optional()}); export const safetyInfo = z.object({level: z.number().int().gte(1).lte(4).optional(), advisory: z.string().optional(), source: z.string().optional(), updated_at: z.string().optional()}); export const healthRequirements = z.object({covid_test: z.boolean().optional(), vaccination_proof: z.boolean().optional(), health_declaration: z.boolean().optional(), quarantine_days: z.number().int().optional(), ebola_screening: z.boolean().optional()}); export const embassyInfo = z.object({name: z.string().optional(), address: z.string().optional(), city: z.string().optional(), phone: z.string().optional(), emergency_phone: z.string().optional(), email: z.string().optional(), website: z.string().optional()}); export const embassyData = z.object({your_embassy_at_destination: embassyInfo.optional(), visa_application_embassy: embassyInfo.optional()}); export const visaData = z.object({passport: iSO3, destination: iSO3, requirement: visaRequirement, visa_free_days: z.number().int().nullable().optional(), visa_required: z.boolean(), description: z.string(), documents_required: z.array(z.string()).optional(), process: z.array(z.string()).optional(), tips: z.array(z.string()).optional(), country_info: countryInfo, verified: z.boolean(), source: z.string().nullable().optional(), requirement_status: z.literal("uncertain").optional(), requirement_status_note: z.string().nullable().optional(), source_url: z.string().nullable().optional(), last_verified_at: z.string().nullable().optional(), transit_visa: transitVisa.optional(), passport_validity_months: z.number().int().optional(), visa_fee: visaFee.optional(), processing_days: processingDays.optional(), photo_specs: photoSpecs.optional(), vaccinations_required: z.array(z.string()).optional(), insurance_required: insuranceRequired.optional(), dual_nationality_warnings: z.array(z.string()).optional(), stamp_warnings: z.array(z.string()).optional(), minor_rules: minorRules.optional(), overstay_penalty: overstayPenalty.optional(), entry_by_mode: entryByMode.optional(), remote_work_visa: remoteWorkVisa.optional(), extension_rules: extensionRules.optional(), reciprocity_history: z.array(reciprocityChange).optional(), safety: safetyInfo.optional(), best_apply_period: z.string().nullable().optional(), health_requirements: healthRequirements.optional(), embassy: embassyData.optional()}); export const language = z.enum(["en", "fr", "es", "pt", "de", "it", "ja", "ko", "zh", "ru", "ar", "hi", "th", "vi", "tl"]); export const visaMeta = z.object({lang: language.optional(), api_version: z.string().optional(), coverage: z.string().optional(), languages: z.number().int().optional(), quota: z.object({used: z.number().int().optional(), limit: z.number().int().optional(), remaining: z.number().int().optional(), resets_at: z.string().optional()}).optional(), warning: z.string().optional()}); export const visaResponse = z.object({data: visaData, meta: visaMeta}); 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 }; /** * Full visa intelligence * * GET /api/v1/visa * * Also accepts auth: apiKeyQuery */ export const getApiApiV1Visa = async (args: GetApiApiV1VisaArgs, options?: GetApiApiV1VisaOptions) => { const {baseUrl = "https://visa.orizn.app", fetch: fetchFn = fetch, apiKeyHeader} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.passport != null) query.append("passport", String(args.passport)) if (args.destination != null) query.append("destination", String(args.destination)) if (args.lang != null) query.append("lang", String(args.lang)) if (args.Accept != null) headers.set("Accept", String(args.Accept)) if (apiKeyHeader !== undefined) headers.set("x-api-key", apiKeyHeader) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/visa${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(visaResponse, await res.json()) };