import {z} from 'zod' export type PersonInput = {person_id?: (number | null) | undefined, linkedin_url?: (string | null) | undefined, email?: (string | null) | undefined}; export type Query = {query: string}; export type PeopleFilter = {organization_ids?: (Array | null) | undefined, organization_list_id?: (number | null) | undefined, query?: (Query | null) | undefined}; export type RelatedPeopleSelection = {direction: Array<'managers' | 'direct_reports'>, attributes?: (Array<'name' | 'email' | 'phone' | 'linkedin_url' | 'job_title' | 'job_function' | 'job_level' | 'location' | 'country' | 'current_employer' | 'technologies' | 'person_score' | 'confidence'> | 'all') | undefined}; export type PeopleSelect = {attributes?: (Array<'name' | 'email' | 'phone' | 'linkedin_url' | 'job_title' | 'job_function' | 'job_level' | 'location' | 'country' | 'current_employer' | 'technologies' | 'person_score' | 'confidence'> | 'all') | undefined, related_people?: (RelatedPeopleSelection | null) | undefined}; export type EnrichPeopleRequest = {people?: (Array | null) | undefined, filter?: (PeopleFilter | null) | undefined, select?: PeopleSelect | undefined, limit?: number | undefined, offset?: number | undefined, order_by_column?: ('person_score' | 'start_date' | 'job_level' | null) | undefined, order_by_direction?: ('ASC' | 'DESC' | null) | undefined, request_id?: (string | null) | undefined}; export type CreateApiV9PeopleArgs = {body: EnrichPeopleRequest}; export type CreateApiV9PeopleOptions = {baseUrl?: string | undefined, apiToken?: string | undefined, fetch?: typeof fetch | undefined}; export const personInput = z.object({person_id: z.number().int().gte(1).nullable().optional(), linkedin_url: z.string().nullable().optional(), email: z.string().nullable().optional()}); export const currentEmployer = z.object({organization_id: z.number().int(), name: z.string().nullable().optional(), start_date: z.string().nullable().optional(), sumble_url: z.string().min(1).max(2083).nullable().optional()}); export const personTechnology = z.object({name: z.string(), slug: z.string()}); export const personScoreFeature = z.object({name: z.string(), slug: z.string(), match_type: z.enum(["technology", "job_function"]), contribution: z.number()}); export const personScore = z.object({value: z.number(), skill_contribution: z.number(), job_function_contribution: z.number(), seniority_contribution: z.number(), matched_features: z.array(personScoreFeature)}); export const personAttributes = z.object({name: z.string().nullable().optional(), email: z.string().nullable().optional(), phone: z.string().nullable().optional(), linkedin_url: z.string().min(1).max(2083).nullable().optional(), job_title: z.string().nullable().optional(), job_function: z.string().nullable().optional(), job_level: z.string().nullable().optional(), location: z.string().nullable().optional(), country: z.string().nullable().optional(), current_employer: currentEmployer.nullable().optional(), technologies: z.array(personTechnology).nullable().optional(), person_score: personScore.nullable().optional()}); export const relatedPersonConfidenceFeature = z.object({match_type: z.enum(["technology", "job_function", "team", "location", "title_similarity"]), name: z.string(), slug: z.string().nullable().optional(), contribution: z.number()}); export const relatedPersonConfidence = z.object({score: z.number(), technology_contribution: z.number(), job_function_contribution: z.number(), team_contribution: z.number(), location_contribution: z.number(), title_similarity_contribution: z.number(), matched_features: z.array(relatedPersonConfidenceFeature)}); export const relatedPersonRow = z.object({person_id: z.number().int(), sumble_url: z.string().min(1).max(2083), confidence: relatedPersonConfidence.nullable().optional(), attributes: personAttributes.nullable().optional()}); export const relatedPeopleResult = z.object({managers: z.array(relatedPersonRow).nullable().optional(), direct_reports: z.array(relatedPersonRow).nullable().optional()}); export const personRow = z.object({input: personInput.nullable().optional(), person_id: z.number().int().nullable().optional(), sumble_url: z.string().min(1).max(2083).nullable().optional(), attributes: personAttributes.nullable().optional(), related_people: relatedPeopleResult.nullable().optional()}); export const enrichPeopleResponse = z.object({id: z.string(), credits_used: z.number().int(), credits_remaining: z.number().int(), request_id: z.string().nullable().optional(), status: z.string().nullable().optional(), people: z.array(personRow).nullable().optional(), matched_count: z.number().int().nullable().optional(), total: z.number().int().nullable().optional(), source_data_url: z.string().min(1).max(2083).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 }; /** * Unified people endpoint * * POST /v9/people */ export const createApiV9People = async (args: CreateApiV9PeopleArgs, options?: CreateApiV9PeopleOptions) => { const {baseUrl = "https://api.sumble.com", fetch: fetchFn = fetch, apiToken} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (apiToken !== undefined) headers.set('authorization', `Bearer ${apiToken}`) const url = `${baseUrl.replace(/\/+$/, '')}/v9/people${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(enrichPeopleResponse, await res.json()) };