@kody/calendly

import { calendlyRequest, uuidFromUri } from './client.ts'
import type { CalendlyAuthInput, DryRunResult, JsonRecord } from './types.ts'
import { optionalString, requireRecord } from './types.ts'
import { requireAuthMode } from './auth.ts'

export type MarkNoShowInput = CalendlyAuthInput & {
	/** Invitee uuid or URI. */
	invitee: string
	confirm?: boolean
	dryRun?: boolean
}

export type MarkNoShowResult = {
	marked: true
	invitee: string
}

/**
 * Mark a Calendly invitee as a no-show. Requires `confirm: true`, or use `dryRun: true`.
 * @example
 * import markNoShow from 'kody:@kody/calendly/mark-no-show'
 * const preview = await markNoShow({ invitee: 'BBBBBBBBBBBBBBBB', dryRun: true })
 */
export async function markNoShow(
	input: MarkNoShowInput,
): Promise<MarkNoShowResult | DryRunResult<{ method: string; path: string; body: JsonRecord }>> {
	const invitee = optionalString(input.invitee, 'invitee')
	if (!invitee) throw new Error('mark-no-show requires invitee (uuid or URI).')
	const uuid = uuidFromUri(invitee)
	const path = `/invitees/${uuid}/no_show`
	if (input.dryRun) {
		return { dryRun: true, wouldCall: { method: 'POST', path, body: {} } }
	}
	if (input.confirm !== true) {
		throw new Error(
			'Marking a Calendly invitee as a no-show requires confirm: true after explicit user approval, or dryRun: true.',
		)
	}
	await calendlyRequest({
		...input,
		operation: 'scheduledEvents.write',
		method: 'POST',
		path,
		body: {},
	})
	return {
		marked: true,
		invitee: uuid,
	}
}

/**
 * Mark a Calendly invitee as a no-show. Requires `confirm: true`, or use `dryRun: true`.
 * @example
 * import markNoShow from 'kody:@kody/calendly/mark-no-show'
 * const preview = await markNoShow({ invitee: 'BBB', dryRun: true })
 */
export default async function markNoShowEntrypoint(
	params: Partial<MarkNoShowInput> & Record<string, unknown> = {},
) {
	const input = requireRecord(params, 'mark-no-show')
	return markNoShow({
		invitee: optionalString(input.invitee, 'invitee') ?? '',
		integrationName: optionalString(input.integrationName, 'integrationName'),
		integration: optionalString(input.integration, 'integration'),
		account: optionalString(input.account, 'account'),
		secretName: optionalString(input.secretName, 'secretName'),
		auth: requireAuthMode(input.auth),
		confirm: input.confirm === true,
		dryRun: input.dryRun === true,
	})
}