nolo-cli 0.1.23 → 0.1.29

package/auth/server/emailAutomationTemplates.ts

@@ -0,0 +1,131 @@
+import { getAppName, getAppUrl } from "./emailAutomationConfig";
+
+interface EmailTemplate {
+  subject: string;
+  textBody: string;
+  htmlBody: string;
+}
+
+const escapeHtml = (value: string) =>
+  value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#39;");
+
+const normalizePublicUrl = (url: string) => {
+  if (!url) return "";
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return "";
+    return parsed.toString();
+  } catch {
+    return "";
+  }
+};
+
+const joinPublicUrl = (baseUrl: string, path: string) => {
+  if (!baseUrl) return "";
+  try {
+    return new URL(path, baseUrl).toString();
+  } catch {
+    return "";
+  }
+};
+
+const SUPPORT_CONTACT_TEXT = "如需帮助，可在站内反馈，或联系 s@nolotus.com。";
+
+export const buildWelcomeEmail = (username?: string): EmailTemplate => {
+  const appName = getAppName();
+  const appUrl = normalizePublicUrl(getAppUrl());
+  const displayName = username?.trim() || "朋友";
+  const safeDisplayName = escapeHtml(displayName);
+  const safeAppName = escapeHtml(appName);
+  const safeAppUrl = escapeHtml(appUrl);
+  const subject = `${displayName}，欢迎使用 ${appName}`;
+  const textBody = appUrl
+    ? `你好 ${displayName}，\n\n欢迎使用 ${appName}。你的账号已创建成功，现在可以开始体验核心功能。\n\n开始使用：${appUrl}\n\n${SUPPORT_CONTACT_TEXT}`
+    : `你好 ${displayName}，\n\n欢迎使用 ${appName}。你的账号已创建成功，现在可以开始体验核心功能。\n\n${SUPPORT_CONTACT_TEXT}`;
+  const htmlBody = appUrl
+    ? `<p>你好 ${safeDisplayName}，</p><p>欢迎使用 <strong>${safeAppName}</strong>。你的账号已创建成功，现在可以开始体验核心功能。</p><p>开始使用：<a href="${safeAppUrl}">${safeAppUrl}</a></p><p>${SUPPORT_CONTACT_TEXT}</p>`
+    : `<p>你好 ${safeDisplayName}，</p><p>欢迎使用 <strong>${safeAppName}</strong>。你的账号已创建成功，现在可以开始体验核心功能。</p><p>${SUPPORT_CONTACT_TEXT}</p>`;
+  return { subject, textBody, htmlBody };
+};
+
+export const buildReengagementEmail = (
+  inactiveDays: number,
+  username?: string
+): EmailTemplate => {
+  const appName = getAppName();
+  const appUrl = normalizePublicUrl(getAppUrl());
+  const displayName = username?.trim() || "朋友";
+  const safeDisplayName = escapeHtml(displayName);
+  const safeAppName = escapeHtml(appName);
+  const safeAppUrl = escapeHtml(appUrl);
+  const subject = `${displayName}，欢迎回到 ${appName}`;
+  const textBody = appUrl
+    ? `你好 ${displayName}，\n\n你已有 ${inactiveDays} 天未使用 ${appName}。我们近期完成了一些体验优化，欢迎回来查看。\n\n继续使用：${appUrl}\n\n如果你暂时不希望接收此类邮件，可在设置中调整通知偏好。`
+    : `你好 ${displayName}，\n\n你已有 ${inactiveDays} 天未使用 ${appName}。我们近期完成了一些体验优化，欢迎回来查看。\n\n如果你暂时不希望接收此类邮件，可在设置中调整通知偏好。`;
+  const htmlBody = appUrl
+    ? `<p>你好 ${safeDisplayName}，</p><p>你已有 <strong>${inactiveDays}</strong> 天未使用 <strong>${safeAppName}</strong>。我们近期完成了一些体验优化，欢迎回来查看。</p><p>继续使用：<a href="${safeAppUrl}">${safeAppUrl}</a></p><p>如果你暂时不希望接收此类邮件，可在设置中调整通知偏好。</p>`
+    : `<p>你好 ${safeDisplayName}，</p><p>你已有 <strong>${inactiveDays}</strong> 天未使用 <strong>${safeAppName}</strong>。我们近期完成了一些体验优化，欢迎回来查看。</p><p>如果你暂时不希望接收此类邮件，可在设置中调整通知偏好。</p>`;
+  return { subject, textBody, htmlBody };
+};
+
+export const buildOnboardingEmail = (username?: string): EmailTemplate => {
+  const appName = getAppName();
+  const appUrl = normalizePublicUrl(getAppUrl());
+  const displayName = username?.trim() || "朋友";
+  const safeDisplayName = escapeHtml(displayName);
+  const safeAppName = escapeHtml(appName);
+  const safeAppUrl = escapeHtml(appUrl);
+  const subject = `${displayName}，这是你的 ${appName} 上手指引`;
+  const textBody = appUrl
+    ? `你好 ${displayName}，\n\n为帮助你快速上手，建议按以下顺序完成：\n1) 完成首次核心操作\n2) 体验一个高级能力\n3) 查看数据与设置\n\n操作入口：${appUrl}\n\n${SUPPORT_CONTACT_TEXT}`
+    : `你好 ${displayName}，\n\n为帮助你快速上手，建议按以下顺序完成：\n1) 完成首次核心操作\n2) 体验一个高级能力\n3) 查看数据与设置\n\n${SUPPORT_CONTACT_TEXT}`;
+  const htmlBody = appUrl
+    ? `<p>你好 ${safeDisplayName}，</p><p>为帮助你快速上手 <strong>${safeAppName}</strong>，建议按以下顺序完成：</p><ol><li>完成首次核心操作</li><li>体验一个高级能力</li><li>查看数据与设置</li></ol><p>操作入口：<a href="${safeAppUrl}">${safeAppUrl}</a></p><p>${SUPPORT_CONTACT_TEXT}</p>`
+    : `<p>你好 ${safeDisplayName}，</p><p>为帮助你快速上手 <strong>${safeAppName}</strong>，建议按以下顺序完成：</p><ol><li>完成首次核心操作</li><li>体验一个高级能力</li><li>查看数据与设置</li></ol><p>${SUPPORT_CONTACT_TEXT}</p>`;
+  return { subject, textBody, htmlBody };
+};
+
+export const buildFlowInterruptionEmail = (username?: string): EmailTemplate => {
+  const appName = getAppName();
+  const appUrl = normalizePublicUrl(getAppUrl());
+  const displayName = username?.trim() || "朋友";
+  const safeDisplayName = escapeHtml(displayName);
+  const safeAppName = escapeHtml(appName);
+  const safeAppUrl = escapeHtml(appUrl);
+  const subject = `${displayName}，还差一步即可完成关键流程`;
+  const textBody = appUrl
+    ? `你好 ${displayName}，\n\n我们发现你尚未完成首次关键流程（如首次充值或首次核心操作）。完成后即可解锁完整能力。\n\n继续完成：${appUrl}\n\n${SUPPORT_CONTACT_TEXT}`
+    : `你好 ${displayName}，\n\n我们发现你尚未完成首次关键流程（如首次充值或首次核心操作）。完成后即可解锁完整能力。\n\n${SUPPORT_CONTACT_TEXT}`;
+  const htmlBody = appUrl
+    ? `<p>你好 ${safeDisplayName}，</p><p>我们发现你尚未完成首次关键流程（如首次充值或首次核心操作）。完成后即可解锁完整能力。</p><p>继续完成：<a href="${safeAppUrl}">${safeAppUrl}</a></p><p>${SUPPORT_CONTACT_TEXT}</p>`
+    : `<p>你好 ${safeDisplayName}，</p><p>我们发现你尚未完成首次关键流程（如首次充值或首次核心操作）。完成后即可解锁完整能力。</p><p>${SUPPORT_CONTACT_TEXT}</p>`;
+  return { subject, textBody, htmlBody };
+};
+
+export const buildLowBalanceReminderEmail = (
+  balance: number,
+  lowBalanceThreshold: number,
+  username?: string
+): EmailTemplate => {
+  const appName = getAppName();
+  const appUrl = normalizePublicUrl(getAppUrl());
+  const rechargeUrl = joinPublicUrl(appUrl, "/recharge");
+  const displayName = username?.trim() || "朋友";
+  const safeDisplayName = escapeHtml(displayName);
+  const safeAppName = escapeHtml(appName);
+  const safeRechargeUrl = escapeHtml(rechargeUrl);
+  const balanceText = Number(balance || 0).toFixed(2);
+  const subject = `${displayName}，余额提醒：当前 ${balanceText}`;
+  const textBody = rechargeUrl
+    ? `你好 ${displayName}，\n\n当前余额为 ${balanceText}，低于提醒阈值（${lowBalanceThreshold}）。为避免使用中断，建议及时充值。\n\n充值入口：${rechargeUrl}`
+    : `你好 ${displayName}，\n\n当前余额为 ${balanceText}，低于提醒阈值（${lowBalanceThreshold}）。为避免使用中断，建议及时充值。`;
+  const htmlBody = rechargeUrl
+    ? `<p>你好 ${safeDisplayName}，</p><p>当前余额为 <strong>${balanceText}</strong>，低于提醒阈值（${lowBalanceThreshold}）。</p><p>为避免使用中断，建议及时充值：<a href="${safeRechargeUrl}">${safeAppName} 充值入口</a></p>`
+    : `<p>你好 ${safeDisplayName}，</p><p>当前余额为 <strong>${balanceText}</strong>，低于提醒阈值（${lowBalanceThreshold}）。</p><p>为避免使用中断，建议及时充值。</p>`;
+  return { subject, textBody, htmlBody };
+};

package/auth/server/emailAutomationTypes.ts

@@ -0,0 +1,38 @@
+export const CORE_FLOW_STAGES = {
+  signupStarted: "signup_started",
+  firstCoreActionCompleted: "first_core_action_completed",
+} as const;
+
+export type CoreFlowStage = (typeof CORE_FLOW_STAGES)[keyof typeof CORE_FLOW_STAGES];
+
+export interface UserEmailRecord {
+  email?: string;
+  username?: string;
+  createdAt?: number;
+  lastActiveAt?: number;
+  lastLoginAt?: number;
+  recentAccesses?: Array<{
+    timestamp: number;
+    source: "login" | "token";
+    ip: string;
+    device: string;
+  }>;
+  tokenVersion?: number;
+  tokenVersionUpdatedAt?: number;
+  balance?: number;
+  isDisabled?: boolean;
+  emailOptOutAll?: boolean;
+  emailMutedUntil?: number;
+  emailOptOutTags?: string[];
+  welcomeEmailSentAt?: number;
+  onboardingGuideSentAt?: number;
+  lastReengagementEmailAt?: number;
+  reengagementEmailCount?: number;
+  firstCoreActionAt?: number;
+  firstCoreActionReason?: string;
+  flowInterruptionNudgeSentAt?: number;
+  lastLowBalanceReminderAt?: number;
+  coreFlowStage?: CoreFlowStage;
+  coreFlowStageUpdatedAt?: number;
+  [key: string]: any;
+}

package/auth/server/emailDbConfig.ts

@@ -0,0 +1,147 @@
+import serverDb from "../../database/server/db";
+import { logger } from "./shared";
+
+export const EMAIL_RUNTIME_CONFIG_KEY = "config:email:runtime";
+
+export const EMAIL_RUNTIME_CONFIG_KEYS = [
+  "EMAIL_APP_NAME",
+  "EMAIL_APP_URL",
+  "EMAIL_PROVIDER",
+  "EMAIL_FROM",
+  "EMAIL_ONLY_SIGNUP_WELCOME_ENABLED",
+  "EMAIL_BROADCAST_BATCH_SIZE",
+  "EMAIL_BROADCAST_BATCH_DELAY_MS",
+  "EMAIL_REENGAGEMENT_ENABLED",
+  "EMAIL_REENGAGEMENT_INTERVAL_MINUTES",
+  "EMAIL_REENGAGEMENT_INACTIVE_DAYS",
+  "EMAIL_REENGAGEMENT_COOLDOWN_DAYS",
+  "EMAIL_REENGAGEMENT_BATCH_SIZE",
+  "EMAIL_REENGAGEMENT_LEADER",
+  "EMAIL_REENGAGEMENT_DELIVERY_MODE",
+  "EMAIL_REENGAGEMENT_MARKETING_SEGMENT_ID",
+  "EMAIL_FLOW_INTERRUPTION_DELAY_DAYS",
+  "EMAIL_FLOW_INTERRUPTION_MAX_AGE_DAYS",
+  "EMAIL_LOW_BALANCE_THRESHOLD",
+  "EMAIL_LOW_BALANCE_COOLDOWN_DAYS",
+  "EMAIL_RETRY_ENABLED",
+  "EMAIL_RETRY_INTERVAL_MINUTES",
+  "EMAIL_RETRY_BATCH_SIZE",
+  "EMAIL_RETRY_MAX_ATTEMPTS",
+  "EMAIL_RETRY_DELAY_MS",
+  "EMAIL_SECURITY_LOGIN_FAIL_THRESHOLD",
+  "EMAIL_SECURITY_LOGIN_ALERT_COOLDOWN_DAYS",
+  "USER_ACTIVITY_UPDATE_INTERVAL_MS",
+  "RESEND_TIMEOUT_MS",
+  "RESEND_MAX_RETRY_ATTEMPTS",
+  "RESEND_RETRY_BASE_DELAY_MS",
+  "CLOUDFLARE_EMAIL_ACCOUNT_ID",
+  "CLOUDFLARE_EMAIL_FROM",
+  "CLOUDFLARE_EMAIL_TIMEOUT_MS",
+  "CLOUDFLARE_EMAIL_MAX_RETRY_ATTEMPTS",
+  "CLOUDFLARE_EMAIL_RETRY_BASE_DELAY_MS",
+] as const;
+
+type EmailRuntimeConfigKey = (typeof EMAIL_RUNTIME_CONFIG_KEYS)[number];
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  !!value && typeof value === "object" && !Array.isArray(value);
+
+const toEnvString = (value: unknown) => {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  return "";
+};
+
+const parseNumber = (value: string | undefined, fallback: number, min = 1) => {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return fallback;
+  return Math.max(min, Math.floor(parsed));
+};
+
+const DEFAULT_RUNTIME_CONFIG_SYNC_INTERVAL_SECONDS = 60;
+let runtimeConfigSyncTimer: ReturnType<typeof setInterval> | null = null;
+
+const runtimeConfigBaseEnv = EMAIL_RUNTIME_CONFIG_KEYS.reduce(
+  (acc, key) => {
+    acc[key] = process.env[key];
+    return acc;
+  },
+  {} as Record<EmailRuntimeConfigKey, string | undefined>
+);
+
+export async function applyEmailRuntimeConfigFromDb() {
+  const raw = await readEmailRuntimeConfigFromDb();
+  const appliedKeys: EmailRuntimeConfigKey[] = [];
+  const revertedKeys: EmailRuntimeConfigKey[] = [];
+  const runtimeConfig = raw || {};
+
+  for (const key of EMAIL_RUNTIME_CONFIG_KEYS) {
+    const hasDbValue = key in runtimeConfig;
+    const dbValue = hasDbValue ? toEnvString((runtimeConfig as Record<string, unknown>)[key]) : "";
+    if (dbValue) {
+      if (process.env[key] !== dbValue) {
+        process.env[key] = dbValue;
+        appliedKeys.push(key);
+      }
+      continue;
+    }
+
+    const baseValue = runtimeConfigBaseEnv[key];
+    if (baseValue) {
+      if (process.env[key] !== baseValue) {
+        process.env[key] = baseValue;
+        revertedKeys.push(key);
+      }
+      continue;
+    }
+
+    if (process.env[key] !== undefined) {
+      delete process.env[key];
+      revertedKeys.push(key);
+    }
+  }
+
+  if (appliedKeys.length > 0 || revertedKeys.length > 0) {
+    logger.info({ appliedKeys, revertedKeys }, "Applied email runtime config from DB");
+  }
+
+  return { appliedKeys, revertedKeys };
+}
+
+export async function readEmailRuntimeConfigFromDb() {
+  const raw = await serverDb.get(EMAIL_RUNTIME_CONFIG_KEY).catch(() => null);
+  if (!isRecord(raw)) {
+    return null;
+  }
+  return raw;
+}
+
+export const isEmailRuntimeConfigKey = (key: string): key is EmailRuntimeConfigKey =>
+  (EMAIL_RUNTIME_CONFIG_KEYS as readonly string[]).includes(key);
+
+const getRuntimeConfigSyncIntervalMs = () =>
+  parseNumber(
+    process.env.EMAIL_RUNTIME_CONFIG_SYNC_INTERVAL_SECONDS,
+    DEFAULT_RUNTIME_CONFIG_SYNC_INTERVAL_SECONDS,
+    5
+  ) * 1000;
+
+export function startEmailRuntimeConfigSync() {
+  if (runtimeConfigSyncTimer) return;
+  const intervalMs = getRuntimeConfigSyncIntervalMs();
+  runtimeConfigSyncTimer = setInterval(() => {
+    void applyEmailRuntimeConfigFromDb().catch((error) => {
+      logger.warn({ error }, "Failed to refresh email runtime config from DB");
+    });
+  }, intervalMs);
+  logger.info(
+    { intervalSeconds: Math.floor(intervalMs / 1000) },
+    "Email runtime config sync started"
+  );
+}
+
+export function stopEmailRuntimeConfigSync() {
+  if (!runtimeConfigSyncTimer) return;
+  clearInterval(runtimeConfigSyncTimer);
+  runtimeConfigSyncTimer = null;
+}