import {z} from 'zod' export type PhoneNumberType = 'VoiceFax' | 'VoiceOnly' | 'FaxOnly' | null; export type PhoneNumberUsageType = 'MainCompanyNumber' | 'DirectNumber' | 'Inventory' | 'InventoryPartnerBusinessMobileNumber' | 'PartnerBusinessMobileNumber' | 'AdditionalCompanyNumber' | 'CompanyNumber' | 'PhoneLine' | 'CompanyFaxNumber' | 'ForwardedNumber' | 'ForwardedCompanyNumber' | 'ContactCenterNumber' | 'ConferencingNumber' | 'MeetingsNumber' | 'BusinessMobileNumber' | 'ELIN'; export type PhoneNumberStatus = 'Normal' | 'Pending' | 'PortedIn' | 'Temporary' | 'Unknown'; export type PhoneNumberTollType = 'Toll' | 'TollFree'; export type ExtensionStatus = 'Enabled' | 'Disabled' | 'Frozen' | 'NotActivated' | 'Unassigned'; export type GetApiRestapiV2AccountsAccountIdPhoneNumbersArgs = {accountId: string, page?: number | undefined, perPage?: number | undefined, type?: Array | undefined, usageType?: Array | undefined, status?: PhoneNumberStatus | undefined, tollType?: PhoneNumberTollType | undefined, extensionStatus?: ExtensionStatus | undefined, byocNumber?: boolean | undefined, phoneNumber?: string | undefined}; export type GetApiRestapiV2AccountsAccountIdPhoneNumbersOptions = {baseUrl?: string | undefined, OAuth2?: string | undefined, fetch?: typeof fetch | undefined}; export const phoneNumberId = z.string().max(18); export const phoneNumberE164 = z.string().max(18); export const phoneNumberType = z.enum(["VoiceFax", "VoiceOnly", "FaxOnly"]).nullable(); export const phoneNumberTollType = z.enum(["Toll", "TollFree"]); export const phoneNumberUsageType = z.enum(["MainCompanyNumber", "DirectNumber", "Inventory", "InventoryPartnerBusinessMobileNumber", "PartnerBusinessMobileNumber", "AdditionalCompanyNumber", "CompanyNumber", "PhoneLine", "CompanyFaxNumber", "ForwardedNumber", "ForwardedCompanyNumber", "ContactCenterNumber", "ConferencingNumber", "MeetingsNumber", "BusinessMobileNumber", "ELIN"]); export const phoneNumberStatus = z.enum(["Normal", "Pending", "PortedIn", "Temporary", "Unknown"]); export const extensionNumber = z.string().min(1).max(8); export const accountPhoneNumberInfo = z.object({id: phoneNumberId, phoneNumber: phoneNumberE164, type: phoneNumberType.optional(), tollType: phoneNumberTollType, usageType: phoneNumberUsageType, byocNumber: z.boolean().optional(), status: phoneNumberStatus, extension: z.object({id: z.string(), extensionNumber: extensionNumber.optional()}).optional()}); export const enumeratedPagingModel = z.object({perPage: z.number().int().gte(1).lte(1000), page: z.number().int().gte(1).lte(1000).optional(), pageStart: z.number().int().gte(0).optional(), pageEnd: z.number().int().gte(0).optional(), totalPages: z.number().int().gte(0).optional(), totalElements: z.number().int().gte(0).optional()}); export const accountPhoneNumberList = z.object({records: z.array(accountPhoneNumberInfo), paging: enumeratedPagingModel}); 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 Account Phone Numbers * * GET /restapi/v2/accounts/{accountId}/phone-numbers */ export const getApiRestapiV2AccountsAccountIdPhoneNumbers = async (args: GetApiRestapiV2AccountsAccountIdPhoneNumbersArgs, options?: GetApiRestapiV2AccountsAccountIdPhoneNumbersOptions) => { const {baseUrl = "https://platform.ringcentral.com", fetch: fetchFn = fetch, OAuth2} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.page != null) query.append("page", String(args.page)) if (args.perPage != null) query.append("perPage", String(args.perPage)) for (const item of args.type ?? []) query.append("type", String(item)) for (const item of args.usageType ?? []) query.append("usageType", String(item)) if (args.status != null) query.append("status", String(args.status)) if (args.tollType != null) query.append("tollType", String(args.tollType)) if (args.extensionStatus != null) query.append("extensionStatus", String(args.extensionStatus)) if (args.byocNumber != null) query.append("byocNumber", String(args.byocNumber)) if (args.phoneNumber != null) query.append("phoneNumber", String(args.phoneNumber)) if (OAuth2 !== undefined) headers.set('authorization', `Bearer ${OAuth2}`) const url = `${baseUrl.replace(/\/+$/, '')}/restapi/v2/accounts/${encodeURIComponent(String(args.accountId))}/phone-numbers${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(accountPhoneNumberList, await res.json()) };