/** * @fileoverview Shared Calendly types: `JsonRecord`, `CalendlyAuthMode`, `CalendlyAuthInput`, `CalendlyPageInfo`, `CalendlyUserSummary`, `CalendlyEventTypeSummary`, `CalendlyScheduledEventSummary`, `CalendlyInviteeSummary`, and related shapes. * Import from `kody:@kody/calendly/types` when typing Calendly helpers. Default export returns a type-name catalog. * * @example * import { type CalendlyAuthMode } from 'kody:@kody/calendly/types' */ export type JsonRecord = Record export type CalendlyAuthMode = 'oauth' | 'pat' export type CalendlyAuthInput = { /** Saved OAuth integration name. Defaults to `calendly`. */ integrationName?: string /** Alias of `integrationName`. */ integration?: string /** * Short account alias. `work` → `calendly-work`. Values that already start * with `calendly-` are used as-is. `default` / `calendly` / omitted → `calendly`. */ account?: string /** User secret name for a personal access token. Defaults to `calendlyPat`. */ secretName?: string /** Force OAuth or PAT auth when both exist. */ auth?: CalendlyAuthMode } export type CalendlyPageInfo = { count: number | null nextPageToken: string | null previousPageToken: string | null nextPage: string | null previousPage: string | null } export type CalendlyUserSummary = { uri: string uuid: string name: string | null slug: string | null timezone: string | null schedulingUrl: string | null organization: string | null } export type CalendlyEventTypeSummary = { uri: string uuid: string name: string | null slug: string | null active: boolean | null duration: number | null kind: string | null type: string | null schedulingUrl: string | null color: string | null secret: boolean | null } export type CalendlyScheduledEventSummary = { uri: string uuid: string name: string | null status: string | null startTime: string | null endTime: string | null eventType: string | null location: string | null inviteesActive: number | null inviteesLimit: number | null inviteesTotal: number | null createdAt: string | null } export type CalendlyInviteeSummary = { uri: string uuid: string name: string | null email: string | null status: string | null timezone: string | null event: string | null cancelUrl: string | null rescheduleUrl: string | null rescheduled: boolean | null createdAt: string | null } export type CalendlyAvailableTime = { status: string | null inviteesRemaining: number | null startTime: string | null } export type DryRunResult = { dryRun: true wouldCall: T } /** * Shared Calendly types and parsing helpers for this package. * Import from `kody:@kody/calendly/types` when typing other Calendly exports. * * @returns Catalog of exported type/helper names for agent discovery. * * @example * import types from 'kody:@kody/calendly/types' * const catalog = await types() */ export function requireRecord(value: unknown, label: string): JsonRecord { if (!value || typeof value !== 'object' || Array.isArray(value)) { throw new Error(`${label} must be an object.`) } return value as JsonRecord } export function requireString( value: unknown, label: string, options: { allowEmpty?: boolean } = {}, ): string { if (typeof value !== 'string' || (!options.allowEmpty && value.trim().length === 0)) { throw new Error( `${label} must be ${options.allowEmpty ? 'a string' : 'a non-empty string'}.`, ) } return options.allowEmpty ? value : value.trim() } export function optionalString(value: unknown, label: string): string | undefined { if (value === undefined || value === null) return undefined return requireString(value, label) } export function optionalBoolean(value: unknown, label: string): boolean | undefined { if (value === undefined) return undefined if (typeof value !== 'boolean') throw new Error(`${label} must be a boolean.`) return value } export function optionalStringArray(value: unknown, label: string): Array | undefined { if (value === undefined || value === null) return undefined if (!Array.isArray(value)) throw new Error(`${label} must be an array of strings.`) return value.map((item, index) => requireString(item, `${label}[${index}]`)) } export function clampInt( value: unknown, min: number, max: number, fallback: number, label = 'count', ): number { if (value === undefined || value === null) return fallback if (typeof value !== 'number' || !Number.isInteger(value)) { throw new Error(`${label} must be an integer.`) } if (value < min || value > max) { throw new Error(`${label} must be between ${min} and ${max}.`) } return value } export function compactRecord(value: T): T { const output: JsonRecord = {} for (const [key, item] of Object.entries(value)) { if (item === undefined) continue output[key] = item } return output as T } /** * Shared Calendly types for this package: `JsonRecord`, `CalendlyAuthMode`, `CalendlyAuthInput`, `CalendlyPageInfo`, `CalendlyUserSummary`, `CalendlyEventTypeSummary`, `CalendlyScheduledEventSummary`, `CalendlyInviteeSummary`, and related shapes. * Import from `kody:@kody/calendly/types` when typing Calendly helpers without pulling runtime clients. * * @returns Catalog of exported type names for agent discovery. * * @example * import types from 'kody:@kody/calendly/types' * const catalog = await types() */ export default async function typesOverview() { return { auth: ['CalendlyAuthInput', 'CalendlyAuthMode'], models: [ 'CalendlyUserSummary', 'CalendlyEventTypeSummary', 'CalendlyScheduledEventSummary', 'CalendlyInviteeSummary', ], } }