import {z} from 'zod' export type GetApiKybInfoOptions = {baseUrl?: string | undefined, kybTokenAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const kybLocaleEnum = z.enum(["en", "es", "fr", "ru", "de", "it", "pl", "lt", "lv", "et", "cs", "ro", "hu", "ja", "bg", "nl", "pt"]); export const themeColor = z.object({primary: z.string().max(25).nullable().optional(), secondary: z.string().max(25).nullable().optional(), primaryBackground: z.string().max(25).nullable().optional(), secondaryBackground: z.string().max(25).nullable().optional(), hoveredButton: z.string().max(25).nullable().optional(), disabledIconButton: z.string().max(25).nullable().optional(), disabledButtonTypography: z.string().max(25).nullable().optional(), disabledButton: z.string().max(25).nullable().optional(), typography: z.string().max(25).nullable().optional(), success: z.string().max(25).nullable().optional(), successBackground: z.string().max(25).nullable().optional(), error: z.string().max(25).nullable().optional(), errorBackground: z.string().max(25).nullable().optional(), warning: z.string().max(25).nullable().optional(), warningBackground: z.string().max(25).nullable().optional(), info: z.string().max(25).nullable().optional(), infoBackground: z.string().max(25).nullable().optional(), border: z.string().max(25).nullable().optional()}); export const themeCore = z.object({companyName: z.string().max(32).nullable().optional(), logo: z.string().nullable().optional(), font: z.string().nullable().optional(), colors: themeColor.optional(), supportEmail: z.string().max(100).nullable().optional()}); export const companyFieldEnum = z.enum(["COMPANY_NAME", "REGISTRATION_NUMBER", "COUNTRY", "REGION", "TYPE", "PHONE", "WEBSITE", "EMAIL", "BRAND_NAMES", "ACTIVITY_CODE", "TIN", "OPERATING_ADDRESS", "POSTAL_ADDRESS", "POSTCODE", "STREET", "CITY"]); export const companyFieldUnified = z.object({required: z.boolean().optional(), field: companyFieldEnum, order: z.number().int().gte(0).nullable().optional(), readOnly: z.boolean().optional(), changeFrom: z.unknown(), changeRequired: z.boolean().optional()}); export const customFieldTypeEnum = z.enum(["CHECKBOX", "COUNTRY", "COUNTRY_MULTI", "DATE", "INTEGER", "SELECT", "SELECT_MULTI", "TEXT"]); export const choice = z.object({key: z.string().max(32), title: z.string().max(512)}); export const customField = z.object({id: z.string(), key: z.string().max(32), title: z.string().max(64), description: z.string().max(512).nullable().optional(), type: customFieldTypeEnum, choices: z.array(choice).optional()}); export const customFieldAssignmentUnified = z.object({field: customField, required: z.boolean().optional(), order: z.number().int().gte(0).lte(4294967295).nullable().optional(), readOnly: z.boolean().optional(), changeFrom: z.unknown(), changeRequired: z.boolean().optional()}); export const companyDocType = z.object({description: z.string().max(512).nullable().optional(), required: z.boolean().optional(), docType: z.string().max(100)}); export const beneficiaryTypeEnum = z.enum(["CEO", "REPRESENTATIVE", "SHAREHOLDER", "UBO", "ABO"]); export const beneficiaryFieldEnum = z.literal("OWNERSHIP_PERCENTAGE"); export const beneficiaryField = z.object({required: z.boolean().optional(), field: beneficiaryFieldEnum}); export const applicantTypeEnum = z.enum(["INDIVIDUAL", "COMPANY"]); export const customFieldAssignment = z.object({field: customField, required: z.boolean().optional(), order: z.number().int().gte(0).lte(4294967295).nullable().optional()}); export const individualFieldEnum = z.enum(["NAME", "SURNAME", "COUNTRY", "EMAIL", "PHONE", "DATE_OF_BIRTH", "NATIONALITY", "DOCUMENT_NUMBER", "PERSONAL_NUMBER", "CITIZENSHIP", "COUNTRY_OF_BIRTH", "RESIDENTIAL_ADDRESS", "COUNTRY_OF_RESIDENCE", "POSTCODE", "ADDRESS", "STREET", "CITY", "TIN", "TAX_RESIDENCE", "SELF_DECLARED_PEP", "POSITIONS"]); export const individualField = z.object({required: z.boolean().optional(), field: individualFieldEnum, order: z.number().int().gte(0).nullable().optional()}); export const individualDocType = z.object({description: z.string().max(512).nullable().optional(), required: z.boolean().optional(), docType: z.string().max(100)}); export const individualFlow = z.object({required: z.boolean().optional(), applicantType: applicantTypeEnum, fieldsCustom: z.array(customFieldAssignment).nullable().optional(), fields: z.array(individualField), documents: z.array(individualDocType).nullable().optional()}); export const companyField = z.object({required: z.boolean().optional(), field: companyFieldEnum, order: z.number().int().gte(0).nullable().optional()}); export const companyFlow = z.object({required: z.boolean().optional(), applicantType: applicantTypeEnum, fieldsCustom: z.array(customFieldAssignment).nullable().optional(), fields: z.array(companyField), documents: z.array(companyDocType).nullable().optional()}); export const applicantFlow = z.discriminatedUnion("applicantType", [individualFlow, companyFlow]); export const beneficiaryUnifiedFlow = z.object({beneficiaryType: beneficiaryTypeEnum, required: z.boolean().optional(), fields: z.array(beneficiaryField).nullable().optional(), applicants: z.array(applicantFlow), description: z.string().max(512).optional(), readOnly: z.boolean().optional()}); export const kybFormUnifiedFlow = z.object({fields: z.array(companyFieldUnified).nullable().optional(), fieldsCustom: z.array(customFieldAssignmentUnified).nullable().optional(), documents: z.array(companyDocType).nullable().optional(), beneficiaries: z.array(beneficiaryUnifiedFlow).nullable().optional(), companySearch: z.boolean().nullable().optional(), bankVerification: z.boolean().nullable().optional(), emailVerification: z.boolean().nullable().optional(), ownershipFullStructure: z.boolean().optional(), ownershipPercentageThreshold: z.number().gte(0).lte(100).nullable().optional(), description: z.string().max(512).nullable().optional(), questionnaireDescription: z.string().max(512).nullable().optional()}); export const kybInfo = z.object({locale: kybLocaleEnum.nullable(), theme: themeCore.nullable(), flow: kybFormUnifiedFlow.nullable()}); 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 }; /** * Retrieve KYB session info * * GET /kyb/info/ */ export const getApiKybInfo = async (options?: GetApiKybInfoOptions) => { const {baseUrl = "https://ivs.idenfy.com", fetch: fetchFn = fetch, kybTokenAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (kybTokenAuth !== undefined) headers.set('authorization', `Bearer ${kybTokenAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/kyb/info/${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(kybInfo, await res.json()) };