import {z} from 'zod' export type GetApiRcvideoV2BridgesPinWebPinArgs = {pin: string, pw?: string | undefined}; export type GetApiRcvideoV2BridgesPinWebPinOptions = {baseUrl?: string | undefined, OAuth2?: string | undefined, fetch?: typeof fetch | undefined}; export const user = z.object({accountId: z.string(), extensionId: z.string()}); export const bridgePstnPins = z.object({host: z.string().optional(), participant: z.string().optional()}); export const webPin = z.string(); export const bridgePinsWithAliases = z.object({pstn: bridgePstnPins.optional(), web: webPin.optional(), aliases: z.array(z.string()).optional()}); export const bridgeResponseSecurityPassword = z.object({plainText: z.string().optional(), pstn: z.string().optional(), joinQuery: z.string().optional()}); export const bridgeResponseSecurity = z.object({passwordProtected: z.boolean().optional(), password: bridgeResponseSecurityPassword.optional(), noGuests: z.boolean().optional(), sameAccount: z.boolean().optional(), e2ee: z.boolean().optional()}); export const bridgeJoinPstnPreferences = z.object({promptAnnouncement: z.boolean().optional(), promptParticipants: z.boolean().optional()}); export const bridgeJoinPreferences = z.object({audioMuted: z.boolean().optional(), videoMuted: z.boolean().optional(), waitingRoomRequired: z.enum(["Nobody", "Everybody", "GuestsOnly", "OtherAccount"]).optional(), pstn: bridgeJoinPstnPreferences.optional()}); export const everyoneCanControl = z.object({enabled: z.boolean().optional(), locked: z.boolean().optional()}); export const autoShared = z.object({enabled: z.boolean().optional(), locked: z.boolean().optional()}); export const recordingsPreferences = z.object({everyoneCanControl: everyoneCanControl.optional(), autoShared: autoShared.optional()}); export const bridgePreferences = z.object({join: bridgeJoinPreferences.optional(), playTones: z.enum(["On", "Off", "ExitOnly", "EnterOnly"]).optional(), musicOnHold: z.boolean().optional(), joinBeforeHost: z.boolean().optional(), screenSharing: z.boolean().optional(), recordingsMode: z.enum(["Auto", "ForceAuto", "User"]).optional(), transcriptionsMode: z.enum(["Auto", "ForceAuto", "User"]).optional(), recordings: recordingsPreferences.optional(), allowEveryoneTranscribeMeetings: z.boolean().optional()}); export const bridgeDiscovery = z.object({web: z.string().optional()}); export const bridgeResponse = z.object({id: z.string().optional(), name: z.string().optional(), type: z.enum(["Instant", "Scheduled", "PMI"]).optional(), host: user.optional(), pins: bridgePinsWithAliases.optional(), security: bridgeResponseSecurity.optional(), preferences: bridgePreferences.optional(), discovery: bridgeDiscovery.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 }; /** * Search Bridge by Web PIN * * GET /rcvideo/v2/bridges/pin/web/{pin} */ export const getApiRcvideoV2BridgesPinWebPin = async (args: GetApiRcvideoV2BridgesPinWebPinArgs, options?: GetApiRcvideoV2BridgesPinWebPinOptions) => { 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.pw != null) query.append("pw", String(args.pw)) if (OAuth2 !== undefined) headers.set('authorization', `Bearer ${OAuth2}`) const url = `${baseUrl.replace(/\/+$/, '')}/rcvideo/v2/bridges/pin/web/${encodeURIComponent(String(args.pin))}${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(bridgeResponse, await res.json()) };