@growth-labs/cms 0.5.2 → 0.5.4

package/src/ui/screens/subscriptions-data.ts

@@ -0,0 +1,193 @@
+import type {
+	ComplimentaryAccessPage,
+	ComplimentaryEmailRetryResult,
+	ComplimentaryEntitlementRow,
+	ComplimentaryGrantResult,
+	ComplimentaryRevokeResult,
+	ProviderResult,
+} from '../../providers/types.js'
+import { MAX_COMPLIMENTARY_UNIX_SECONDS } from '../../providers/types.js'
+
+export interface ComplimentaryGrantForm {
+	email: string
+	reason: string
+}
+
+export interface ResultCopy {
+	tone: 'success' | 'warning' | 'info' | 'error'
+	message: string
+}
+
+export function buildComplimentaryGrantPayload(form: ComplimentaryGrantForm) {
+	return {
+		email: form.email.trim().toLowerCase(),
+		reason: form.reason.trim(),
+	}
+}
+
+export function buildComplimentaryRevokePayload(
+	entitlement: Pick<ComplimentaryEntitlementRow, 'id'>,
+	reason: string,
+) {
+	return {
+		entitlementId: entitlement.id,
+		reason: reason.trim(),
+	}
+}
+
+export function buildComplimentaryRetryPayload(
+	entitlement: Pick<ComplimentaryEntitlementRow, 'id'>,
+	reason: string,
+) {
+	return {
+		entitlementId: entitlement.id,
+		reason: reason.trim(),
+	}
+}
+
+export function complimentaryGrantSubmitDisabled(
+	form: ComplimentaryGrantForm,
+	submitting: boolean,
+): boolean {
+	return submitting || form.email.trim().length === 0 || form.reason.trim().length === 0
+}
+
+export function describeComplimentaryGrantResult(
+	result: ProviderResult<ComplimentaryGrantResult>,
+): ResultCopy {
+	if (result.status === 'empty') {
+		return { tone: 'error', message: 'Complimentary access provider is not configured.' }
+	}
+	if (result.data.outcome === 'already_active') {
+		return {
+			tone: 'info',
+			message: 'Complimentary access was already active. No new email was sent.',
+		}
+	}
+	switch (result.data.email.status) {
+		case 'sent':
+			return { tone: 'success', message: 'Access granted and email sent.' }
+		case 'failed':
+			return {
+				tone: 'warning',
+				message: 'Access granted, but the email failed. Retry delivery from the row action.',
+			}
+		case 'unknown':
+			return {
+				tone: 'warning',
+				message:
+					'Access granted, but email delivery is unknown. Retry delivery from the row action.',
+			}
+		case 'pending':
+		case 'sending':
+			return {
+				tone: 'info',
+				message: 'Access granted and email delivery is in progress.',
+			}
+		case 'not_attempted':
+			return {
+				tone: 'warning',
+				message: 'Access granted, but no email attempt was recorded.',
+			}
+	}
+}
+
+export function describeComplimentaryRevokeResult(
+	result: ProviderResult<ComplimentaryRevokeResult>,
+): ResultCopy {
+	if (result.status === 'empty') {
+		return { tone: 'error', message: 'Complimentary access provider is not configured.' }
+	}
+	if (result.data.outcome === 'already_revoked') {
+		return { tone: 'info', message: 'Complimentary access was already revoked.' }
+	}
+	return { tone: 'success', message: 'Complimentary access revoked.' }
+}
+
+export function describeComplimentaryRetryResult(
+	result: ProviderResult<ComplimentaryEmailRetryResult>,
+): ResultCopy {
+	if (result.status === 'empty') {
+		return { tone: 'error', message: 'Complimentary access provider is not configured.' }
+	}
+	if (result.data.outcome === 'throttled') {
+		return {
+			tone: 'warning',
+			message: `Retry is not eligible yet.${eligibleSuffix(result.data.email.nextEligibleAt)}`,
+		}
+	}
+	if (result.data.outcome === 'conflict') {
+		return { tone: 'warning', message: 'Another email delivery is already in progress.' }
+	}
+	switch (result.data.email.status) {
+		case 'sent':
+			return { tone: 'success', message: 'Email resent.' }
+		case 'failed':
+			return { tone: 'warning', message: 'Email retry failed. Access remains active.' }
+		case 'unknown':
+			return { tone: 'warning', message: 'Email retry outcome is unknown. Access remains active.' }
+		case 'pending':
+		case 'sending':
+			return { tone: 'info', message: 'Email retry is in progress.' }
+		case 'not_attempted':
+			return { tone: 'info', message: 'No email retry was attempted.' }
+	}
+}
+
+export function complimentaryRowActions(
+	row: ComplimentaryEntitlementRow,
+	nowUnixSeconds = Math.floor(Date.now() / 1000),
+) {
+	const active = row.revokedAt === null
+	const nextEligibleAt = row.emailNextEligibleAt
+	const nextEligibleAtValid = nextEligibleAt === null || isRenderableUnixSeconds(nextEligibleAt)
+	const retryWindowElapsed =
+		nextEligibleAt === null || (nextEligibleAtValid && nextEligibleAt <= nowUnixSeconds)
+	const retryLabel =
+		nextEligibleAt === null || retryWindowElapsed
+			? 'Retry email'
+			: nextEligibleAtValid
+				? `Retry after ${formatTimestamp(nextEligibleAt)}`
+				: 'Retry timing unavailable'
+	const canRetryEmail =
+		active &&
+		row.emailRetryable &&
+		(row.emailStatus === 'failed' || row.emailStatus === 'unknown') &&
+		nextEligibleAtValid &&
+		retryWindowElapsed
+	return {
+		canRevoke: active,
+		canRetryEmail,
+		retryLabel,
+	}
+}
+
+export function complimentaryPageLabel(page: ComplimentaryAccessPage): string {
+	return `Page ${page.page} of ${page.totalPages} · ${page.total.toLocaleString('en-US')} records`
+}
+
+export function formatTimestamp(value: number): string {
+	if (!isRenderableUnixSeconds(value)) return 'Date unavailable'
+	try {
+		return new Date(value * 1000).toISOString().slice(0, 16).replace('T', ' ')
+	} catch {
+		return 'Date unavailable'
+	}
+}
+
+function eligibleSuffix(nextEligibleAt: number | null): string {
+	if (nextEligibleAt === null) return ''
+	const formatted = formatTimestamp(nextEligibleAt)
+	return formatted === 'Date unavailable'
+		? ' Retry timing is unavailable.'
+		: ` Try again after ${formatted}.`
+}
+
+function isRenderableUnixSeconds(value: number): boolean {
+	return (
+		Number.isInteger(value) &&
+		value >= 0 &&
+		value <= MAX_COMPLIMENTARY_UNIX_SECONDS &&
+		Number.isSafeInteger(value * 1000)
+	)
+}