@antelopejs/dms-mailing 0.3.4 → 0.4.1

package/frontend-vue/tests/retention-input.test.ts

@@ -0,0 +1,130 @@
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { computed, createApp, h, nextTick, reactive, type App } from 'vue'
+import RetentionInput from '../app/components/RetentionInput.vue'
+import {
+	flush,
+	slotStub,
+	stubNuxtGlobals,
+	type NuxtStubs,
+} from './helpers/nuxt-globals'
+import type { RetentionPreview } from '../app/types/mailing'
+
+const api = {
+	retentionPreview: vi.fn(),
+}
+
+vi.mock('../app/composables/useMailingApi', () => ({
+	useMailingApi: () => api,
+}))
+
+const SAVED_DAYS = 90
+const DEBOUNCE_MS = 400
+
+type Validator = () => boolean
+
+interface Harness {
+	state: { days: number; initial: number }
+	validators: Set<Validator>
+	submit: ReturnType<typeof vi.fn>
+	host: HTMLElement
+	app: App
+}
+
+function preview(days: number, count: number): RetentionPreview {
+	return { days, count, nextRunAt: new Date().toISOString() }
+}
+
+function mountRetention(): Harness {
+	const state = reactive({ days: SAVED_DAYS, initial: SAVED_DAYS })
+	const validators = new Set<Validator>()
+	const submit = vi.fn(async () => undefined)
+	vi.stubGlobal('useEnclosingForm', () => ({
+		submit,
+		addValidator: (validator: Validator) => {
+			validators.add(validator)
+			return () => validators.delete(validator)
+		},
+		focusField: async () => undefined,
+	}))
+	const host = document.createElement('div')
+	document.body.appendChild(host)
+	const app = createApp({
+		setup: () => () =>
+			h(RetentionInput, {
+				modelValue: state.days,
+				initialValue: state.initial,
+				'onUpdate:modelValue': (value: number) => (state.days = value),
+			}),
+	})
+	app.component('DmsSegmented', slotStub('DmsSegmented'))
+	app.component('UInputNumber', slotStub('UInputNumber'))
+	app.component('UAlert', slotStub('UAlert'))
+	app.config.warnHandler = () => undefined
+	app.mount(host)
+	return { state, validators, submit, host, app }
+}
+
+function segmented(host: HTMLElement): HTMLElement {
+	return host.querySelector('[data-stub="DmsSegmented"]') as HTMLElement
+}
+
+describe('RetentionInput', () => {
+	let stubs: NuxtStubs
+	let harness: Harness | undefined
+
+	beforeEach(() => {
+		vi.useFakeTimers()
+		stubs = stubNuxtGlobals()
+		vi.stubGlobal('computed', computed)
+		api.retentionPreview.mockImplementation(async (days: number) =>
+			preview(days, days < SAVED_DAYS ? 3 : 0),
+		)
+	})
+
+	afterEach(() => {
+		harness?.app.unmount()
+		harness?.host.remove()
+		vi.useRealTimers()
+		vi.unstubAllGlobals()
+	})
+
+	it('goes back to the preset once a custom value is discarded', async () => {
+		harness = mountRetention()
+		const { host, state } = harness
+		const attrs = () => segmented(host).getAttribute('modelvalue')
+		expect(attrs()).toBe(String(SAVED_DAYS))
+		state.days = 1
+		await flush()
+		expect(attrs()).toBe('custom')
+		state.days = SAVED_DAYS
+		await flush()
+		expect(attrs()).toBe(String(SAVED_DAYS))
+	})
+
+	it('holds a save deleting sends until it is confirmed', async () => {
+		harness = mountRetention()
+		harness.state.days = 30
+		await nextTick()
+		await vi.advanceTimersByTimeAsync(DEBOUNCE_MS)
+		await flush()
+		const [validator] = [...harness.validators]
+		expect(validator?.()).toBe(false)
+		await flush()
+		expect(stubs.confirmations).toHaveLength(1)
+		expect(harness.submit).toHaveBeenCalledTimes(1)
+		expect(validator?.()).toBe(true)
+	})
+
+	it('lets a save through that deletes nothing', async () => {
+		harness = mountRetention()
+		harness.state.days = 365
+		await nextTick()
+		await vi.advanceTimersByTimeAsync(DEBOUNCE_MS)
+		await flush()
+		const [validator] = [...harness.validators]
+		expect(validator?.()).toBe(true)
+		expect(stubs.confirmations).toHaveLength(0)
+		expect(harness.submit).not.toHaveBeenCalled()
+	})
+})

package/frontend-vue/tests/send-actions.test.ts

@@ -0,0 +1,128 @@
+import { describe, expect, it } from 'vitest'
+import {
+	correctedAddressError,
+	formatPayload,
+	replayOutcome,
+	SEND_STATUS_TONES,
+	sendFooterActions,
+	shortSendId,
+} from '../app/utils/send-actions'
+import { SEND_STATUSES } from '../app/types/mailing'
+
+type Status = Parameters<typeof sendFooterActions>[0]['status']
+
+const footer = (status: Status) => sendFooterActions({ status })
+const ids = (status: Status) => footer(status).map((action) => action.id)
+
+describe('sendFooterActions', () => {
+	it('asks for a corrected address after a bounce, never a second send', () => {
+		expect(ids('bounced')).toEqual(['rendering', 'copy_address', 'fix_address'])
+		expect(
+			footer('bounced').find((action) => action.id === 'fix_address')?.variant,
+		).toBe('solid')
+	})
+
+	it('never answers a spam report with another e-mail', () => {
+		expect(ids('spam')).not.toContain('send_again')
+		expect(ids('spam')).not.toContain('fix_address')
+	})
+
+	it('makes sending again the main action of a provider failure', () => {
+		const action = footer('failed').find((entry) => entry.id === 'send_again')
+		expect(action?.variant).toBe('solid')
+	})
+
+	it('keeps sending again quiet for a send that went through', () => {
+		for (const status of [
+			'delivered',
+			'opened',
+			'clicked',
+			'sent',
+			'queued',
+		] as const) {
+			expect(
+				footer(status).find((action) => action.id === 'send_again')?.variant,
+			).toBe('ghost')
+		}
+	})
+
+	it('sends a temporary bounce again to the same address', () => {
+		const actions = sendFooterActions({ status: 'bounced', isSoftBounce: true })
+		expect(actions.map((action) => action.id)).toEqual([
+			'rendering',
+			'send_again',
+		])
+	})
+
+	it('never sends again to someone who unsubscribed', () => {
+		expect(ids('unsubscribed')).toEqual(['rendering', 'copy_address'])
+	})
+
+	it('offers no second send once someone sent it again', () => {
+		const actions = sendFooterActions({ status: 'failed', replayedBy: 'snd_2' })
+		expect(actions.map((action) => action.id)).not.toContain('send_again')
+		expect(actions.map((action) => action.id)).not.toContain('fix_address')
+	})
+
+	it('always offers the rendering', () => {
+		for (const status of SEND_STATUSES)
+			expect(ids(status)).toContain('rendering')
+	})
+})
+
+describe('SEND_STATUS_TONES', () => {
+	it('gives every status a tone', () => {
+		expect(SEND_STATUSES.every((status) => SEND_STATUS_TONES[status])).toBe(
+			true,
+		)
+		expect(SEND_STATUS_TONES.bounced).toBe('error')
+	})
+})
+
+describe('correctedAddressError', () => {
+	it('refuses an empty, invalid or unchanged address', () => {
+		expect(correctedAddressError('', 'a@b.co')).toBe(
+			'dms_mailing.sends.fix_address.errors.required',
+		)
+		expect(correctedAddressError('nope', 'a@b.co')).toBe(
+			'dms_mailing.sends.fix_address.errors.invalid',
+		)
+		expect(correctedAddressError(' A@B.co ', 'a@b.co')).toBe(
+			'dms_mailing.sends.fix_address.errors.same',
+		)
+	})
+
+	it('accepts a different e-mail address', () => {
+		expect(
+			correctedAddressError('tony@stark.com', 'procurement@stark.com'),
+		).toBeNull()
+	})
+})
+
+describe('shortSendId and formatPayload', () => {
+	it('keeps the end of the id', () => {
+		expect(shortSendId('66f0c2a18f2a8c1e')).toBe('8f2a8c1e')
+	})
+
+	it('pretty-prints the data, or returns it raw', () => {
+		expect(formatPayload('{"a":1}')).toBe('{\n  "a": 1\n}')
+		expect(formatPayload('not json')).toBe('not json')
+		expect(formatPayload(undefined)).toBe('')
+	})
+})
+
+describe('replayOutcome', () => {
+	it('counts a send again as sent only when the e-mail went out', () => {
+		expect(replayOutcome({ status: 'sent' })).toBe('sent')
+		expect(
+			replayOutcome({
+				status: 'suppressed',
+				error: '$dms_mailing.errors.suppressed.unsubscribe',
+			}),
+		).toBe('suppressed')
+		expect(replayOutcome({ status: 'failed', error: 'ECONNREFUSED' })).toBe(
+			'failed',
+		)
+		expect(replayOutcome({ status: 'queued', error: 'boom' })).toBe('failed')
+	})
+})

package/frontend-vue/tests/send-modals.test.ts

@@ -0,0 +1,416 @@
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import RealSendModal from '../app/components/RealSendModal.vue'
+import RecipientsField from '../app/components/RecipientsField.vue'
+import TestSendModal from '../app/components/TestSendModal.vue'
+import type {
+	TemplateContentResponse,
+	TemplateStatus,
+} from '../app/types/mailing'
+import { defineComponent, h } from 'vue'
+import {
+	FORM_STUBS,
+	flush,
+	mount,
+	slotStub,
+	stubNuxtGlobals,
+	typeInto,
+	type NuxtStubs,
+} from './helpers/nuxt-globals'
+
+const api = {
+	templateContent: vi.fn(),
+	preview: vi.fn(),
+	testSend: vi.fn(),
+	realSend: vi.fn(),
+}
+
+vi.mock('../app/composables/useMailingApi', () => ({
+	useMailingApi: () => api,
+}))
+
+const DRAFT_CONTENT = {
+	locales: { en: { subject: 'Hi', preheader: '', blocks: [] } },
+}
+const PUBLISHED_CONTENT = {
+	locales: {
+		en: { subject: 'Hi', preheader: '', blocks: [] },
+		fr: { subject: 'Salut', preheader: '', blocks: [] },
+	},
+}
+
+function detail(
+	status: TemplateStatus,
+	overrides: Partial<TemplateContentResponse> = {},
+): TemplateContentResponse {
+	return {
+		template: {
+			_id: 't1',
+			slug: 'autumn-sale',
+			name: 'Autumn sale',
+			status,
+			updatedAt: '2026-09-27T10:00:00Z',
+			updatedBy: 'Hugo Bernard',
+			publishedAt: '2026-09-22T10:00:00Z',
+		},
+		content: DRAFT_CONTENT,
+		publishedContent: status === 'live' ? PUBLISHED_CONTENT : null,
+		hasDraft: true,
+		version: status === 'live' ? 4 : 0,
+		changes: [],
+		variables: [{ path: 'customer.firstName', type: 'string', required: true }],
+		detectedVariables: ['customer.firstName'],
+		testData: { customer: { firstName: 'Margaux' } },
+		fallbackLocale: 'en',
+		categories: [],
+		sender: { name: 'Acme Supplies', email: 'hello@acme.com', replyTo: '' },
+		...overrides,
+	}
+}
+
+interface ReviewItem {
+	id: string
+	value?: string
+}
+
+const KeyValueListStub = defineComponent({
+	props: { items: { type: Array, default: () => [] } },
+	setup:
+		(props, { slots }) =>
+		() =>
+			h(
+				'dl',
+				{ 'data-review': '' },
+				(props.items as ReviewItem[]).map((item) =>
+					h(
+						'dd',
+						{ 'data-id': item.id },
+						slots.value?.({ item, formatted: item.value ?? '' }),
+					),
+				),
+			),
+})
+
+const globals = {
+	...FORM_STUBS,
+	MailingRecipientsField: RecipientsField,
+	DmsKeyValueList: KeyValueListStub,
+	DmsBanner: slotStub('DmsBanner'),
+}
+
+let stubs: NuxtStubs
+
+beforeEach(() => {
+	stubs = stubNuxtGlobals('camille@acme.com')
+	api.preview.mockResolvedValue({
+		html: '',
+		subject: '20% off every chair',
+		locale: 'en',
+		missing: [],
+		hiddenBlockIds: [],
+	})
+	api.testSend.mockResolvedValue({
+		results: [{ sendId: 's1', status: 'sent' }],
+	})
+	api.realSend.mockResolvedValue({
+		results: [
+			{ sendId: 's1', status: 'sent' },
+			{ sendId: 's2', status: 'failed', error: 'boom' },
+		],
+	})
+})
+
+afterEach(() => {
+	vi.unstubAllGlobals()
+	document.body.innerHTML = ''
+})
+
+const submitButton = (host: HTMLElement) =>
+	host.querySelector('ubutton[type="submit"]') as HTMLElement
+
+const isDisabled = (host: HTMLElement) =>
+	submitButton(host).getAttribute('disabled') === 'true'
+
+const submit = async (host: HTMLElement) => {
+	;(host.querySelector('form') as HTMLFormElement).dispatchEvent(
+		new Event('submit'),
+	)
+	await flush()
+}
+
+describe('TestSendModal', () => {
+	it('tests a draft too, prefilled with the current user', async () => {
+		api.templateContent.mockResolvedValue(detail('draft', { hasDraft: false }))
+		const view = mount(TestSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(
+			view.host.querySelector('[data-tags]')?.getAttribute('data-tags'),
+		).toBe('camille@acme.com')
+		expect(view.host.textContent).toContain('1 / 5')
+		expect(isDisabled(view.host)).toBe(false)
+		await submit(view.host)
+		expect(api.testSend).toHaveBeenCalledWith('t1', {
+			to: ['camille@acme.com'],
+			locale: 'en',
+			data: { customer: { firstName: 'Margaux' } },
+		})
+		expect(view.host.textContent).toContain(
+			'dms_mailing.test_send.current_draft',
+		)
+		expect(stubs.toasts.at(-1)?.color).toBe('success')
+		view.unmount()
+	})
+
+	it('tests the published version of a live template without a draft', async () => {
+		api.templateContent.mockResolvedValue(detail('live', { hasDraft: false }))
+		const view = mount(TestSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(view.host.textContent).toContain(
+			'dms_mailing.test_send.published_version version=4',
+		)
+		expect(view.host.querySelector('[data-version-choice]')).toBeNull()
+		await submit(view.host)
+		const input = api.testSend.mock.calls.at(-1)?.[1]
+		expect(input).not.toHaveProperty('content')
+		expect(input).not.toHaveProperty('version')
+		view.unmount()
+	})
+
+	it('offers the published version beside a saved draft', async () => {
+		api.templateContent.mockResolvedValue(detail('live'))
+		const view = mount(TestSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(view.host.querySelector('[data-version-choice]')).not.toBeNull()
+		await submit(view.host)
+		expect(api.testSend.mock.calls.at(-1)?.[1]).not.toHaveProperty('content')
+		view.unmount()
+	})
+
+	it('links the success toast to the send in the log', async () => {
+		api.templateContent.mockResolvedValue(detail('draft'))
+		const view = mount(TestSendModal, { templateId: 't1' }, globals)
+		await flush()
+		await submit(view.host)
+		const actions = stubs.toasts.at(-1)?.actions as {
+			onClick: () => void
+		}[]
+		actions[0]!.onClick()
+		expect(stubs.navigations.at(-1)).toEqual({
+			path: '/modules/mailing/sends',
+			query: { record: 's1' },
+		})
+		view.unmount()
+	})
+
+	it('sends the editor draft and data when the editor hands them over', async () => {
+		api.templateContent.mockResolvedValue(detail('live'))
+		const content = {
+			locales: { fr: { subject: 'x', preheader: '', blocks: [] } },
+		}
+		const view = mount(
+			TestSendModal,
+			{ templateId: 't1', locale: 'fr', content, data: { a: 1 } },
+			globals,
+		)
+		await flush()
+		await submit(view.host)
+		expect(api.testSend).toHaveBeenCalledWith(
+			't1',
+			expect.objectContaining({ content, locale: 'fr', data: { a: 1 } }),
+		)
+		view.unmount()
+	})
+
+	it('refuses an invalid address before sending', async () => {
+		api.templateContent.mockResolvedValue(detail('draft'))
+		const view = mount(TestSendModal, { templateId: 't1' }, globals)
+		await flush()
+		await typeInto(view.host.querySelector('[data-tags]')!, 'not-an-address')
+		expect(isDisabled(view.host)).toBe(true)
+		view.unmount()
+	})
+})
+
+describe('RealSendModal', () => {
+	it('stays disabled until the acknowledgement is ticked', async () => {
+		api.templateContent.mockResolvedValue(detail('live'))
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(
+			view.host.querySelector('[data-tags]')?.getAttribute('data-tags'),
+		).toBe('')
+		await typeInto(
+			view.host.querySelector('[data-tags]')!,
+			'margaux@northwind.co',
+		)
+		expect(isDisabled(view.host)).toBe(true)
+		const ack = view.host.querySelector(
+			'input[type="checkbox"]',
+		) as HTMLInputElement
+		ack.checked = true
+		ack.dispatchEvent(new Event('change'))
+		await flush()
+		expect(isDisabled(view.host)).toBe(false)
+		await submit(view.host)
+		expect(api.realSend).toHaveBeenCalledWith('t1', {
+			to: ['margaux@northwind.co'],
+			locale: 'en',
+			data: { customer: { firstName: 'Margaux' } },
+		})
+		expect(stubs.toasts.map((toast) => toast.color)).toEqual([
+			'error',
+			'success',
+		])
+		view.unmount()
+	})
+
+	it('reviews the published subject, sender and version', async () => {
+		api.templateContent.mockResolvedValue(detail('live'))
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(api.preview).toHaveBeenCalledWith('t1', {
+			locale: 'en',
+			version: 'published',
+			data: { customer: { firstName: 'Margaux' } },
+		})
+		const value = (id: string) =>
+			view.host
+				.querySelector(`[data-review] [data-id="${id}"]`)
+				?.textContent?.trim()
+		expect(value('from')).toBe('Acme Supplies <hello@acme.com>')
+		expect(value('subject')).toBe('20% off every chair')
+		expect(value('version')).toContain('v4')
+		expect(value('version')).toContain('fr')
+		expect(view.host.querySelector('[data-no-sender]')).toBeNull()
+		view.unmount()
+	})
+
+	it('asks the values of the send and waits for the required ones', async () => {
+		api.templateContent.mockResolvedValue(detail('live'))
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		const field = view.host.querySelector(
+			'[data-path="customer.firstName"]',
+		) as HTMLInputElement
+		expect(field.value).toBe('Margaux')
+		await typeInto(view.host.querySelector('[data-tags]')!, 'a@acme.com')
+		const ack = view.host.querySelector(
+			'input[type="checkbox"]',
+		) as HTMLInputElement
+		ack.checked = true
+		ack.dispatchEvent(new Event('change'))
+		await flush()
+		expect(isDisabled(view.host)).toBe(false)
+		await typeInto(field, '')
+		expect(isDisabled(view.host)).toBe(true)
+		expect(
+			view.host.querySelector('[data-missing-required]')?.textContent,
+		).toContain('paths=customer.firstName')
+		await typeInto(field, 'Julie')
+		expect(isDisabled(view.host)).toBe(false)
+		await submit(view.host)
+		expect(api.realSend.mock.calls.at(-1)?.[1].data).toEqual({
+			customer: { firstName: 'Julie' },
+		})
+		view.unmount()
+	})
+
+	it('sends the typed child value when the content also prints its object', async () => {
+		api.templateContent.mockResolvedValue(
+			detail('live', {
+				variables: [{ path: 'order.number', type: 'string', required: true }],
+				detectedVariables: ['order', 'order.number', 'meta'],
+				testData: { order: { number: 'A-42', total: 3 }, meta: { a: 1 } },
+			}),
+		)
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		const values = view.host.querySelector('[data-send-values]')!
+		expect(values.textContent).not.toContain('list_missing')
+		expect(values.textContent).toContain('dms_mailing.real_send.object_value')
+		expect(view.host.querySelector('[data-path="order"]')).toBeNull()
+		await typeInto(
+			view.host.querySelector('[data-path="order.number"]')!,
+			'B-7',
+		)
+		await typeInto(view.host.querySelector('[data-tags]')!, 'a@acme.com')
+		const ack = view.host.querySelector(
+			'input[type="checkbox"]',
+		) as HTMLInputElement
+		ack.checked = true
+		ack.dispatchEvent(new Event('change'))
+		await flush()
+		await submit(view.host)
+		expect(api.realSend.mock.calls.at(-1)?.[1].data).toEqual({
+			order: { number: 'B-7' },
+			meta: { a: 1 },
+		})
+		view.unmount()
+	})
+
+	it('reviews the subject a recipient reads, blanks included', async () => {
+		api.preview.mockResolvedValue({
+			html: '',
+			subject: 'Order {{order.number}} shipped',
+			locale: 'en',
+			missing: ['order.number'],
+			hiddenBlockIds: [],
+		})
+		api.templateContent.mockResolvedValue(detail('live'))
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(
+			view.host
+				.querySelector('[data-review] [data-id="subject"]')
+				?.textContent?.trim(),
+		).toBe('Order  shipped')
+		view.unmount()
+	})
+
+	it('warns when no sender is set', async () => {
+		api.templateContent.mockResolvedValue(
+			detail('live', { sender: { name: '', email: '', replyTo: '' } }),
+		)
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(view.host.querySelector('[data-no-sender]')).not.toBeNull()
+		view.unmount()
+	})
+
+	it('untick the acknowledgement when the recipients change', async () => {
+		api.templateContent.mockResolvedValue(detail('live'))
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		const tags = view.host.querySelector('[data-tags]')!
+		await typeInto(tags, 'a@acme.com')
+		const ack = view.host.querySelector(
+			'input[type="checkbox"]',
+		) as HTMLInputElement
+		ack.checked = true
+		ack.dispatchEvent(new Event('change'))
+		await flush()
+		await typeInto(view.host.querySelector('[data-tags]')!, 'b@acme.com')
+		expect(isDisabled(view.host)).toBe(true)
+		view.unmount()
+	})
+
+	it('refuses a draft with its checklist and a way out', async () => {
+		api.templateContent.mockResolvedValue(detail('draft'))
+		const view = mount(RealSendModal, { templateId: 't1' }, globals)
+		await flush()
+		expect(view.host.querySelector('form')).toBeNull()
+		const checks = view.host.querySelector('dmschecklist')
+		expect(checks).not.toBeNull()
+		const buttons = [...view.host.querySelectorAll('ubutton')] as HTMLElement[]
+		buttons[0]!.click()
+		expect(stubs.modalCalls[0]?.component).toEqual({
+			name: 'MailingTestSendModal',
+		})
+		buttons[1]!.click()
+		await flush()
+		expect(stubs.navigations).toEqual([
+			{ path: '/modules/mailing/templates/t1', query: {} },
+		])
+		view.unmount()
+	})
+})