@kody/twilio

import { twilioRequest } from './client.ts'
import { mutationPreview } from './helpers.ts'
import { resolveMessagingServiceSid } from './config.ts'
import {
	assertE164,
	inputRecord,
	optionalE164,
	requiredString,
	type TwilioAuthOptions,
} from './validation.ts'

/**
 * Preview or send an SMS.
 *
 * Defaults to dry-run. A live send requires `confirm: true` after the user
 * explicitly approves the destination and body. Never bakes in a from/to
 * number — pass `from` or a Messaging Service SID (param or packageStorage).
 */
export async function sendMessage(
	params: TwilioAuthOptions & {
		to: string
		body: string
		from?: string
		messagingServiceSid?: string
		statusCallback?: string
		dryRun?: boolean
		confirm?: boolean
	},
) {
	const input = inputRecord(params)
	const to = assertE164(requiredString(input, 'to'), 'to')
	const body = requiredString(input, 'body')
	const from = optionalE164(input, 'from')
	const messagingServiceSid = await resolveMessagingServiceSid(input)
	const statusCallback =
		typeof input.statusCallback === 'string' && input.statusCallback.trim()
			? input.statusCallback.trim()
			: undefined

	if (statusCallback && !/^https:\/\//i.test(statusCallback)) {
		throw new Error('statusCallback must be an https URL when provided.')
	}

	if (!from && !messagingServiceSid) {
		if (input.confirm === true && input.dryRun !== true) {
			throw new Error(
				'Sending SMS requires from (E.164) or messagingServiceSid (MG...). Pass one explicitly or store a Messaging Service SID in packageStorage after you fork. This package has no baked-in phone numbers.',
			)
		}
	}

	const payload = {
		To: to,
		Body: body,
		From: from,
		MessagingServiceSid: messagingServiceSid,
		StatusCallback: statusCallback,
	}

	const preview = mutationPreview(input, '/Messages.json', payload)
	if (preview) {
		return {
			...preview,
			to,
			from: from ?? null,
			messagingServiceSid: messagingServiceSid ?? null,
			bodyLength: body.length,
			missingSender: !from && !messagingServiceSid,
		}
	}

	const raw = await twilioRequest({
		...input,
		resource: '/Messages.json',
		method: 'POST',
		body: payload,
	})

	return {
		ok: true,
		sid: typeof raw.sid === 'string' ? raw.sid : null,
		status: typeof raw.status === 'string' ? raw.status : null,
		to: typeof raw.to === 'string' ? raw.to : to,
		from: typeof raw.from === 'string' ? raw.from : from ?? null,
		dateCreated: typeof raw.date_created === 'string' ? raw.date_created : null,
	}
}

export default sendMessage