import {z} from 'zod' export type RcwSessionStatusModel = 'Scheduled' | 'Active' | 'Finished'; export type GetApiWebinarHistoryV1SessionsArgs = {nameFragment?: string | undefined, status?: Array | undefined, endTimeFrom: string, endTimeTo: string, perPage?: number | undefined, pageToken?: string | undefined}; export type GetApiWebinarHistoryV1SessionsOptions = {baseUrl?: string | undefined, OAuth2?: string | undefined, fetch?: typeof fetch | undefined}; export const rcwDomainUserModel = z.object({userId: z.string().max(256), accountId: z.string().max(256), domain: z.enum(["pbx", "ilm"])}); export const hostModel = z.object({firstName: z.string().max(64).optional(), lastName: z.string().max(64).optional(), linkedUser: rcwDomainUserModel.optional()}); export const webinarRefModel = z.object({id: z.string().min(1).max(20).optional(), title: z.string().min(1).max(512), description: z.string().max(4096).optional(), host: hostModel}); export const rcwSessionStatusModel = z.enum(["Scheduled", "Active", "Finished"]); export const sessionRuntimeStatusModel = z.enum(["Idle", "Practice", "GoingLive", "Live", "Break", "Debrief"]); export const recordingStatusModel = z.enum(["Processing", "Available", "Failed", "Purged"]); export const apiError = z.object({errorCode: z.string(), message: z.string()}).and(z.record(z.string(), z.unknown())); export const recordingSharedStatusModel = z.boolean(); export const recordingSharedLinkExpiryModel = z.string().nullable(); export const recordingModel = z.object({id: z.string().min(1).max(20).optional(), creationTime: z.string(), lastModifiedTime: z.string(), status: recordingStatusModel, failureReason: apiError.optional(), duration: z.number().int().gte(1).optional(), shared: recordingSharedStatusModel.optional(), sharedUriExpirationTime: recordingSharedLinkExpiryModel.optional()}); export const sessionLivestreamStatusModel = z.enum(["Initialized", "Authorized", "Configured", "PublishSetup", "Publishing", "Paused", "Error", "Break", "Deleted", "Completed"]); export const sessionLivestreamMinimalModel = z.object({livestreamId: z.string(), serviceProvider: z.string(), livestreamStatus: sessionLivestreamStatusModel, previousLivestreamStatus: sessionLivestreamStatusModel.optional(), livestreamStartTime: z.string().optional(), error: apiError.optional()}); export const sessionGlobalResource = z.object({id: z.string().min(1).max(20).optional(), creationTime: z.string(), lastModifiedTime: z.string(), webinar: webinarRefModel, startTime: z.string().optional(), endTime: z.string().optional(), duration: z.number().int().optional(), title: z.string().max(512).optional(), description: z.string().max(4096).optional(), scheduledStartTime: z.string().optional(), scheduledDuration: z.number().int().optional(), timeZone: z.string().optional(), localeCode: z.string().optional(), panelJoinTimeOffset: z.number().int().gte(0).optional(), broadcastingStartTime: z.string().optional(), broadcastingEndTime: z.string().optional(), status: rcwSessionStatusModel.optional(), runtimeStatus: sessionRuntimeStatusModel.optional(), participantCount: z.number().int().optional(), attendeeCount: z.number().int().optional(), uniqueParticipantCount: z.number().int().optional(), uniqueAttendeeCount: z.number().int().optional(), videoBridgeId: z.string().optional(), recording: recordingModel.optional(), livestreams: z.array(sessionLivestreamMinimalModel).optional()}); export const rcwPagingModel = z.object({perPage: z.number().int().gte(1).lte(1000), pageToken: z.string(), nextPageToken: z.string().optional(), previousPageToken: z.string().optional()}); export const sessionGlobalListResource = z.object({records: z.array(sessionGlobalResource), paging: rcwPagingModel}); 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 Historical Webinar Sessions across Multiple Webinars * * GET /webinar/history/v1/sessions */ export const getApiWebinarHistoryV1Sessions = async (args: GetApiWebinarHistoryV1SessionsArgs, options?: GetApiWebinarHistoryV1SessionsOptions) => { 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.nameFragment != null) query.append("nameFragment", String(args.nameFragment)) for (const item of args.status ?? []) query.append("status", String(item)) if (args.endTimeFrom != null) query.append("endTimeFrom", String(args.endTimeFrom)) if (args.endTimeTo != null) query.append("endTimeTo", String(args.endTimeTo)) if (args.perPage != null) query.append("perPage", String(args.perPage)) if (args.pageToken != null) query.append("pageToken", String(args.pageToken)) if (OAuth2 !== undefined) headers.set('authorization', `Bearer ${OAuth2}`) const url = `${baseUrl.replace(/\/+$/, '')}/webinar/history/v1/sessions${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(sessionGlobalListResource, await res.json()) };