import {z} from 'zod' export type LightBooleanFilterClause = {type: 'booleanFilter', field: string, params: {op: string, value: boolean}}; export type LightStringFilterClause = {type: 'stringFilter', field: string, params: {op: string, value: string | null}}; export type LightStringListFilterClause = {type: 'stringListFilter', field: string, params: {op: string, value: Array | null}}; export type LightNumberFilterClause = {type: 'numberFilter', field: string, params: {op: string, value: number}}; export type LightNumberRangeFilterClause = {type: 'numberRangeFilter', field: string, params: {op: string, value: {min: number | null, max: number | null}}}; export type LightDateRangeFilterClause = {type: 'dateRangeFilter', field: string, params: {op: string, value: string | null, min: string | null, max: string | null}}; export type LightLeadScoreFilterClause = {type: 'leadScoreFilter', field: string, params: {op: string, value: number, scoreId: string}}; export type LightLocationFilterClause = {type: 'location', field: 'city' | 'country' | 'country_region', params: {op: string, value: Array}}; export type LightWebVisitPagesFilterClause = {type: 'webVisitPages', field: 'memberWebVisitPagesViewed' | 'groupWebVisitPagesViewed', params: {op: string, pages: Array<{match: 'contains' | 'exact' | 'partial' | 'prefix', value: string}>, interval: string, minimumPageViews: number | null}}; export type LightPathSegment = {target: string, objectConfigId: string | null, assocType: string | null}; export type LightFilterGroupClause = {type: 'and' | 'or', clauses: Array, target: string | null, objectConfigId: string | null, targetAssocPaths: Array> | null}; export type LightFilterClause = LightBooleanFilterClause | LightStringFilterClause | LightStringListFilterClause | LightNumberFilterClause | LightNumberRangeFilterClause | LightDateRangeFilterClause | LightLeadScoreFilterClause | LightLocationFilterClause | LightWebVisitPagesFilterClause | LightFilterGroupClause; export type LightFilterExpression = {type: 'and' | 'or', clauses: Array}; export type GetApiContactsArgs = {limit?: number | undefined, cursor?: string | undefined, sort?: string | undefined, direction?: ('asc' | 'desc') | undefined, cols?: string | undefined, organizationId?: string | undefined, segmentId?: string | undefined, lightFilter?: LightFilterExpression | undefined}; export type GetApiContactsOptions = {baseUrl?: string | undefined, BearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const apiLocation = z.object({city: z.string().optional(), region: z.string().optional(), country: z.string().optional(), countryCode: z.string().optional()}); export const apiFieldValue = z.union([z.object({type: z.literal("string"), value: z.string()}), z.object({type: z.literal("url"), value: z.string()}), z.object({type: z.literal("int"), value: z.number().int()}), z.object({type: z.literal("number"), value: z.number()}), z.object({type: z.literal("date"), value: z.string()}), z.object({type: z.literal("boolean"), value: z.boolean()})]); export const apiNaicsCode = z.object({id: z.string(), code: z.number().int(), name: z.string()}); export const apiContactCompany = z.object({companyName: z.string().nullable(), domain: z.string().nullable(), isCurrent: z.boolean(), jobTitle: z.string().nullable(), startDate: z.string().nullable(), endDate: z.string().nullable(), seniority: z.string().nullable(), employeeCount: z.number().nullable(), revenueRange: z.object({min: z.number(), max: z.number().nullable()}).nullable(), industry: z.object({naicsCodes: z.array(apiNaicsCode), subIndustry: z.string().nullable()}).nullable(), location: apiLocation.nullable()}); export const apiLeadScore = z.object({scoreId: z.number().int(), score: z.number(), percentile: z.number()}); export const apiLeadScoreKeyFactors = z.object({scoreId: z.number().int(), factors: z.array(z.object({label: z.string(), value: z.string().nullable(), strength: z.number()}))}); export const apiActivity = z.object({id: z.string(), type: z.string(), activityTime: z.string(), contactId: z.string().optional(), content: z.string().nullable().optional(), isUserInitiated: z.boolean().optional(), participantCount: z.number().int().optional(), providerId: z.string().optional(), providerName: z.string().nullable().optional(), replyCount: z.number().int().optional(), sentiment: z.string().nullable().optional(), subSourceNames: z.array(z.string()).optional(), url: z.string().optional()}); export const contact = z.object({id: z.string(), name: z.string(), avatarUrl: z.string().nullable().optional(), fullName: z.string().nullable().optional(), location: apiLocation.nullable().optional(), primaryEmail: z.string().nullable().optional(), phoneNumbers: z.array(z.object({type: z.string(), value: z.string(), isPremium: z.boolean()})).optional(), title: z.string().nullable().optional(), companyName: z.string().nullable().optional(), companyWebsite: z.string().nullable().optional(), linkedInUrls: z.array(z.string()).optional(), gitHubUrls: z.array(z.string()).optional(), xUrls: z.array(z.string()).optional(), connectedCustomObjects: z.array(z.object({id: z.string(), name: z.string(), objectType: z.string()})).optional(), customFields: z.record(z.string(), apiFieldValue).optional(), profiles: z.array(z.object({type: z.string(), value: z.string()})).optional(), jobHistory: z.array(z.object({company: z.string(), title: z.string().nullable(), startDate: z.string(), endDate: z.string().nullable()})).optional(), fullJobHistory: z.array(z.object({company: z.string(), domain: z.string(), title: z.string().nullable(), startDate: z.string(), endDate: z.string().nullable(), isCurrent: z.boolean()})).optional(), jobChangeDate: z.string().nullable().optional(), currentCompany: apiContactCompany.nullable().optional(), previousCompany: apiContactCompany.nullable().optional(), leadScores: z.array(apiLeadScore).optional(), leadScoreKeyFactors: z.array(apiLeadScoreKeyFactors).optional(), segments: z.array(z.object({id: z.string(), name: z.string()})).optional(), recentWebPages: z.array(z.object({url: z.string(), numVisits: z.number().int()})).optional(), recentWebVisitsNumber: z.number().int().optional(), recentActivities: z.array(apiActivity).optional(), activityCount7d: z.number().int().optional(), activityCount28d: z.number().int().optional(), activityCount8w: z.number().int().optional(), activityCount12w: z.number().int().optional(), activityCount6m: z.number().int().optional(), activityCount1y: z.number().int().optional(), activityCountAll: z.number().int().optional(), activateMessage: z.object({title: z.string(), message: z.string().nullable()}).nullable().optional(), sparkSummary: z.string().nullable().optional(), recentSparkSummaries: z.array(z.string()).optional(), tags: z.array(z.string()).optional(), url: z.string().optional()}); export const contactList = z.object({success: z.literal(true), data: z.array(contact), meta: z.object({nextCursor: z.string().nullable(), recordCount: z.number().int().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 }; /** * List contacts * * GET /contacts */ export const getApiContacts = async (args: GetApiContactsArgs, options?: GetApiContactsOptions) => { const {baseUrl = "https://api.commonroom.io/api/v2", fetch: fetchFn = fetch, BearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.limit != null) query.append("limit", String(args.limit)) if (args.cursor != null) query.append("cursor", String(args.cursor)) if (args.sort != null) query.append("sort", String(args.sort)) if (args.direction != null) query.append("direction", String(args.direction)) if (args.cols != null) query.append("cols", String(args.cols)) if (args.organizationId != null) query.append("organizationId", String(args.organizationId)) if (args.segmentId != null) query.append("segmentId", String(args.segmentId)) if (args.lightFilter != null) query.append("lightFilter", JSON.stringify(args.lightFilter)) if (BearerAuth !== undefined) headers.set('authorization', `Bearer ${BearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/contacts${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(contactList, await res.json()) };